Summary
Add congressional district-level breakdowns to US state-level simulation results, mirroring the existing UK parliamentary constituency and local authority breakdown functionality.
Background
The UK version of PolicyEngine already provides geographic breakdowns for:
- Parliamentary constituencies (650 areas)
- Local authorities (360 areas)
These breakdowns show average_household_income_change and relative_household_income_change for each geographic area within a simulation.
Proposed Changes
For US state-level simulations, add a congressional_district_impact field to EconomyComparison that breaks down results by congressional district within the state.
Output Format
{
"congressional_district_impact": {
"districts": [
{
"district": "GA-05",
"average_household_income_change": 312.45,
"relative_household_income_change": 0.0187
},
{
"district": "GA-06",
"average_household_income_change": 287.12,
"relative_household_income_change": 0.0165
}
]
}
}
Implementation Approach
- Extract
congressional_district_geoid from state-level datasets (already present in state HDF5 files)
- Group households by district geoid
- Calculate weighted income changes per district using the same formulas as UK constituencies
- Return sorted list of district impacts
Benefits
- Enables district-level policy analysis from 51 state simulations instead of 435 district simulations
- Reduces compute time from ~8 hours (sequential) to ~5 minutes (parallel states)
- Consistent with existing UK geographic breakdown patterns
Summary
Add congressional district-level breakdowns to US state-level simulation results, mirroring the existing UK parliamentary constituency and local authority breakdown functionality.
Background
The UK version of PolicyEngine already provides geographic breakdowns for:
These breakdowns show
average_household_income_changeandrelative_household_income_changefor each geographic area within a simulation.Proposed Changes
For US state-level simulations, add a
congressional_district_impactfield toEconomyComparisonthat breaks down results by congressional district within the state.Output Format
{ "congressional_district_impact": { "districts": [ { "district": "GA-05", "average_household_income_change": 312.45, "relative_household_income_change": 0.0187 }, { "district": "GA-06", "average_household_income_change": 287.12, "relative_household_income_change": 0.0165 } ] } }Implementation Approach
congressional_district_geoidfrom state-level datasets (already present in state HDF5 files)Benefits