v0.4.1

Frequenz Microgrid Component Graph Library Release Notes

Upgrading

• The microgrid extra now requires frequenz-client-microgrid >= 0.18.3 (was >= 0.18.0) so that the SteamBoiler component class is available.

New Features

• ComponentGraph now accepts every component class shipped by frequenz.client.microgrid.component. Battery and EV-charger subtypes (LiIonBattery, NaIonBattery, AcEvCharger, DcEvCharger, HybridEvCharger) are mapped to their cg-side subtype variant instead of collapsing to Unspecified. Pass-through categories (Converter, CryptoMiner, Electrolyzer, Hvac, Precharger, Relay, VoltageTransformer), plus SteamBoiler and UnrecognizedComponent, are now mapped where they previously raised ValueError("Unsupported component category: …").

What's Changed

• Reset release notes by @simonvoelcker in #70
• Cover all microgrid client categories in category mapping by @shsms in #72

New Contributors

• @simonvoelcker made their first contribution in #70

Full Changelog: v0.4.0...v0.4.1

v0.4.0

Frequenz Microgrid Component Graph Library Release Notes

Upgrading

• This release updates the frequenz-microgrid-component-graph rust crate version to 0.5. ComponentGraphConfig is restructured to match: the six per-category prefer_X_in_Y_formula flags are replaced by a global prefer_meters_in_component_formulas plus per-formula overrides via the new FormulaOverrides class. Also exposes the new steam_boiler_formula method, and renames battery_coalesce_formula / pv_coalesce_formula to battery_ac_coalesce_formula / pv_ac_coalesce_formula.

• ComponentGraphConfig.__init__ is now declared as keyword-only in the type stubs (the runtime was already keyword-only, so positional calls were already failing at runtime).

• The per-category preference flags inverted polarity: where the old flags selected the device, the new override entries select the meter. E.g. ComponentGraphConfig(prefer_inverters_in_pv_formula=True) becomes ComponentGraphConfig(formula_overrides=FormulaOverrides(prefer_meters_in_pv_formula=False)).

What's Changed

• Add repo-config auto-migration workflow by @llucax in #46
• Bump the patch group across 1 directory with 3 updates by @dependabot[bot] in #50
• Bump mkdocstrings[python] from 0.30.1 to 1.0.0 by @dependabot[bot] in #30
• Bump black from 25.9.0 to 26.3.1 by @dependabot[bot] in #52
• Bump the compatible group across 1 directory with 3 updates by @dependabot[bot] in #48
• Update frequenz-client-assets requirement from <0.2,>=0.1.0 to >=0.1.0,<0.3 by @dependabot[bot] in #27
• Bump pytest-asyncio from 1.2.0 to 1.3.0 by @dependabot[bot] in #26
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #22
• Bump pydoclint from 0.7.6 to 0.8.3 by @dependabot[bot] in #31
• Bump the minor group across 1 directory with 6 updates by @dependabot[bot] in #51
• Bump mkdocstrings from 1.0.0 to 1.0.4 in the patch group across 1 directory by @dependabot[bot] in #56
• Bump async-solipsism from 0.8 to 0.9 by @dependabot[bot] in #58
• Bump frequenz-repo-config from 0.13.6 to 0.17.0 in the repo-config group by @dependabot[bot] in #57
• Bump mkdocstrings-python from 1.18.2 to 2.0.3 by @dependabot[bot] in #55
• Bump actions/create-github-app-token from 2.2.1 to 3.1.1 by @dependabot[bot] in #61
• Bump pytest from 8.4.2 to 9.0.3 by @dependabot[bot] in #53
• Bump the compatible group across 1 directory with 5 updates by @dependabot[bot] in #65
• Bump mkdocs-gen-files from 0.5.0 to 0.6.1 by @dependabot[bot] in #54
• Bump component-graph-rs version to 0.5 by @shsms in #63
• Prepare for release 0.4 by @shsms in #67
• Bump version to 0.4.0 by @shsms in #68
• Update bindings version in Cargo.lock to 0.4.0 by @shsms in #69

New Contributors

• @llucax made their first contribution in #46

Full Changelog: v0.3.4...v0.4.0

v0.3.4

Frequenz Microgrid Component Graph Library Release Notes

Upgrading

• This release updates the frequenz-microgrid-component-graph rust crate version to 0.4.

  This introduces some behavior changes to how some formulas are calculated:

  • The PV, battery, CHP, EV and Wind Turbine formulas now prefer meters as the primary components and fallback to inverters or other corresponding components only when the meters are not available.

    This makes a big difference in performance when there are multiple PV inverters behind a single meter, for example.

    This behaviour can be changed with the newly introduced meter preference config flags.

  • Consumer formulas don't consider phantom loads by default anymore. The original behaviour is still available through a config flag.

New Features

• This introduces a new consumer formula generator that doesn't consider phantom loads.

  Meters with successors can still have loads not represented in the component graph. These are called phantom loads.

What's Changed

• Bump version to 0.3.4 by @shsms in #40
• Update lock file by @shsms in #41

Full Changelog: v0.3.3...v0.3.4

v0.3.3

Frequenz Microgrid Component Graph Library Release Notes

Upgrading

• This release updates the frequenz-microgrid-component-graph rust crate version to 0.4.

What's Changed

• Bump frequenz-microgrid-component-graph version to 0.4 by @shsms in #39

Full Changelog: v0.3.2...v0.3.3

v0.3.2

Frequenz Microgrid Component Graph Library Release Notes

New Features

• It is now possible to create subclasses of the ComponentGraph and ComponentGraphConfig classes from python.

What's Changed

• Bump version to 0.3.2 by @shsms in #37

Full Changelog: v0.3.1...v0.3.2

v0.3.1

Frequenz Microgrid Component Graph Library Release Notes

New Features

• It is now possible to create subclasses of the ComponentGraph and ComponentGraphConfig classes from python.

What's Changed

• Reset release notes by @nhatcher-frequenz in #35
• Allow Python subclassing of ComponentGraphConfig and ComponentGraph by @shsms in #36

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Frequenz Microgrid Component Graph Library Release Notes

New Features

• Grid formulas now use single successor meters as fallback components for meters attached to the grid.
• Adds wind turbine bindings

What's Changed

• Bump actions/setup-python from 5 to 6 by @dependabot[bot] in #23
• Add Wind Turbine bindings by @nhatcher-frequenz in #34

New Contributors

• @nhatcher-frequenz made their first contribution in #34

Full Changelog: v0.2.0...v0.3.0

v0.2.0

Frequenz Microgrid Component Graph Library Release Notes

New Features

• Grid formulas now use single successor meters as fallback components for meters attached to the grid.

What's Changed

• CI improvements to get publishing of rust bindings to work by @shsms in #18
• Bump version to 0.2.0 by @shsms in #19
• Update bindings version in Cargo.lock to 0.2.0 by @shsms in #20

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Frequenz Microgrid Component Graph Library Release Notes

Summary

This is the initial release of the python bindings for the component graph.

Full Changelog: v0.1.0-rc4...v0.1.0

v0.1.0-rc5

Frequenz Microgrid Component Graph Library Release Notes

Summary

This is the initial release of the python bindings for the component graph.

Full Changelog: v0.1.0-rc4...v0.1.0-rc5