energy_methods.outage_resilience#

Minimum battery energy for an islanded critical-load outage scenario.

Reuses the renewable-priority energy balance in energy_methods.hybrid_dispatch. This is a planning sensitivity, not a grid-forming or black-start model.

energy_methods.outage_resilience.minimum_islanded_capacity(wind_mw, solar_mw, critical_load_mw, *, inverter_mw, initial_soc_fraction=0.8, roundtrip_efficiency=0.9025, timestep_hours=0.05, max_capacity_mwh=20.0, unserved_tolerance_mwh=1e-09)[source]#

Find the least modeled usable battery energy (MWh) meeting a load profile.

Inputs are nonnegative constant-power MW samples, each with the same duration timestep_hours. Energy capacity excludes any inaccessible state-of-charge reserve. Renewable profiles are conditional on an islanded plant that can operate them independently of the grid.

The result is a constrained bisection against simulate_hybrid, with renewable-first dispatch, MW/MWh limits and symmetric charge/discharge losses. If even max_capacity_mwh cannot serve demand with the given power rating, raise ValueError rather than returning a false solution.

Parameters:
  • wind_mw (Sequence[float])

  • solar_mw (Sequence[float])

  • critical_load_mw (Sequence[float])

  • inverter_mw (float)

  • initial_soc_fraction (float)

  • roundtrip_efficiency (float)

  • timestep_hours (float)

  • max_capacity_mwh (float)

  • unserved_tolerance_mwh (float)

Return type:

float