# Release Notes for PySAL`2.0rc1`
For starters, these change notes are only for this *release candidate*, which is like a typical release of PySAL, but considered a preview. This release candidate, `2.0rc1`, signifies that our API will change (the `2.0` part) and that we want to ensure users can *opt-in* to these changes with a longer time delay than a usual release (the `rc1` part). We will make a full release of PySAL `2.0` by 2018-12-31, which will largely follow the API reorganization in this release candidate (and any subsequent release candidates). For more information on how to migrate to the `2.0`-API, please check out [migrating.pysal.org](https://migrating.pysal.org).
# Feature Changes in `2.0rc1`
This release, we've had a ton of activity in PySAL, but it has all been conducted in our *subpackages*, the independently-released components of our library. Because it is too onerous to list all the changes to the API here, please consult the [migrating.pysal.org](https://migrating.pysal.org) website for a detailed discussion of all reorganization-related changes. This document will focus *only* on improvements to functionality, enhancements, and additional modules added to `2.0rc1`, over and above the last stable release of the `1.0` series, PySAL `1.14.4`.
Overall, there were 719 commits that closed 240 issues, together with 105 pull requests across 12 packages since our last release on 2017-11-03.
## Entirely New Packages
For starters, we've added some entirely-new subpackages to this release candidate:
- `mgwr`, **the multi-scale Geographically-weighted regression package for Python.**
Don't worry, `mgwr` fits single-scale geographically-weighted regressions, too. Geographically-weighted regression is a kind of generalized additive model that uses kernel functions in the geographic area around each observation to predict outcomes at that area more accuratly, kind of like Gaussian Process regression for geographic data.
- `spvcm`, for spatially-correlated multilevel models.
Spatially-correlated multilevel models are models that allow for random effects of nearby areas, regions, or groups to be correlated with one another. This is a Gibbs sampling framework plus diagnostics & plotting tools for general Bayesian analysis of Gibbs samplers. The package also contains simple tools to implement new samplers on top of the infrastructure provided, which is fast, parallel, serializable, iterative-write, and interruptible.
- `spint`, for estimating spatial interaction models, such as the production-constrained or consumption-constrained gravity models.
- `spglm`, a package for fitting sparse GLMs, focused on performance over sparse categorical data.
- `splot`, for spatial vizualization in Python, built on top of the excellent [`geopandas`](https://github.com/geopandas/geopandas). This is headed by our Google Summer of Code (2018) student, [Stefanie Lumnitz](https://github.com/slumnitz), and will be ongoing throughout the release candidate maturation cycle.
- `pointpats`, a package for the statistical analysis of point patterns, geographical colocation, and dispersion.
## Significant Enhancements to Existing Packages
We've also had a ton of activity adding new features in our *submodules*:
- [alpha shapes](), a generalization of convex hulls to allow for non-convex hulls
- [Contiguity weights from voronoi tesselations/delaunay triangulation graphs]() for point patterns
- [Fuzzy contiguity weights](), for polygonal data where planarity is not strictly enforced (provided in part by [`geopandas`](https://github.com/geopandas/geopandas))
- A family of spatially explicit indicators of mobility association including the [inter- and intra-regional indicators](https://github.com/pysal/giddy/blob/master/giddy/rank.py#L799) as well as the [local indicators](https://github.com/pysal/giddy/blob/master/giddy/rank.py#L492). The former provide a meso-level view on the exchange mobility pattern, shedding light on specific regions hosting frequent rank exchanges while the latter examine the concordance relationship between a focal spatial unit and its neighbors for revealing the role of space in shaping the exchange mobility pattern over time.
- [Categorical Spatial Markov](https://github.com/pysal/giddy/blob/master/giddy/markov.py#L180), a generalization of the Spatial_Markov class previously implemented to interrogate the role of space in shaping regional income distribution dynamics to incorporate directe variables. Here, the [categorical spatial lag](https://github.com/pysal/libpysal/blob/master/libpysal/weights/spatial_lag.py#L90) is adopted for formalizing the neighborhood.
- [Connected Components checks]() for our spatial graph matrices
- [Pandas Adjacency list constructors]() and [NetworkX adapters]() for PySAL graph objects
- [Attach islands](https://github.com/pysal/libpysal/blob/master/libpysal/weights/util.py#L1311), tooling to merge isolated observations into existing spatial graphs
- [Construct Contiguity graphs from linestrings](), allowing for easy and fast access to road network data in PySAL
- **anything else?**
# Contributor Statistics
Below, you'll find some contribution statistics from users, how active each subpackage is, and how active users are within each subpackage:
#### Developer commits
<table border="0" class="dataframe">
<thead>
<tr style="text-align: right;">
<th></th>
<th>commits</th>
</tr>
</thead>
<tbody>
<tr>
<th>Dani Arribas-Bel</th>
<td>20</td>
</tr>
<tr>
<th>Eli Knaap</th>
<td>7</td>
</tr>
<tr>
<th>Hu Shao</th>
<td>2</td>
</tr>
<tr>
<th>James Gaboardi</th>
<td>10</td>
</tr>
<tr>
<th>Jsignell</th>
<td>1</td>
</tr>
<tr>
<th>Levi John Wolf</th>
<td>140</td>
</tr>
<tr>
<th>Serge Rey</th>
<td>96</td>
</tr>
<tr>
<th>Stefanie Lumnitz</th>
<td>157</td>
</tr>
<tr>
<th>Taylor Oshan</th>
<td>85</td>
</tr>
<tr>
<th>Thequackdaddy</th>
<td>1</td>
</tr>
<tr>
<th>Wei Kang</th>
<td>67</td>
</tr>
<tr>
<th>Ziqi Li</th>
<td>52</td>
</tr>
</tbody>
</table>
#### Subpackage Activity
<table border="0" class="dataframe">
<thead>
<tr style="text-align: right;">
<th>package</th>
<th>commits</th>
<th>total issues</th>
<th>pulls</th>
</tr>
</thead>
<tbody>
<tr>
<td>mgwr</td>
<td>165</td>
<td>22</td>
<td>7</td>
</tr>
<tr>
<td>splot</td>
<td>163</td>
<td>30</td>
<td>14</td>
</tr>
<tr>
<td>libpysal</td>
<td>161</td>
<td>76</td>
<td>35</td>
</tr>
<tr>
<td>giddy</td>
<td>94</td>
<td>43</td>
<td>19</td>
</tr>
<tr>
<td>spreg</td>
<td>32</td>
<td>11</td>
<td>5</td>
</tr>
<tr>
<td>spint</td>
<td>21</td>
<td>12</td>
<td>6</td>
</tr>
<tr>
<td>spglm</td>
<td>20</td>
<td>10</td>
<td>5</td>
</tr>
<tr>
<td>spvcm</td>
<td>20</td>
<td>3</td>
<td>1</td>
</tr>
<tr>
<td>pointpats</td>
<td>15</td>
<td>8</td>
<td>4</td>
</tr>
<tr>
<td>spaghetti</td>
<td>10</td>
<td>8</td>
<td>2</td>
</tr>
<tr>
<td>esda</td>
<td>9</td>
<td>13</td>
<td>5</td>
</tr>
<tr>
<td>inequality</td>
<td>7</td>
<td>2</td>
<td>1</td>
</tr>
<tr>
<td>mapclassify</td>
<td>2</td>
<td>2</td>
<td>1</td>
</tr>
</tbody>
</table>
#### Committers by Subpackage
<table border="0" class="dataframe">
<thead>
<tr style="text-align: right;">
<th></th>
<th>Dani Arribas-Bel</th>
<th>Eli Knaap</th>
<th>Hu Shao</th>
<th>James Gaboardi</th>
<th>Jsignell</th>
<th>Levi John Wolf</th>
<th>Serge Rey</th>
<th>Stefanie Lumnitz</th>
<th>Taylor Oshan</th>
<th>Thequackdaddy</th>
<th>Wei Kang</th>
<th>Ziqi Li</th>
</tr>
</thead>
<tbody>
<tr>
<th>lib.libpysal</th>
<td>19</td>
<td>5</td>
<td>0</td>
<td>2</td>
<td>0</td>
<td>73</td>
<td>48</td>
<td>2</td>
<td>4</td>
<td>0</td>
<td>8</td>
<td>0</td>
</tr>
<tr>
<th>explore.esda</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>4</td>
<td>5</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>explore.pointpats</th>
<td>0</td>
<td>0</td>
<td>2</td>
<td>0</td>
<td>0</td>
<td>7</td>
<td>2</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>4</td>
<td>0</td>
</tr>
<tr>
<th>explore.spaghetti</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>8</td>
<td>0</td>
<td>2</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>dynamics.giddy</th>
<td>0</td>
<td>2</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>1</td>
<td>18</td>
<td>8</td>
<td>0</td>
<td>0</td>
<td>55</td>
<td>0</td>
</tr>
<tr>
<th>viz.mapclassify</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>1</td>
<td>1</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>viz.splot</th>
<td>1</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>1</td>
<td>8</td>
<td>5</td>
<td>147</td>
<td>0</td>
<td>1</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>model.gwr</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>5</td>
<td>0</td>
<td>0</td>
<td>46</td>
<td>0</td>
<td>0</td>
<td>52</td>
</tr>
<tr>
<th>model.spglm</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>1</td>
<td>0</td>
<td>0</td>
<td>19</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>model.spint</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>5</td>
<td>0</td>
<td>0</td>
<td>16</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>model.spreg</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>13</td>
<td>17</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
<tr>
<th>model.spvcm</th>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>20</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
<td>0</td>
</tr>
</tbody>
</table>
###### tags: `pysal`, changelog, release candidate, spatial statistics, statistics, networks, graphs
Google Drive
Gist
Clipboard
Sign in with Wallet
