EquiPop (Python)
k-nearest neighbour contexts/neighbourhoods on gridded and hexagonal data: bespoke neighbourhoods, friction-aware growth, distance decay, neighbourhood statistics and segregation measures - for very large datasets.
EquiPop finds, for every populated location, the k nearest individuals (by cumulative population count, expanding over a uniform grid) and reports the composition of that individualised neighbourhood. The gridded design means one pre-computed distance ordering serves every origin, which is what makes millions of locations feasible.
The EquiPop family
This is the first Python implementation. Its relatives: the original C# EquiPop (three generations, two public releases; radial and Flow models, downloadable via Uppsala University) and an R version covering I/O and the basic k-NN parts. This Python version additionally carries friction growth, five decay models, exact neighbourhood statistics (mean/median/SD/SE/Gini/entropy), segregation indices, hexagonal grids, area aggregation and metadata logging.
Install
pip install equipop # core
pip install equipop[geo,io,viz] # shapefiles/rasters, Excel/SPSS, maps
Quick start
import pandas as pd
from equipop import build_cells, run_knn_stats
df = pd.read_csv("individuals.csv") # one row per individual
cd = build_cells(df, e_col="X", n_col="Y",
binary_vars=["treated"], value_vars=["income"],
unit_size=100)
res = run_knn_stats(cd, k_values=[100, 400, 1600, 6400],
stats={"treated": ["ratio"],
"income": ["mean", "median", "gini"]})
For aggregated counts at national scale use the vectorised
run_knn_counts; for friction-constrained growth run_knn_friction;
for segregation profiles seg_profile; for policy-area reporting
aggregate_output; for quick maps map_output. See MANUAL_TOPICS.md.
Repository: https://github.com/GeoCalista/EquiPop
Citing
Please cite the software and the methods you use - see CITATION.cff. Core reference: Östh (2014), Introducing the EquiPop software, Uppsala University. Segregation measures: Östh, Clark & Malmberg (2015), Geographical Analysis 47(1). Decay parameters: Östh, Lyhagen & Reggiani (2016), EJTIR 16(2). Friction growth: Östh & Türk (2020), Handbook of Urban Segregation. Decay profiles in application: Türk, Östh, Kourtit & Nijkamp (2026), Journal of Urban Mobility 9.
Contributing
See CONTRIBUTING.md for how the code is laid out, how to run the tests and how a change gets in, and RULINGS.md for the method decisions the code must keep.
License
MIT. Attribution through citation is warmly requested (see above).
Metadata
Release files for equipop 1.65.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| equipop-1.65.0.tar.gz | 5.7 MB | With provenance | Details for equipop-1.65.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| equipop-1.65.0-py3-none-any.whl | Python 3 | none | any | Details for equipop-1.65.0-py3-none-any.whl |
Total release size: 8.6 MB
Release files / equipop-1.65.0.tar.gz
| Download URL | equipop-1.65.0.tar.gz |
|---|---|
| Size | 5.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d980c921204447b5ed20b8eb137713ae0fa708570c5f00e85cf9cf74ee3172d9
|
|
BLAKE2b-256 checksum How to use checksums |
3a917b3667b8c421297b1ff7e8a6186507f764fc74fbaaa536a9a2cf0e594a46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logRelease files / equipop-1.65.0-py3-none-any.whl
| Download URL | equipop-1.65.0-py3-none-any.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e3058d1c32fad59f1ce40c9bf0ea6276fbcab753d4fd8d78f4bea43dd1ea2d59
|
|
BLAKE2b-256 checksum How to use checksums |
feb620d6cd52ea47b20bcb97e65f57b2542569a593f8076579f088bc168302fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logSecurity for equipop 1.65.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for equipop-1.65.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.