momepy.get_node_id¶
-
momepy.
get_node_id
(objects, nodes, edges, node_id, edge_id=None, edge_keys=None, edge_values=None, verbose=True)[source]¶ Snap each building to closest street network node on the closest network edge.
Adds node ID to objects (preferably buildings). Gets ID of edge (
momepy.get_network_id()
orget_network_ratio()
) , and determines which of its end points is closer to building centroid.Pass either
edge_id
with a single value oredge_keys
andedge_values
with ratios.- Parameters
- objectsGeoDataFrame
GeoDataFrame containing objects to snap
- nodesGeoDataFrame
GeoDataFrame containing street nodes with unique node ID. If there is none, it could be generated by
momepy.unique_id()
.- edgesGeoDataFrame
GeoDataFrame containing street edges with unique edge ID and IDs of start and end points of each segment. Start and endpoints are default outcome of
momepy.nx_to_gdf()
.- node_idstr, list, np.array, pd.Series
the name of the nodes dataframe column,
np.array
, orpd.Series
with unique id- edge_idstr (default None)
the name of the objects dataframe column with unique edge id (like an outcome of
momepy.get_network_id()
)- edge_keysstr (default None)
name the name of the objects dataframe column with edgeID_keys (like an outcome of
momepy.get_network_ratio()
)- edge_valuesstr (default None)
name the name of the objects dataframe column with edgeID_values (like an outcome of
momepy.get_network_ratio()
)- verbosebool (default True)
if True, shows progress bars in loops and indication of steps
- Returns
- node_idsSeries
Series containing node ID for objects