segregation.aspatial.MultiDivergence

class segregation.aspatial.MultiDivergence(data, groups)[source]

Calculation of Multigroup Divergence index

Parameters
dataa pandas DataFrame
groupslist of strings.

The variables names in data of the groups of interest of the analysis.

Notes

Based on Roberto, Elizabeth. “The Divergence Index: A Decomposable Measure of Segregation and Inequality.” arXiv preprint arXiv:1508.01167 (2015).

Reference: [Rob15].

Examples

In this example, we are going to use 2000 Census Tract Data for Sacramento MSA, CA. The groups of interest are White, Black, Asian and Hispanic population.

Firstly, we need to perform some import the modules and the respective function.

>>> import libpysal
>>> import geopandas as gpd
>>> from segregation.multigroup_aspatial import MultiDivergence

Then, we read the data and create an auxiliary list with only the necessary columns for fitting the index.

>>> input_df = gpd.read_file(libpysal.examples.get_path("sacramentot2.shp"))
>>> groups_list = ['WHITE_', 'BLACK_', 'ASIAN_','HISP_']

The value is estimated below.

>>> index = MultiDivergence(input_df, groups_list)
>>> index.statistic
0.16645182134289443
Attributes
statisticfloat

Multigroup Divergence Index

core_dataa pandas DataFrame

A pandas DataFrame that contains the columns used to perform the estimate.

__init__(data, groups)[source]

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

Methods

__init__(data, groups)

Initialize self.