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

Constant-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_mwh is a caller-defined energy basis. Apply discharge_efficiency only if that energy is upstream of AC export; if the declared MWh is already AC deliverable, set efficiency to 1. SOC fractions refer to the usable_capacity_fraction energy 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:

ServiceEnvelope

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:
Return type:

int