Skip to content

BREOS v0.3.4

Choose a tag to compare

@Str4vinci Str4vinci released this 14 Jul 15:00
3287409

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.