energy_methods.curtailment_storage#

Curtailment ratios, price screens and equivalent storage (Acosta et al., 2027).

Implements Table 1 and Eqs. (1)-(5), DOI 10.1016/j.est.2026.125203. EESC is the paper’s effective-power indicator, not a nameplate BESS design. Price separation is an observational proxy, not proof of physical congestion.

energy_methods.curtailment_storage.curtailment_ratios(curtailed_mwh, generated_mwh)[source]#

Return both denominators; undefined ratios are None, never infinity.

The paper’s Table 3 divides curtailed energy by reported generation. The potential-energy share divides by generation PLUS curtailment. Inputs must cover the same technology, geography and time period.

Parameters:
  • curtailed_mwh (float)

  • generated_mwh (float)

Return type:

dict[str, float | None]

class energy_methods.curtailment_storage.EquivalentStorage(scenario_a_mw, scenario_b_mw, outside_block_mwh, block_fraction, reduction_relative_to_a_pct, excess_relative_to_b_pct, uncovered_a_mw, uncovered_b_mw)[source]#

Bases: object

Scenario A/B effective MW and the uncovered indicator relative to installed MW.

Parameters:
  • scenario_a_mw (float)

  • scenario_b_mw (float)

  • outside_block_mwh (float)

  • block_fraction (float | None)

  • reduction_relative_to_a_pct (float | None)

  • excess_relative_to_b_pct (float | None)

  • uncovered_a_mw (float)

  • uncovered_b_mw (float)

scenario_a_mw: float#
scenario_b_mw: float#
outside_block_mwh: float#
block_fraction: float | None#
reduction_relative_to_a_pct: float | None#
excess_relative_to_b_pct: float | None#
uncovered_a_mw: float#
uncovered_b_mw: float#
energy_methods.curtailment_storage.equivalent_storage(curtailed_mwh, *, duration_hours=4.0, days=365.0, depth_of_discharge=0.9, round_trip_efficiency=0.95, block_mwh=None, installed_mw=0.0)[source]#

Evaluate EESC = UEC * DoD * efficiency / (days * discharge_hours).

Matches the published numerator convention exactly. Lower DoD/efficiency therefore lowers this effective indicator; it must not be interpreted as the nominal capacity required to capture all curtailment. The uniform daily cycling assumption does not establish a feasible dispatch or an upper bound. Scenario B retains only curtailed energy in [08:00, 18:00) local time.

Parameters:
  • curtailed_mwh (float)

  • duration_hours (float)

  • days (float)

  • depth_of_discharge (float)

  • round_trip_efficiency (float)

  • block_mwh (float | None)

  • installed_mw (float)

Return type:

EquivalentStorage

energy_methods.curtailment_storage.storage_sensitivity(curtailed_mwh, *, durations=(2, 3, 4, 5), depths=(0.8, 0.85, 0.9, 0.92, 0.95), efficiencies=(0.9, 0.93, 0.95, 0.97), days=365)[source]#

Paper section 4.4.1: 20 DoD/efficiency cases per duration.

Parameters:
  • curtailed_mwh (float)

  • durations (Sequence[float])

  • depths (Sequence[float])

  • efficiencies (Sequence[float])

  • days (float)

Return type:

DataFrame

energy_methods.curtailment_storage.classify_curtailment(pv_mwh, wind_mwh, *, timezone='America/Santiago')[source]#

Table 1 P50 quadrants on paired observed hours, including zero observations.

Ties are high (>= P50), including zero when the median is zero. Quantiles use linear interpolation. Missing or unpaired hours fail instead of being filled with zero. Gaps are allowed and remain gaps; coverage is not inferred. Southern-hemisphere seasons and A/B/C blocks use local interval STARTS.

Parameters:
  • pv_mwh (Series)

  • wind_mwh (Series)

  • timezone (str)

Return type:

DataFrame

energy_methods.curtailment_storage.nodal_price_screen(first, second, *, threshold_usd_mwh=10.0)[source]#

Eq. (1): absolute price separation >= threshold, on exactly paired hours.

Negative nodal prices are valid. This proxy cannot identify a causal line constraint or distinguish every driver of price separation.

Parameters:
  • first (Series)

  • second (Series)

  • threshold_usd_mwh (float)

Return type:

DataFrame