aperta¶

Path-first, cross-modal accessibility analysis in Python.

A Python library for routing, distance/time computation, and gravity- / utility- / logsum-based accessibility metrics on NetworkX graphs (routed via scipy.sparse.csgraph). Designed around a path-first routing primitive that returns the realized route alongside the OD travel cost, enabling utility-based accessibility, cross-modal logsum, and per-route feature aggregation as first-class operations.

The name is Latin/Italian for open.

Status¶

Pre-1.0, alpha. Published alongside a toolkit paper (in submission). APIs may change without notice until v1.0.

Install¶

pip install aperta              # algorithms only
pip install 'aperta[osm]'       # + OSM ingestion (osmnx)
pip install 'aperta[examples]'  # + everything needed to run the example notebooks

Requires Python ≥ 3.11.

Get started¶

Quickest read — the README shows the three-line core of an aperta accessibility analysis.
Runnable minimal example — examples/minimal/accessibility.ipynb (Cambridge MA, ~10 s).
Guided tour of every primitive — examples/walkthrough/accessibility.ipynb (Central Paris, walk + bike, cross-modal logsum, path-first per-edge feature aggregation, ~40 s).
Production-scale demo — examples/extended/ (Bern + 40 km, calibration, traffic flows, ~30 min).

API reference¶

The API reference covers every public function and class across aperta’s algorithm modules: routing, accessibility metrics, OD pair structures, trip overheads, utility-based costs, traffic flow estimation, edge-weight calibration, and the supporting geo / network / OSM / topography helpers.