segregation.aspatial.MultiInformationTheory

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

Calculation of Multigroup Information Theory index

Parameters
dataa pandas DataFrame
groupslist of strings.

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

Notes

Based on Reardon, Sean F., and Glenn Firebaugh. “Measures of multigroup segregation.” Sociological methodology 32.1 (2002): 33-67.

Reference: [RF02].

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 MultiInformationTheory

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 = MultiInformationTheory(input_df, groups_list)
>>> index.statistic
0.1710160297858887
Attributes
statisticfloat

Multigroup Information Theory 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.