segregation.aspatial.GiniSeg

class segregation.aspatial.GiniSeg(data, group_pop_var, total_pop_var)[source]

Classic Gini Segregation Index

Parameters
dataa pandas DataFrame
group_pop_varstring

The name of variable in data that contains the population size of the group of interest

total_pop_varstring

The name of variable in data that contains the total population of the unit

Attributes
———-
statisticfloat

Gini Segregation Index

core_dataa pandas DataFrame

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

Notes

Based on Massey, Douglas S., and Nancy A. Denton. “The dimensions of residential segregation.” Social forces 67.2 (1988): 281-315.

Reference: [MD88].

Examples

In this example, we will calculate the Gini Segregation Index (G) for the Riverside County using the census tract data of 2010. The group of interest is non-hispanic black people which is the variable nhblk10 in the dataset.

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

>>> import pandas as pd
>>> import geopandas as gpd
>>> import segregation
>>> from segregation.aspatial import GiniSeg

Secondly, we need to read the data:

>>> # This example uses all census data that the user must provide your own copy of the external database.
>>> # A step-by-step procedure for downloading the data can be found here: https://github.com/spatialucr/geosnap/blob/master/examples/01_getting_started.ipynb
>>> # After the user download the LTDB_Std_All_fullcount.zip and extract the files, the filepath might be something like presented below.
>>> filepath = '~/data/LTDB_Std_2010_fullcount.csv'
>>> census_2010 = pd.read_csv(filepath, encoding = "ISO-8859-1", sep = ",")

Then, we filter only for the desired county (in this case, Riverside County):

>>> df = census_2010.loc[census_2010.county == "Riverside County"][['pop10','tractid']]

The value is estimated below.

>>> gini_seg_index = GiniSeg(df, 'tractid', 'pop10')
>>> gini_seg_index.statistic
0.44620350030600087
__init__(data, group_pop_var, total_pop_var)[source]

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

Methods

__init__(data, group_pop_var, total_pop_var)

Initialize self.