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