energy_methods.bess_merchant_finance#

Transparent BESS arbitrage contribution and debt-cover screening.

All prices, degradation and loan terms are hypothetical user inputs. This tool does not optimize dispatch or forecast electricity prices.

class energy_methods.bess_merchant_finance.BatteryTradingScenario(grid_charge_mwh_per_cycle, equivalent_cycles_per_day, round_trip_efficiency, availability, annual_capacity_retention, captured_margin_eur_per_mwh)[source]#

Bases: object

Merchant operation assumptions, not measured performance.

grid_charge_mwh_per_cycle is grid energy purchased for one full equivalent charge. Delivered MWh include round-trip conversion losses. captured_margin_eur_per_mwh must be net of grid energy purchases and market transaction fees; it is NOT an electricity sale price.

Parameters:
  • grid_charge_mwh_per_cycle (float)

  • equivalent_cycles_per_day (float)

  • round_trip_efficiency (float)

  • availability (float)

  • annual_capacity_retention (float)

  • captured_margin_eur_per_mwh (float)

grid_charge_mwh_per_cycle: float#
equivalent_cycles_per_day: float#
round_trip_efficiency: float#
availability: float#
annual_capacity_retention: float#
captured_margin_eur_per_mwh: float#
class energy_methods.bess_merchant_finance.BatteryFinanceScenario(senior_debt_eur, annual_interest_rate, debt_tenor_years, annual_fixed_opex_eur)[source]#

Bases: object

Illustrative debt and fixed O&M assumptions, all nominal EUR.

Parameters:
  • senior_debt_eur (float)

  • annual_interest_rate (float)

  • debt_tenor_years (int)

  • annual_fixed_opex_eur (float)

senior_debt_eur: float#
annual_interest_rate: float#
debt_tenor_years: int#
annual_fixed_opex_eur: float#
class energy_methods.bess_merchant_finance.AnnualBatteryCashflow(year_index, discharged_mwh, contribution_eur, fixed_opex_eur, debt_service_eur, cash_available_for_debt_eur, cash_after_debt_eur, cash_cover_ratio)[source]#

Bases: object

One projected year of physical output and simple merchant cashflow.

Parameters:
  • year_index (int)

  • discharged_mwh (float)

  • contribution_eur (float)

  • fixed_opex_eur (float)

  • debt_service_eur (float)

  • cash_available_for_debt_eur (float)

  • cash_after_debt_eur (float)

  • cash_cover_ratio (float | None)

year_index: int#
discharged_mwh: float#
contribution_eur: float#
fixed_opex_eur: float#
debt_service_eur: float#
cash_available_for_debt_eur: float#
cash_after_debt_eur: float#
cash_cover_ratio: float | None#
energy_methods.bess_merchant_finance.discharged_energy_mwh(scenario, year_index)[source]#

Annual AC discharge, with 365 days/year (leap-day simplification).

No cycle-calendar, power, state-of-charge, degradation-mechanism, or warranty feasibility has been independently validated here.

Parameters:
Return type:

float

energy_methods.bess_merchant_finance.required_captured_margin_eur_per_mwh(target_contribution_eur, trading, years)[source]#

Uniform net margin for a stipulated cumulative pre-O&M contribution.

A published revenue forecast need not equal this net margin because its charging purchases, grid fees and revenue recognition may differ.

Parameters:
Return type:

float

energy_methods.bess_merchant_finance.annual_level_debt_service_eur(finance)[source]#

12 times a level monthly repayment; not an actual bank loan schedule.

Parameters:

finance (BatteryFinanceScenario)

Return type:

float

energy_methods.bess_merchant_finance.merchant_cashflow_screen(trading, finance, years)[source]#

Screen yearly cash before taxes/working capital and actual debt covenants.

cash_cover_ratio is illustrative cash / assumed debt payment; it is NOT an independently verified bank debt-service coverage ratio (DSCR).

Parameters:
Return type:

tuple[AnnualBatteryCashflow, …]