cityImage.land_use_from_polygons

cityImage.land_use_from_polygons(buildings_gdf, other_gdf, new_land_use_column, other_land_use_column, min_overlap_threshold=0.2, overlap_column_name=None)

Assign land-use labels from polygon layers to building polygons.

Aggregation model

For each building, intersecting land-use polygons are weighted by the proportion of the building area they cover. The resulting labels and overlap weights are stored on the output building table.

type buildings_gdf:

geopandas.GeoDataFrame

param buildings_gdf:

Building polygons.

type buildings_gdf:

geopandas.GeoDataFrame

type other_gdf:

geopandas.GeoDataFrame

param other_gdf:

Polygon layer containing land-use labels.

type other_gdf:

geopandas.GeoDataFrame

param new_land_use_column:

Output column for assigned land-use labels.

type new_land_use_column:

str

param other_land_use_column:

Source column containing land-use labels.

type other_land_use_column:

str

param min_overlap_threshold:

Minimum overlap proportion required to keep a label.

type min_overlap_threshold:

float

param overlap_column_name:

Output column for overlap weights.

type overlap_column_name:

str | None

returns:

Building table with assigned land-use labels and overlap weights.

rtype:

geopandas.GeoDataFrame