Skip to content

Add comprehensive SNAP utility allowance data (FY2019-FY2026, sub-regions, household size)#7726

Open
MaxGhenis wants to merge 12 commits intomainfrom
add-snap-sua-data
Open

Add comprehensive SNAP utility allowance data (FY2019-FY2026, sub-regions, household size)#7726
MaxGhenis wants to merge 12 commits intomainfrom
add-snap-sua-data

Conversation

@MaxGhenis
Copy link
Contributor

@MaxGhenis MaxGhenis commented Mar 7, 2026

Summary

  • Add FY2019, FY2023, and FY2026 SNAP utility allowance values for all 53 states/territories
  • Split Alaska into 6 SNAP utility sub-regions (Central, Northern, Northwest, Southcentral, Southeast, Southwest) per 7 AAC 45.531, with county-to-region mapping
  • Split New York into 3 sub-regions (Nassau/Suffolk, NYC, Other NY) with county mapping
  • Add household-size-based SUA and BUA for AZ, TN, VA (NC was already modeled)
  • Add HI and GU individual utility allowances (electricity, gas, water) that vary by household size
  • Rename participating_statesstates parameter files for clarity

Data sourced from USDA SNAP utility allowance spreadsheets and snapscreener.com.

Test plan

  • All 257 SNAP tests pass locally
  • CI passes

🤖 Generated with Claude Code

Adds Standard Utility Allowance (HCSUA) values from USDA FNS xlsx files:
- FY2019 (2018-10-01): 53 state/territory entries
- FY2023 (2022-10-01): 52 entries (CO already existed)

Fills the FY2023 gap and extends coverage back to FY2019.

Closes #7721

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Mar 7, 2026

Codecov Report

❌ Patch coverage is 85.50725% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.15%. Comparing base (63a7861) to head (12d5d62).
⚠️ Report is 6 commits behind head on main.

Files with missing lines Patch % Lines
..._us/variables/gov/usda/snap/snap_utility_region.py 80.76% 8 Missing and 2 partials ⚠️
Additional details and impacted files
@@             Coverage Diff             @@
##              main    #7726      +/-   ##
===========================================
- Coverage   100.00%   94.15%   -5.85%     
===========================================
  Files            5        4       -1     
  Lines           69      171     +102     
  Branches         2       14      +12     
===========================================
+ Hits            69      161      +92     
- Misses           0        8       +8     
- Partials         0        2       +2     
Flag Coverage Δ
unittests 94.15% <85.50%> (-5.85%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

MaxGhenis and others added 2 commits March 7, 2026 08:45
Test 2 (2021, CA): Jan-Sep now uses FY2019 value (415) instead of 0
Test 3 (2020, CA): Now uses FY2019 value (415*12=4980) instead of 0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Adds HCSUA values effective 2025-10-01 for all 50 states + DC.
Data sourced from snapscreener.com/data which compiles state-published
SUA values. HI/GU/VI remain 0 (use individual utility allowances).

Closes #7030

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MaxGhenis MaxGhenis changed the title Add FY2019 and FY2023 SNAP SUA values for all states Add FY2019, FY2023, and FY2026 SNAP SUA values for all states Mar 7, 2026
MaxGhenis and others added 6 commits March 7, 2026 09:05
Add 2025-10-01 (FY2026) entries from snapscreener.com for:
- BUA (limited/main.yaml) - all 53 states/territories
- Electricity, gas, water, sewage, trash, phone - all 53 states/territories
- NC household-size SUA (by_household_size/amount.yaml) - sizes 1-10

Update NC SUA test expectations for FY2026 values taking effect Oct 2025.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Simpler, clearer parameter name for the list of states that vary
SUA/LUA by household size.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add FY2024-FY2026 household-size-based values for:
- AZ: 2 tiers (HH1-3, HH4+) for both SUA and BUA
- TN: 10 tiers (HH1 through HH10+) for SUA and BUA
- VA: 2 tiers (HH1-3, HH4+) for SUA only (VA has no BUA)

Also adds FY2026 values for NC BUA by household size.

Source: USDA FNS SUA Table FY2024/FY2025, snapscreener.com FY2026

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…owances

- Split AK into 6 SNAP utility sub-regions (Central, Northern, Northwest,
  Southcentral, Southeast, Southwest) per 7 AAC 45.531
- Split NY into 3 sub-regions (Nassau/Suffolk, NYC, Other NY)
- Add county-to-region mapping in snap_utility_region formula
- Add HI and GU individual utility allowances (electricity, gas, water)
  that vary by household size
- Update snap_individual_utility_allowance to handle by-household-size
  lookups for HI/GU

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MaxGhenis MaxGhenis changed the title Add FY2019, FY2023, and FY2026 SNAP SUA values for all states Add comprehensive SNAP utility allowance data (FY2019-FY2026, sub-regions, household size) Mar 7, 2026
@MaxGhenis MaxGhenis requested a review from hua7450 March 7, 2026 15:25
MaxGhenis and others added 3 commits March 7, 2026 10:26
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The breakdown metadata referenced state_code which caused AK/NY
sub-region keys to be silently dropped during parameter loading.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MaxGhenis
Copy link
Contributor Author

Microsim impact analysis

Ran household-level examples comparing 2024 vs 2026 values — all features working correctly:

SUA examples:

State 2024 SUA 2026 SUA Change
CA $7,299 $7,956 +$657 (+9.0%)
NC HH3 (by HH size) $8,607 $9,216 +$609 (+7.1%)
AK (Southcentral sub-region) $7,053 $7,092 +$39 (+0.6%)
NY (Other NY sub-region) $9,933 $10,524 +$591 (+6.0%)

IUA examples:

State 2024 IUA 2026 IUA Change
HI HH2 (by HH size) $11,331 $11,608 +$277
AK (Southcentral) $7,053 $7,132 +$79

Aggregate microsim (Enhanced CPS): Utility expense variables (electricity_expense, gas_expense, etc.) are all zero in the current microdata, so the aggregate SNAP impact is near-zero. The parameters are correct and verified at the household level — the microdata gap is tracked separately.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant