energy_methods.margin_relief#
Conditional BESS energy/power screen for forecast reserve-margin gaps.
A margin gap is NOT unserved electricity demand. The integral of forecast margin-gap MW over time is only a hypothetical reserve-support requirement.
- class energy_methods.margin_relief.MarginRelief(margin_gap_mwh_equivalent, relief_mwh_equivalent, remaining_gap_mwh_equivalent, coverage_fraction, relief_mw, remaining_dc_energy_mwh)[source]#
Bases:
objectConditional capacity-margin screening outputs, not electricity shortages.
- Parameters:
margin_gap_mwh_equivalent (float)
relief_mwh_equivalent (float)
remaining_gap_mwh_equivalent (float)
coverage_fraction (float)
relief_mw (tuple[float, ...])
remaining_dc_energy_mwh (float)
- margin_gap_mwh_equivalent: float#
- relief_mwh_equivalent: float#
- remaining_gap_mwh_equivalent: float#
- coverage_fraction: float#
- relief_mw: tuple[float, ...]#
- remaining_dc_energy_mwh: float#
- energy_methods.margin_relief.screen_margin_relief(margin_gap_mw, *, battery_power_mw, available_dc_energy_mwh, timestep_hours=0.5, discharge_efficiency=0.95)[source]#
Bound hypothetical storage relief using inverter power and finite energy.
Each input is a scenario MW gap averaged across an interval; reporting a snapshot at one instant does not establish an observed interval series. The battery starts with the specified usable DC energy above minimum SOC, supplies only reserve support, and never recharges within this screen. Calculated MWh are margin-gap equivalents, not lost-load measurements.
- Parameters:
margin_gap_mw (Sequence[float])
battery_power_mw (float)
available_dc_energy_mwh (float)
timestep_hours (float)
discharge_efficiency (float)
- Return type: