momepy.MeanInterbuildingDistance

class momepy.MeanInterbuildingDistance(gdf, spatial_weights, unique_id, spatial_weights_higher=None, order=3, verbose=True)[source]

Calculate the mean interbuilding distance

Interbuilding distances are calculated between buildings on adjacent cells based on spatial_weights, while the extent is defined in spatial_weights_higher.

\[\]
Parameters
gdfGeoDataFrame

GeoDataFrame containing objects to analyse

unique_idstr

name of the column with unique id used as spatial_weights index

spatial_weightslibpysal.weights

spatial weights matrix

spatial_weights_higherlibpysal.weights, optional

spatial weights matrix - If None, Queen contiguity of a higher order will be calculated based on spatial_weights

orderint

Order of Queen contiguity

verbosebool (default True)

if True, shows progress bars in loops and indication of steps

Notes

Fix UserWarning.

Examples

>>> buildings_df['mean_interbuilding_distance'] = momepy.MeanInterbuildingDistance(buildings_df, sw, 'uID').series
Generating weights matrix (Queen) of 3 topological steps...
Computing mean interbuilding distances...
100%|██████████| 144/144 [00:00<00:00, 317.42it/s]
>>> buildings_df['mean_interbuilding_distance'][0]
29.305457092042744
Attributes
seriesSeries

Series containing resulting values

gdfGeoDataFrame

original GeoDataFrame

swlibpysal.weights

spatial weights matrix

idSeries

Series containing used unique ID

sw_higherlibpysal.weights

Spatial weights matrix of higher order

orderint

Order of Queen contiguity (only if spatial_weights_higher was not set)

__init__(gdf, spatial_weights, unique_id, spatial_weights_higher=None, order=3, verbose=True)[source]

Initialize self. See help(type(self)) for accurate signature.

Methods

__init__(gdf, spatial_weights, unique_id[, …])

Initialize self.