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:
objectMerchant operation assumptions, not measured performance.
grid_charge_mwh_per_cycleis grid energy purchased for one full equivalent charge. Delivered MWh include round-trip conversion losses.captured_margin_eur_per_mwhmust 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:
objectIllustrative 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:
objectOne 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:
scenario (BatteryTradingScenario)
year_index (int)
- 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:
target_contribution_eur (float)
trading (BatteryTradingScenario)
years (int)
- 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_ratiois illustrative cash / assumed debt payment; it is NOT an independently verified bank debt-service coverage ratio (DSCR).- Parameters:
trading (BatteryTradingScenario)
finance (BatteryFinanceScenario)
years (int)
- Return type:
tuple[AnnualBatteryCashflow, …]