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: object

A 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: object

Same-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_share_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_gwh is 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:

CurtailmentAudit

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