segregation.inference.sim_share

segregation.inference.sim_share(df1, df2, group_pop_var1, total_pop_var1, group_pop_var2, total_pop_var2)

Simulate the spatial population distribution of a region using the CDF of a comparison region.

For each spatial unit i in region 1, take the unit’s percentile in the distribution, and swap the group share with the value of the corresponding percentile in region 2. The share is the minority population of unit i divided by total population of minority population. This approach will shift the total population of each unit without changing the regional proportion of each group

Parameters:

df1pandas.DataFrame or geopandas.GeoDataFrame

dataframe for first dataset with columns holding group and total population counts

df2pandas.DataFrame or geopandas.GeoDataFrame

dataframe for second dataset with columns holding group and total population counts

group_pop_var1str

column holding population counts for group of interest on input df1

total_pop_var1str

column holding total population counts on input df1

group_pop_var2str

column holding population counts for group of interest on input df2

total_pop_var2str

column holding total population counts on input df2

Returns:

two pandas.DataFrame

dataframes with simulated population columns appended