Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Populate the UK prepayment-meter input from LCFS

Open
#1,110 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
52/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python

Research direction

Start with packages/microcosm-build/src/microcosm/build/uk_runtime/lcfs_consumption.py, especially the consumption-stage code linked in the issue, and trace how LCFS donor fields are cleaned, imputed, and exported. Find the UK stage tests and add focused coverage for the requested classification and propagation cases. Done means the input is exported, the weighted estimate is reported, and its comparison clearly states benchmark differences.

Written by the indexing model from the issue text.

Description

Summary

PolicyEngine/policyengine-uk#2098 adds the household input uses_energy_prepayment_meter to calculate the Great Britain Energy Price Guarantee prepayment discount from July 2023 through March 2024. Microcosm's current UK LCFS consumption stage does not read a gas or electricity payment-method field and does not include this boolean in UK_LCFS_CONSUMPTION_OUTPUT_COLUMNS. Population simulations therefore default the model input to false and calculate no prepayment discount.

The government reported that the July 2023 change covered around three million prepayment-meter households across Great Britain and reduced a typical annual bill by around £21. Prepayment meter customers to pay less for energy from today

Current implementation: uk_runtime/lcfs_consumption.py

Requested implementation

  • Identify the LCFS gas and electricity payment-method fields and document their code values.
  • Derive a household-level uses_energy_prepayment_meter boolean, including an explicit rule for mixed payment methods and missing responses.
  • Carry or impute the boolean from the LCFS donor into the UK household frame and include it in the exported PolicyEngine UK dataset.
  • Add focused UK stage tests for donor cleaning, output propagation, deterministic assignment, and export compatibility.
  • Report the weighted number and share of Great Britain households classified as using a prepayment meter.
  • Compare that result with an official benchmark, stating differences in reference period, geography, and whether the benchmark counts households, customers, accounts, or meters.

Related issue and repository boundary

PolicyEngine/policyengine-uk-data#539 tracks the same missing input in the UK input pipeline and will remain open. This issue tracks the implementation required in Microcosm's direct LCFS consumption stage and current UK population build. The two implementations should use the same source-field interpretation and classification rules.

Dependency

The model can calculate the discount for an individual household when a caller supplies uses_energy_prepayment_meter. A Microcosm population release must carry this input before the discount has a nonzero aggregate effect in population simulations.

Dominant language
Python
Stars
0
Forks
4
Avg merge
1d 14h
Merged PRs (30d)
106

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from PolicyEngine/microcosm

All issues in PolicyEngine/microcosm

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.