Calculates the Theil measure of inequality of values within neighbours defined in spatial_weights.
Uses inequality.theil.Theil under the hood. Requires ‘inequality’ package.
GeoDataFrame containing morphological tessellation
the name of the dataframe column, np.array, or pd.Series where is stored character value.
spatial weights matrix
name of the column with unique id used as spatial_weights index
Percentiles over which to compute the range. Each must be
between 0 and 100, inclusive. The order of the elements is not important.
if True, shows progress bars in loops and indication of steps
>>> sw = momepy.sw_high(k=3, gdf=tessellation_df, ids='uID')
>>> tessellation_df['area_Theil'] = mm.Theil(tessellation_df, 'area', sw, 'uID').series
100%|██████████| 144/144 [00:00<00:00, 597.37it/s]
Series containing resulting values
Series containing used values
Series containing used unique ID
Initialize self. See help(type(self)) for accurate signature.
__init__(gdf, values, spatial_weights, unique_id)