Skip to content

Add shared electricity and natural gas provider inputs - #11052

Closed
hua7450 wants to merge 5 commits into
PolicyEngine:mainfrom
hua7450:liheap-utility-provider-inputs
Closed

hua7450 wants to merge 5 commits into
PolicyEngine:mainfrom
hua7450:liheap-utility-provider-inputs

Conversation

@hua7450

@hua7450 hua7450 commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Superseded on November 20, 2026. The provider inputs now live in each state's LIHEAP folder (ri_liheap_electricity_provider in #11053, id_liheap_electricity_provider and id_liheap_natural_gas_provider in #11054, il_liheap_electricity_provider and il_liheap_natural_gas_provider in #11055). Those PRs no longer depend on this one, and the shared inputs and JSON choice list below are not used. This draft stays open only until it is closed.

Add two SPM-unit inputs for the distribution companies named on a household’s bills. The model builds both enums from a single ordered JSON file packaged in each release. A partner can load that file once for the model version it uses. Download the proposed provider list

The named companies support utility-specific heating rules in Idaho, Illinois and Rhode Island. Some also serve customers in other states. The mapping describes where each named distributor operates. A household still selects the company serving its address.

Using the provider list

Select electricity_provider or natural_gas_provider, then filter using the household’s two-letter state code. Display the label and submit the selected value on the SPM unit. Both fuels offer OTHER for an unlisted company and UNSPECIFIED for an unknown provider.

const choices = catalog[variableName].filter(
  ({ states }) => states === null || states.includes(householdState)
);

For example, an Oregon household can select AVISTA for natural gas. The electricity list for Oregon includes Clearwater Power and Idaho Power. The same Avista ID appears in the electric list in Idaho, Montana and Washington.

Verified service territories

Fuel Distribution company State codes
Both Ameren Illinois IL
Both Rhode Island Energy (Narragansett Electric) RI
Electricity Avista
Northern Lights Incorporated
ID, MT, WA
Electricity Clearwater Power ID, OR, WA
Electricity Inland Power and Light
Kootenai Electric Cooperative
ID, WA
Electricity Idaho Power ID, OR
Electricity Rocky Mountain Power ID, UT, WY
Electricity Bonners Ferry Light and Water
Idaho County Light and Power
Plummer Electric Department
ID
Electricity ComEd IL
Electricity Block Island Utility District
Clear River Electric and Water District
RI
Natural gas Avista ID, OR, WA
Natural gas Intermountain Gas ID
Natural gas Nicor Gas
North Shore Gas
Peoples Gas Light & Coke
IL
  • All 15 named electric providers were checked against the 2025 final Service_Territory_2025.xlsx, a utility-by-county table. The residential customer file also confirms the small cross-state populations, including 10 Avista customers in Montana and 18 Northern Lights customers in Washington. PacifiCorp reports as one company in the federal data, so the branded utility’s own service description determines which states to include for Rocky Mountain Power. EIA Form 861 data · Rocky Mountain Power
  • All seven named gas companies also report customers in the mapped states in the 2024 federal company data. The gas companies were checked against the Illinois and Rhode Island regulators, Intermountain’s service description, and Avista’s Form 10-K, Part I, Item 1. Avista reports a small number of Montana electric customers and Oregon gas customers. EIA Form 176 company data · Illinois Commerce Commission · Rhode Island PUC · Intermountain Gas · Avista filing
  • The named choices originated in the state heating follow-ups. Idaho FY2026 heating matrix · Idaho utility directory · Illinois DCEO · Rhode Island statute

Verification

  • Confirmed both the wheel and source distribution contain the same JSON file as the published draft.
  • Checked all 102 combinations of fuel and state (50 states and DC) from the built wheel against the EIA electric and gas records and the Rocky Mountain Power brand territory.
  • Confirmed the existing inputs keep every enum ID, label and numeric index. A household simulation accepted separate electric and gas selections.
  • All 70 Idaho, Illinois and Rhode Island heating payment cases passed using the three state drafts with the packaged provider definitions.
  • All three catalog unit tests and the repository formatter and linter passed.

axiom: n/a: household inputs and a provider catalog

@hua7450

hua7450 commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded: the provider inputs now live in each state's LIHEAP folder (PRs 11053, 11054 and 11055), so the shared inputs and the JSON choice list are not needed.

@hua7450 hua7450 closed this Nov 20, 2026
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