energy_methods.curtailment_screen#
Reconcile reported curtailed potential energy and screen recovery ceilings.
The method operates on published GWh aggregates. It neither infers ONS restriction causes nor simulates battery operation or recoverable electricity.
- class energy_methods.curtailment_screen.MonthlyCurtailment(month, wind_gwh, solar_gwh, estimated_subset_gwh)[source]#
Bases:
objectA reported calendar-month curtailment estimate in GWh, not metered output.
- Parameters:
month (int)
wind_gwh (float)
solar_gwh (float)
estimated_subset_gwh (float)
- month: int#
- wind_gwh: float#
- solar_gwh: float#
- estimated_subset_gwh: float#
- class energy_methods.curtailment_screen.CurtailmentAudit(reported_wind_gwh, reported_solar_gwh, reported_total_gwh, monthly_reconstructed_total_gwh, reconciliation_difference_gwh, reconciliation_tolerance_gwh, estimated_subset_gwh, estimated_subset_pct, wind_share_pct, wind_yoy_pct, solar_yoy_pct, total_yoy_pct)[source]#
Bases:
objectSame-window comparisons and one-decimal rounding reconciliation.
- Parameters:
reported_wind_gwh (float)
reported_solar_gwh (float)
reported_total_gwh (float)
monthly_reconstructed_total_gwh (float)
reconciliation_difference_gwh (float)
reconciliation_tolerance_gwh (float)
estimated_subset_gwh (float)
estimated_subset_pct (float)
wind_share_pct (float)
wind_yoy_pct (float)
solar_yoy_pct (float)
total_yoy_pct (float)
- reported_wind_gwh: float#
- reported_solar_gwh: float#
- reported_total_gwh: float#
- monthly_reconstructed_total_gwh: float#
- reconciliation_difference_gwh: float#
- reconciliation_tolerance_gwh: float#
- estimated_subset_gwh: float#
- estimated_subset_pct: float#
- wind_yoy_pct: float#
- solar_yoy_pct: float#
- total_yoy_pct: float#
- energy_methods.curtailment_screen.audit_curtailment(months, *, reported_wind_gwh, reported_solar_gwh, reported_estimated_subset_gwh, prior_wind_gwh, prior_solar_gwh, display_precision_gwh=0.1)[source]#
Audit independently rounded month rows against a same-window YTD report.
estimated_subset_gwhis already within the wind + solar totals and MUST NOT be added again. The precision bound models display rounding only, not errors in ONS reference-generation estimation. November may be partial.- Parameters:
months (Sequence[MonthlyCurtailment])
reported_wind_gwh (float)
reported_solar_gwh (float)
reported_estimated_subset_gwh (float)
prior_wind_gwh (float)
prior_solar_gwh (float)
display_precision_gwh (float)
- Return type:
- energy_methods.curtailment_screen.hypothetical_deliverable_ceiling_gwh(curtailed_potential_gwh, *, accessible_fraction, round_trip_efficiency)[source]#
Physical energy ceiling for a hypothetical recovered fraction, NOT a forecast.
It assumes the stated fraction of foregone generation could be captured and delivered with the stated round-trip efficiency. It ignores time matching, network topology, charging power, battery energy size, prices and ownership. Even the 100% case is generally unattainable; reported curtailment cannot be treated as battery availability or an investable revenue opportunity.
- Parameters:
curtailed_potential_gwh (float)
accessible_fraction (float)
round_trip_efficiency (float)
- Return type:
float