BREOS v0.3.4
BREOS 0.3.4 is a physical-correctness and validation release for the public breos.App simulation path.
Highlights
- Adds a versioned DC/AC timestep energy ledger covering PV routing, inverter and battery conversion losses, standby, curtailment, capacity-window changes, storage boundary state, and PV-origin battery delivery.
- Preserves battery energy and PV-origin inventory across simulation years instead of resetting at each January boundary.
- Reconciles public AC production, self-consumption, export, emissions, optimizer objectives, economics, and PV loss-waterfall reporting while retaining compatibility aliases.
- Adds optional battery charge/discharge power limits, stricter configuration validation, leap-year-safe load profiles, and reproducibility provenance.
- Adds a standing seven-site validation suite plus opt-in mid-interval solar position, diffuse IAM, and mounting-temperature presets.
- Fixes tracker diffuse-IAM performance through a cached interpolation grid while retaining the exact fixed-tilt path.
Upgrade notes
Existing breos.App entry points and compatibility result aliases remain available. Numerical results may change because 0.3.4 corrects DC/AC boundary accounting, inverter sharing, cross-year storage continuity, optimizer parity, and daily battery-resistance temperature treatment. Invalid or unsupported configurations that previously produced misleading output may now raise a clear validation error.
Verification
- Python 3.11–3.14 CI passed.
- 400 tests passed, with 7 optional/skipped tests.
- Strict documentation, wheel/sdist build, installed-wheel resource smoke, and public PyPI installation checks passed.
See CHANGELOG.md for the complete list of changes.