Energy balance

Per-timestep energy-flow accounting for PV, load, battery, and grid. The energy-balance engine runs the same way for PV-only and PV+battery systems — when no battery is configured, it simply skips the storage path.

Main entry point

breos.battery.simulate_energy_balance(pv_dc, ...)

Simulate energy balance with battery storage and degradation.

The function returns a six-tuple of (results_df, total_pv_wh, summary_df, total_replacement_cost, n_replacements, degradation_df). Battery-specific outputs are empty when running without storage.

Coupling

Whether the inverter is DC-coupled (hybrid) or AC-coupled affects when losses are applied. The BatteryConfig dc_coupled flag controls this — see the Battery reference for the full configuration.