cityImage module ownership map#
This file records the current post-refactor ownership boundary.
Status meanings:
keep: cityImage owns the semantics.keep thin: cityImage owns the boundary/output semantics but delegates algorithms, acquisition, or file IO.keep small: small helper module retained because multiple owned modules need it.
Module |
Owner |
Status |
Optional deps |
Delegates to |
Keep reason |
|---|---|---|---|---|---|
|
public API |
keep |
none |
lazy import map |
Top-level import contract and curated public surface. |
|
schema/adapters |
keep |
none |
pandas/geopandas conventions |
Normalises user data into cityImage column/schema expectations. |
|
schema/adapters |
keep |
none |
pandas/geopandas conventions |
Defines and validates the internal nodes/edges/buildings schema. |
|
file IO bridge API |
keep thin |
none |
GeoPandas |
Preserves file-based notebook/user pipelines while delegating file reading. |
|
OSM bridge API |
keep thin |
osmnx |
OSMnx |
Preserves OSM notebook/user pipelines while delegating acquisition. |
|
network construction |
keep thin |
none |
GeoPandas/Shapely |
Converts line data into cityImage nodes/edges schema. |
|
pedestrian network acquisition |
keep thin |
osmnx |
OSMnx |
Pedestrian-specific OSM/network workflow boundary and filtering semantics. |
|
network topology |
keep |
none |
shapely/geopandas/networkx |
Custom geometry/topology repair operations not safely delegated wholesale. |
|
graph semantics |
keep |
none |
math/shapely only |
Preserves custom endpoint-oriented street-segment angle semantics. |
|
graph core |
keep |
none |
NetworkX |
Prepared GDF to graph and dual graph semantics. |
|
centrality outputs |
keep thin |
igraph |
igraph |
Preserves centrality output semantics used by scoring; delegates algorithms. |
|
regions/districts |
keep |
python-louvain/community |
NetworkX/community-louvain/Shapely |
Keeps district/gateway semantics and mapping between primal/dual outputs. |
|
barriers |
keep |
none |
Shapely/GeoPandas |
Keeps custom barrier extraction/crossing semantics. |
|
landmarks |
keep |
none |
Shapely/GeoPandas |
Hard Lynchian landmark scoring and local landmark semantics. |
|
imageability scoring |
keep |
none |
NumPy/Pandas |
Combines Lynchian/imageability indicators into score outputs. |
|
building height |
keep thin |
rasterio/rasterstats |
rasterstats/rasterio |
Thin raster/zonal-stat boundary plus cityImage building-height schema. |
|
2D visibility |
keep |
none |
Shapely/GeoPandas |
Preserves 2D visibility semantics. |
|
3D visibility |
keep |
pyvista/dask/psutil/tqdm |
PyVista/Dask |
Owns 3D sight-line workflow and output schema; delegates mesh/ray operations. |
|
geometry helpers |
keep small |
none |
Shapely/GeoPandas |
Small custom helpers used by topology/visibility/regions. |
|
data helpers |
keep small |
none |
Pandas/NumPy |
Small scaling/conversion helpers used internally. |
|
land-use package |
keep |
none |
GeoPandas/Pandas |
Derivation, classification, sparse representation, and assignment of land-use semantics. |
|
plotting package |
keep thin |
matplotlib/mapclassify |
Matplotlib/mapclassify |
Optional static plotting entry points isolated from core import. |