breos.battery.BatteryConfig#

class breos.battery.BatteryConfig(nominal_energy_wh, initial_soh=100.0, eol_percentage=0.7, max_soc=0.9, min_soc=0.1, charge_efficiency=0.9746794344808963, discharge_efficiency=0.9746794344808963, standby_loss_wh=5.0, enable_replacement=True, replacement_cost=None, calendar_model='naumann_lam_field_calibrated', enable_resistance_fade=False, initial_resistance_growth=0.0, thermal_resistance_kw=0.05, dc_coupled=True, inverter_efficiency=0.96, inverter_ac_capacity_w=None, battery_type='lfp')[source]#

Bases: object

Configuration parameters for battery simulation.

For DC-coupled systems (hybrid inverters): - PV → Battery: No inverter loss (stays in DC) - Battery → Load: Inverter loss applies (DC to AC)

For AC-coupled systems: - All energy goes through inverter first

eol_percentage defaults to 0.70 (replace the battery when its state of health falls to 70% of nominal capacity), matching the App config default battery_eol_percentage.

Parameters:

  • nominal_energy_wh (float)

  • initial_soh (float)

  • eol_percentage (float)

  • max_soc (float)

  • min_soc (float)

  • charge_efficiency (float)

  • discharge_efficiency (float)

  • standby_loss_wh (float)

  • enable_replacement (bool)

  • replacement_cost (float | None)

  • calendar_model (str)

  • enable_resistance_fade (bool)

  • initial_resistance_growth (float)

  • thermal_resistance_kw (float)

  • dc_coupled (bool)

  • inverter_efficiency (float)

  • inverter_ac_capacity_w (float | None)

  • battery_type (str)

__init__(nominal_energy_wh, initial_soh=100.0, eol_percentage=0.7, max_soc=0.9, min_soc=0.1, charge_efficiency=0.9746794344808963, discharge_efficiency=0.9746794344808963, standby_loss_wh=5.0, enable_replacement=True, replacement_cost=None, calendar_model='naumann_lam_field_calibrated', enable_resistance_fade=False, initial_resistance_growth=0.0, thermal_resistance_kw=0.05, dc_coupled=True, inverter_efficiency=0.96, inverter_ac_capacity_w=None, battery_type='lfp')#
Parameters:

  • nominal_energy_wh (float)

  • initial_soh (float)

  • eol_percentage (float)

  • max_soc (float)

  • min_soc (float)

  • charge_efficiency (float)

  • discharge_efficiency (float)

  • standby_loss_wh (float)

  • enable_replacement (bool)

  • replacement_cost (float | None)

  • calendar_model (str)

  • enable_resistance_fade (bool)

  • initial_resistance_growth (float)

  • thermal_resistance_kw (float)

  • dc_coupled (bool)

  • inverter_efficiency (float)

  • inverter_ac_capacity_w (float | None)

  • battery_type (str)

Return type:

None

Methods

__init__(nominal_energy_wh[, initial_soh, ...])

Attributes

battery_type

calendar_model

charge_efficiency

dc_coupled

discharge_efficiency

enable_replacement

enable_resistance_fade

eol_percentage

initial_resistance_growth

initial_soh

inverter_ac_capacity_w

inverter_efficiency

max_soc

min_soc

replacement_cost

standby_loss_wh

thermal_resistance_kw

nominal_energy_wh