City2Graph Python API reference Use this reference to find the public city2graph functions for constructing, combining, and converting geospatial graphs. Public functions are also exported from the top-level package, so the examples use import city2graph as c2g.
Find an API by task I want to... Start with Module Convert GeoDataFrames, NetworkX, or PyTorch Geometric graphs gdf_to_pyg, pyg_to_gdf, pyg_to_nx, nx_to_pygGraph Load Overture Maps data or place boundaries load_overture_data, get_boundariesData Build a building–street morphology graph morphological_graphMorphology Load GTFS or GBFS data into DuckDB load_gtfs, load_gbfsTransportation Convert GTFS into a public transport graph get_od_pairs, travel_summary_graphTransportation Convert an OD matrix into a weighted spatial graph od_matrix_to_graphMobility Build proximity, contiguity, bridge, or containment relations knn_graph, waxman_graph, contiguity_graph, bridge_nodes, group_nodesProximity Compose typed relations for a heterogeneous GNN add_metapaths, add_metapaths_by_weightMetapath
Modules Module Scope Graph Conversion between GeoDataFrames, NetworkX, and PyTorch Geometric Data Overture Maps downloads, place boundaries, and geospatial preprocessing Morphology Buildings, tessellations, street segments, and urban form relations Transportation GTFS and GBFS loading, OD pairs, and travel-summary graphs Mobility OD edge lists and adjacency matrices Proximity Proximity, contiguity, bridge, grouping, and directed graph builders Metapath Metapath-derived relations in heterogeneous graphs Utils Graph conversion, topology, spatial, and validation utilities
July 18, 2026 July 5, 2026