v0.4.0

[yu-ta-sato]

What's Changed

v0.4.0 focuses on directed/undirected edge handling across the GeoPandas ⇄ PyTorch Geometric ⇄ NetworkX conversion pipeline, a terminology rename in the morphology module, and more robust tessellation.

Added

• Added a directed parameter to gdf_to_pyg(). With the new default directed=False, each edge (u, v) is symmetrized by adding the reverse edge (v, u) so PyTorch Geometric receives a proper undirected graph, and pyg_to_gdf() deduplicates the edges back to the original rows on reconstruction. For heterogeneous graphs, directed also accepts a per-edge-type dictionary. Related PRs: [#157](Fix the treatment of undirected edges in gdf_to_pyg and pyg_to_gdf #157)
• Added a reverse_edge_types parameter to gdf_to_pyg() for undirected cross-type heterogeneous edges: "auto" generates (dst_type, "rev_<relation>", src_type) stores for message passing, a dict provides explicit mappings, and None enables strict mode. Related PRs: [#157](Fix the treatment of undirected edges in gdf_to_pyg and pyg_to_gdf #157)
• Added a multigraph parameter to gdf_to_pyg() that promotes two-level edge indexes to a keyed (source, target, key) contract so parallel edges round-trip exactly, and extended nx_to_pyg() / pyg_to_nx() to infer directionality from the NetworkX graph type and to preserve MultiGraph / MultiDiGraph edge keys. Related PRs: [#157](Fix the treatment of undirected edges in gdf_to_pyg and pyg_to_gdf #157)
• Added canonicalize_edges() to collapse reciprocal (u, v) / (v, u) rows and parallel duplicates in edge GeoDataFrames (duplicates="first" | "key" | "error"), and symmetrize_edges() as its idempotent inverse, appending reverse rows with reversed geometries. Related PRs: [#157](Fix the treatment of undirected edges in gdf_to_pyg and pyg_to_gdf #157), [#168](Add symmetrize_edges() and duplicate_edges parameter for the functions of undirected graph construction #168)
• Added a duplicate_edges parameter to the proximity generators (knn_graph(), delaunay_graph(), gabriel_graph(), relative_neighborhood_graph(), euclidean_minimum_spanning_tree(), fixed_radius_graph(), waxman_graph(), contiguity_graph()) and the morphology functions to optionally emit both (u, v) and (v, u) rows per undirected edge. Related PRs: [#168](Add symmetrize_edges() and duplicate_edges parameter for the functions of undirected graph construction #168)
• Added extent_buffer, limit, and include_unenclosed_buildings parameters to morphological_graph(), a max_connection_distance parameter to place_to_movement_graph(), and a limit parameter to create_tessellation() (auto-computed as a buffered convex hull when omitted, so buildings near outer street loops are no longer dropped). Related PRs: [#164](Fix/fix tessellations #164)
• Added a directed parameter to segments_to_graph(); directed=False canonicalizes each edge to an unordered (min, max) node-id order so reverse-drawn duplicate segments become parallel edges of one unordered pair. Related PRs: [#165](Set multigraph by default for segments_to_graph() #165)

Changed

• Breaking: gdf_to_pyg() now treats edges as undirected by default and validates them: edge tables containing both (u, v) and (v, u) rows (typical of OSMnx-style directed sources), or parallel rows for the same unordered pair, raise a ValueError pointing to canonicalize_edges(), multigraph=True, or directed=True as remedies. Pass directed=True to restore the previous as-is behavior. Related PRs: [#157](Fix the treatment of undirected edges in gdf_to_pyg and pyg_to_gdf #157)
• Breaking: Renamed the morphology terminology from "private"/"public" to "place"/"movement". Node keys are now "place" and "movement"; edge types are ("place", "touched_to", "place"), ("movement", "connected_to", "movement"), and ("place", "faced_to", "movement"); identifier columns are place_id, movement_id, from_place_id/to_place_id, and from_movement_id/to_movement_id. Related PRs: [#169](Change the wording in morphological_graph #169)
• Breaking: segments_to_graph() now defaults to multigraph=True, returning a three-level (from_node_id, to_node_id, edge_key) MultiIndex (and an nx.MultiGraph when as_nx=True). With multigraph=False, duplicate node pairs now raise a ValueError instead of silently returning a duplicated MultiIndex. Related PRs: [#165](Set multigraph by default for segments_to_graph() #165)
• Updated dependencies, including requests 2.33.0, aiohttp 3.14.0, pillow 12.2.0, pytest 9.0.3, nbconvert 7.17.1, and codecov/codecov-action v7. Related PRs: [#147](Bump requests from 2.32.5 to 2.33.0 in the uv group across 1 directory #147), [#148](Bump codecov/codecov-action from 5 to 6 #148), [#149](Bump aiohttp from 3.13.3 to 3.13.4 in the uv group across 1 directory #149), [#151](Bump pillow from 12.1.1 to 12.2.0 in the uv group across 1 directory #151), [#152](Bump pytest from 9.0.2 to 9.0.3 in the uv group across 1 directory #152), [#153](Bump nbconvert from 7.17.0 to 7.17.1 in the uv group across 1 directory #153), [#158](Bump the uv group across 1 directory with 2 updates #158), [#159](Bump the uv group across 1 directory with 3 updates #159), [#160](Bump the uv group across 1 directory with 2 updates #160), [#162](Bump aiohttp from 3.13.4 to 3.14.0 in the uv group across 1 directory #162), [#163](Bump codecov/codecov-action from 6 to 7 #163)

Deprecated

• Deprecated private_to_private_graph(), private_to_public_graph(), and public_to_public_graph() in favor of place_to_place_graph(), place_to_movement_graph(), and movement_to_movement_graph(). The old names emit a DeprecationWarning and will be removed in a future major release. Related PRs: [#169](Change the wording in morphological_graph #169)

Fixed

• Fixed a UnicodeDecodeError in load_overture_data() when reading back files saved with save_to_file=True, by @Jah-yee. Related PRs: [#161](Fix UnicodeDecodeError when save_to_file=True in _download_and_process_type #161)
• Made enclosed tessellation more robust: boundary-simplification failures retry with simplify=False, and GEOS topology errors retry with a coarser grid_size before falling back gracefully. Related PRs: [#164](Fix/fix tessellations #164)
• Fixed segments_to_graph() ignoring as_nx=True for empty inputs, and segments_to_graph(multigraph=True, as_nx=True) silently collapsing parallel edges by returning an nx.Graph instead of an nx.MultiGraph. Related PRs: [#165](Set multigraph by default for segments_to_graph() #165)
• Fixed load_gtfs() UDF registration against newer DuckDB releases and guarded get_od_pairs() against an empty calendar table. Related PRs: [#170](V0.3.1 to v0.4.0 #170)

New Contributors

• @Jah-yee made their first contribution in Fix UnicodeDecodeError when save_to_file=True in _download_and_process_type #161

Full Changelog: v0.3.1...v0.4.0

---

This discussion was created from the release v0.4.0.