Metadata-Version: 2.4
Name: sdc-catchment
Version: 0.1.0
Summary: Floating catchment area spatial accessibility (2SFCA, E2SFCA, and variants)
Project-URL: Homepage, https://dads2busy.github.io/Social-Data-Commons/packages/sdc-catchment/
Project-URL: Documentation, https://dads2busy.github.io/Social-Data-Commons/packages/sdc-catchment/
Project-URL: Repository, https://github.com/dads2busy/Social-Data-Commons
Project-URL: Issues, https://github.com/dads2busy/Social-Data-Commons/issues
Project-URL: Changelog, https://github.com/dads2busy/Social-Data-Commons/blob/main/packages/sdc-catchment/CHANGELOG.md
Author-email: Aaron Schroeder <ads7fg@virginia.edu>
License: MIT
Keywords: 2sfca,accessibility,catchment,e2sfca,gis,spatial
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.10
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.0
Requires-Dist: scipy>=1.11
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.24; extra == 'docs'
Description-Content-Type: text/markdown

# sdc-catchment

Floating catchment area (FCA) spatial-accessibility metrics — 2SFCA, E2SFCA,
KD2SFCA, 3SFCA, modified-2SFCA, balanced FCA, and commute-based FCA, all as
parameter variations of a single `catchment_ratio()`.

Part of the [Social Data Commons](https://github.com/dads2busy/Social-Data-Commons)
toolkit. Extracted from `sdc_core.catchment`; the Python replacement for the R
`catchment` package.

## Install

```bash
uv add sdc-catchment   # or: pip install sdc-catchment
```

## Public API

- `catchment_ratio` — accessibility ratio under a chosen FCA variant.
- `catchment_weight` — distance-decay weight matrix builder.
- `catchment_connections` / `catchment_network` — provider/consumer connectivity.
- `euclidean_cost` — pairwise Euclidean cost matrix.
- `KERNELS`, `WeightSpec` — kernel registry and weight-spec type.

See the [documentation](https://dads2busy.github.io/Social-Data-Commons/packages/sdc-catchment/).
