energy_methods.portugal_storage_auction#

First-pass MVA-to-MW and four-hour BESS screens for Portugal’s 2026 auctions.

This is an illustrative engineering calculator, NOT a legal qualification, grid feasibility study, financing model, or prediction of auction outcomes.

class energy_methods.portugal_storage_auction.StorageAuctionScenario(auction, awarded_capacity_mva, active_power_factor=1.0, ac_discharge_efficiency=0.94, end_of_life_usable_fraction=0.8)[source]#

Bases: object

Engineering assumptions; none represents an awarded or measured project.

MVA is awarded apparent injection access, not installed active power. Efficiencies and usable fraction are independently assumed design values.

Parameters:
  • auction (Literal['standalone', 'colocated'])

  • awarded_capacity_mva (float)

  • active_power_factor (float)

  • ac_discharge_efficiency (float)

  • end_of_life_usable_fraction (float)

auction: Literal['standalone', 'colocated']#
awarded_capacity_mva: float#
active_power_factor: float#
ac_discharge_efficiency: float#
end_of_life_usable_fraction: float#
class energy_methods.portugal_storage_auction.StorageAuctionScreen(auction, awarded_capacity_mva, export_active_mw, minimum_bess_ac_mw, minimum_delivered_mwh, minimum_nameplate_mwh, full_export_four_hour_delivered_mwh, full_export_four_hour_nameplate_mwh, within_aggregate_auction_pool)[source]#

Bases: object

Power and energy envelopes, not final tender eligibility.

Parameters:
  • auction (Literal['standalone', 'colocated'])

  • awarded_capacity_mva (float)

  • export_active_mw (float)

  • minimum_bess_ac_mw (float)

  • minimum_delivered_mwh (float)

  • minimum_nameplate_mwh (float)

  • full_export_four_hour_delivered_mwh (float)

  • full_export_four_hour_nameplate_mwh (float)

  • within_aggregate_auction_pool (bool)

auction: Literal['standalone', 'colocated']#
awarded_capacity_mva: float#
export_active_mw: float#
minimum_bess_ac_mw: float#
minimum_delivered_mwh: float#
minimum_nameplate_mwh: float#
full_export_four_hour_delivered_mwh: float#
full_export_four_hour_nameplate_mwh: float#
within_aggregate_auction_pool: bool#
energy_methods.portugal_storage_auction.screen_portugal_storage_auction(scenario)[source]#

Evaluate a conditional four-hour battery power and energy envelope.

Standalone power fraction: 100% of injection MW. Co-located: 20% as preliminary power screening. DGEG’s co-located notice says four hours at MAXIMUM INJECTION power; a separate full-export four-hour stress is therefore required. Neither interpretation independently proves legal compliance; read the binding tender programme and specifications.

Assumes P_export(MW) = S_awarded(MVA) * assumed power factor. Battery nameplate energy = delivered AC energy / (discharge efficiency * assumed usable nameplate fraction at end of life).

Parameters:

scenario (StorageAuctionScenario)

Return type:

StorageAuctionScreen