cityImage.cultural_score#

cityImage.cultural_score(buildings_gdf, historical_elements_gdf=Empty DataFrame Columns: [a] Index: [], historical_score=None, from_OSM=False)[source]#

The function computes the “Cultural Landmark Component” based on the number of features listed in historical/cultural landmarks datasets. It can be obtained either on the basis of a score given by the data-provider or on the number of features intersecting the buildings object of analysis.

“historical_score” indicates the attribute field containing scores assigned to historical buildings, if existing. Alternatively, if the column has been already assigned to the buildings_gdf, one can use OSM historic categorisation (binbary).

Parameters:

  • buildings_gdf (Polygon GeoDataFrame) – Buildings GeoDataFrame - case study area.

  • historical_elements_gdf (Point or Polygon GeoDataFrame) – The GeoDataFrame containing information about listed historical buildings or elements.

  • historical_score (str) – The name of the column in the historical_elements_gdf that provides information on the classification of the historical listings.

  • from_OSM (boolean) – If using the historic field from OSM. This column should be already in the buildings_gdf columns.

Returns:

buildings_gdf – The updated buildings GeoDataFrame.

Return type:

Polygon GeoDataFrame