Skip to content

Use named utility provider columns in Idaho LIHEAP heating - #11054

Draft
hua7450 wants to merge 8 commits into
PolicyEngine:mainfrom
hua7450:id-liheap-utility-providers
Draft

hua7450 wants to merge 8 commits into
PolicyEngine:mainfrom
hua7450:id-liheap-utility-providers

Conversation

@hua7450

@hua7450 hua7450 commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Idaho's PY26 Benefit Determination Chart pays different heating amounts by utility: "AVISTA & Northern Utilities", "Idaho Power & Southern Utilities" and "Rocky Mountain Power" for electric heat, and "Avista" and "Intermountain Gas" for gas heat. The model pays the Idaho Power and Intermountain Gas columns to everyone. This PR adds inputs for the household's electricity and natural gas companies and uses them to select the chart column and the matching heating-cost estimate, which sets the energy-burden group.

Fixes #11224

Changes

  • id_liheap_electricity_provider and id_liheap_natural_gas_provider, enum inputs in the Idaho LIHEAP folder, each with OTHER and UNSPECIFIED (the default).
  • Three new chart columns as parameters (matrix/electricity_northern.yaml, matrix/electricity_rocky_mountain.yaml, matrix/natural_gas_avista.yaml) and the matching provider rows in estimated_heating_costs.yaml.
  • northern_electric_providers.yaml: the companies that use the "AVISTA & Northern Utilities" column. One list feeds both formulas.
  • id_liheap and id_liheap_estimated_heating_cost select the column from the reported company. IDAHO_POWER, INTERMOUNTAIN_GAS, OTHER and UNSPECIFIED keep the Idaho Power and Intermountain Gas columns, so a household that reports no company keeps its current result.

Example

A one-person electric-heat household in heating Area II with a high energy burden, before any target-household bonus:

Electric company Estimated heating cost Payment
Idaho Power, other, or not reported $1,455 $410
Avista or another northern utility $1,585 $402
Rocky Mountain Power $1,692 $441

Where the choices come from

  • The chart names five columns. The electricity input lists Avista, Idaho Power and Rocky Mountain Power from it, and the gas input lists Avista and Intermountain Gas.
  • The chart does not say which companies are "Northern Utilities". The seven others in the electricity input (Bonners Ferry, Clearwater Power, Idaho County Light and Power, Inland Power and Light, Kootenai Electric, Northern Lights and Plummer) come from the footnote of the PY2007 Intake Manual Appendix C, with names updated from the state utility directory and Inland Power's site.
  • That footnote also names Lamb Creek Trailer Park. It is left out because its current utility identity was not established; such a household reports OTHER and uses the Idaho Power column.

Limitations

  • Heating costs, county heating areas and northern-group membership are the PY2007 Appendix C figures; Idaho publishes no current source.
  • The Appendix C column headed "Utah Power & Light" supplies the Rocky Mountain Power costs.
  • The chart leaves three cells blank: northern utilities in Area III, Rocky Mountain Power in Area I, and Avista gas in Area III. The heating-area map has no northern county in Area III and no southeastern county in Area I, so those pairs should not occur. A household reported with one of them gets the Idaho Power or Intermountain Gas column for its area.
  • No complete FY2027 chart is published, so verified_years is unchanged.

Tests

  • id_liheap.yaml Cases 15-22: every published cell of the three new columns, a household whose burden group changes with the company's cost estimate, the three blank-cell pairs, all seven added northern companies with OTHER and UNSPECIFIED, the Intermountain Gas and OTHER gas choices, and a gas-heated household whose electric company is Avista.
  • id_liheap_estimated_heating_cost.yaml Case 6: the six provider cost cells and one blank-cell pair.

The cases were not run locally after these changes; CI runs them.

Sources

axiom: needed

🤖 Generated with Claude Code

hua7450 and others added 6 commits November 16, 2026 18:02
Replace the shared electricity and natural gas provider inputs with
id_liheap_electricity_provider and id_liheap_natural_gas_provider, enums
in the Idaho LIHEAP folder that list only the companies the Idaho heating
matrix distinguishes. The matrix and estimated-cost formulas read them.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (8999568) to head (b52e200).
⚠️ Report is 308 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main    #11054   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         4    +3     
  Lines           24        95   +71     
=========================================
+ Hits            24        95   +71     
Flag Coverage Δ
unittests 100.00% <100.00%> (ø)

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

☔ View full report in Codecov by Harness.
📢 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.

hua7450 and others added 2 commits November 20, 2026 15:26
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…ider tests

- Three provider matrix files: bare date keys, key comments and `breakdown`
  metadata whose ranges match the stored areas. No value changes.
- northern_electric_providers: state why Lamb Creek Trailer Park is omitted and
  use one title for the chart PDF. estimated_heating_costs names the
  "Utah Power & Light" column.
- Tests: id_liheap Cases 15-22 use counties each utility serves, drop a
  duplicate case and add the Intermountain, OTHER and unreported gas choices;
  id_liheap_estimated_heating_cost Case 6 covers the six provider cost cells.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

Implement Idaho LIHEAP utility provider columns

1 participant