energy_methods.bess_service_envelope#
Constant-power BESS service screening with explicit energy and AC limits.
This screening method is not a dispatch optimizer or grid service certification.
- class energy_methods.bess_service_envelope.ServiceEnvelope(available_ac_energy_mwh, power_limit_mw, energy_limited_power_mw, sustainable_power_mw, delivered_at_target_mwh, target_power_mw, meets_target, limiting_constraint)[source]#
Bases:
objectConstant-power limits over a specified service window, in MW and MWh.
- Parameters:
available_ac_energy_mwh (float)
power_limit_mw (float)
energy_limited_power_mw (float)
sustainable_power_mw (float)
delivered_at_target_mwh (float)
target_power_mw (float)
meets_target (bool)
limiting_constraint (str)
- available_ac_energy_mwh: float#
- power_limit_mw: float#
- energy_limited_power_mw: float#
- sustainable_power_mw: float#
- delivered_at_target_mwh: float#
- target_power_mw: float#
- meets_target: bool#
- limiting_constraint: str#
- energy_methods.bess_service_envelope.screen_bess_service(power_mw, declared_energy_mwh, service_hours, *, target_power_mw=0.0, initial_soc_fraction=1.0, reserve_soc_fraction=0.0, usable_capacity_fraction=1.0, discharge_efficiency=1.0)[source]#
Screen constant AC power deliverable without recharging the battery.
declared_energy_mwhis a caller-defined energy basis. Applydischarge_efficiencyonly if that energy is upstream of AC export; if the declared MWh is already AC deliverable, set efficiency to 1. SOC fractions refer to theusable_capacity_fractionenergy basis. The final reserve is intentionally unavailable for the service.This is a deterministic physical upper bound: no auxiliary consumption, dynamic inverter derating, degradation within the event or grid constraints.
- Parameters:
power_mw (float)
declared_energy_mwh (float)
service_hours (float)
target_power_mw (float)
initial_soc_fraction (float)
reserve_soc_fraction (float)
usable_capacity_fraction (float)
discharge_efficiency (float)
- Return type:
- energy_methods.bess_service_envelope.maximum_households(envelope, mean_household_kw)[source]#
Household energy equivalence for a hypothetical constant average load.
This is NOT households served during a coincident peak, firm grid supply, or a claim that a physical connection to these households exists.
- Parameters:
envelope (ServiceEnvelope)
mean_household_kw (float)
- Return type:
int