hydromt.gis_utils.nearest_merge#

hydromt.gis_utils.nearest_merge(gdf1: ~geopandas.geodataframe.GeoDataFrame, gdf2: ~geopandas.geodataframe.GeoDataFrame, columns: list | None = None, max_dist: float | None = None, overwrite: bool = False, inplace: bool = False, logger=<Logger hydromt.gis_utils (WARNING)>) → GeoDataFrame[source]#

Merge attributes of gdf2 with the nearest feature of gdf1, optionally bounded by a maximumum distance max_dist. Unless overwrite = True, gdf2 values are only merged where gdf1 has missing values.

Parameters:

  • gdf1 (geopandas.GeoDataFrame) – Source gdf1 and destination gdf2 geometries.

  • gdf2 (geopandas.GeoDataFrame) – Source gdf1 and destination gdf2 geometries.

  • columns (list of str, optional) – Names of columns in gdf2 to merge, by default None

  • max_dist (float, optional) – Maximum distance threshold for merge, by default None, i.e.: no threshold.

  • overwrite (bool, optional) – If False (default) gdf2 values are only merged where gdf1 has missing values, i.e. NaN values for existing columns or missing columns.

Returns:

Merged GeoDataFrames

Return type:

gpd.GeoDataFrame