v0.15.0

Tooling Library for Notebooks Release Notes

Summary

• Refined asset optimization Plotly visuals and layout behavior for clarity and consistency.
• Updated reporting time-series visuals (colors, line styles, stacking, and shading).

Upgrading

• Reporting metrics now consistently assume PSC sign conventions for production and no longer accept a production_is_positive toggle.
• Removed production_is_positive from reporting metric helpers and add_energy_flows().
• If you previously passed already-positive production to these helpers, pass -production instead (PSC convention: production is negative).
• plot_time_series() now supports shade_by_category for long-format plots to render category series as shades of one base color.

New Features

• Added production self-usage metrics to reporting flows and aggregations (production_self_usage, production_self_share).
• Improved asset optimization Plotly styling (fonts, hover labels, legends, titles) and subplot spacing.
• Added stacked PV/CHP behavior in asset optimization power flow plots (PV now stacks on CHP).
• Added LINE_DASH_MAP for consistent line dash styles and applied it in reporting time-series plots.
• Added per-category shade rendering for long-format reporting time-series plots.

Bug Fixes

• Fixed monthly aggregation Plotly plot to group bars by month correctly.
• Fixed reporting time-series shading to correctly parse rgb(...)/rgba(...) base colors.
• Set reporting and asset optimization Plotly trace line widths to 1 for consistent stroke weight.
• Updated reporting color mappings to the latest conventions (incl. battery charge/discharge and PV/CHP/Wind labels).

What's Changed

• Fix asset optimization plotly by @Mohammad-Tayyab-Frequenz in #276
• Remove prod positive argument by @Mohammad-Tayyab-Frequenz in #275
• Update reporting assetopt plots by @Mohammad-Tayyab-Frequenz in #277

Full Changelog: v0.14.8...v0.15.0

v0.14.8

Tooling Library for Notebooks Release Notes

Summary

Upgrading

New Features

• Added production self-usage metrics to reporting flows and aggregations (production_self_usage, production_self_share).

Bug Fixes

What's Changed

• chore(deps-dev): bump setuptools from 80.10.2 to 82.0.0 by @dependabot[bot] in #268
• chore(deps): bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #263
• chore(deps-dev): bump nox from 2025.11.12 to 2026.2.9 by @dependabot[bot] in #270
• chore(deps): bump actions/download-artifact from 7 to 8 by @dependabot[bot] in #264
• chore(deps-dev): bump mkdocstrings-python from 1.18.2 to 2.0.3 by @dependabot[bot] in #271
• chore(deps): bump ipython from 9.9.0 to 9.10.0 in the minor group by @dependabot[bot] in #266
• chore(deps-dev): bump the patch group with 5 updates by @dependabot[bot] in #265
• chore(deps-dev): bump isort from 7.0.0 to 8.0.1 by @dependabot[bot] in #269
• chore(deps): bump frequenz-floss/gh-action-setup-python-with-deps from 1.0.1 to 1.0.2 in the compatible group by @dependabot[bot] in #262
• Add production self share by @Mohammad-Tayyab-Frequenz in #274

Full Changelog: v0.14.7...v0.14.8

v0.14.7

Tooling Library for Notebooks Release Notes

Summary

Upgrading

New Features

• build_color_map now sources default colors from the in-code color dictionary rather than a YAML file.

Bug Fixes

• Added normalize_date_for_report to return current time for today, midnight for past dates, and reject future dates.

What's Changed

• Normalize report date handling and update color map docs by @Mohammad-Tayyab-Frequenz in #261

Full Changelog: v0.14.6...v0.14.7

v0.14.6

Tooling Library for Notebooks Release Notes

Summary

Upgrading

New Features

Bug Fixes

Fix state analysis to support new ElectricalComponent*Code enums and diagnostic code handling.

What's Changed

• Fix state analysis notebook with new electrical component enums If by @cyiallou in #260

Full Changelog: v0.14.5...v0.14.6

v0.14.5

Tooling Library for Notebooks Release Notes

Summary

This release updates the asset-optimization reporting visuals to Plotly, improves
interactivity and styling, and refactors data preparation for reuse.

Upgrading

• Asset-optimization plotting now returns Plotly figures (instead of matplotlib).
  Update any downstream code that expects matplotlib Axes objects.

New Features

• Plotly-based asset-optimization charts with interactive hover, range sliders,
  and improved styling (white background, borders, legend layout).

Bug Fixes

• Update the asset optimization notebook with the correct api keys.

What's Changed

• reset-release-notes by @Mohammad-Tayyab-Frequenz in #255
• Fix asset opt nb by @Mohammad-Tayyab-Frequenz in #256
• Update asset optimization notebook to plotly by @Mohammad-Tayyab-Frequenz in #258
• Add asset optimization example notebooks by @Mohammad-Tayyab-Frequenz in #259

Full Changelog: v0.14.4...v0.14.5

v0.14.4

Tooling Library for Notebooks Release Notes

Summary

Upgrading

• Breaking change for solar and alert notebooks: environment variable names have been updated.

New Features

• Added test cases for reporting metrics.

Bug Fixes

• Fill missing values in aggregated component columns.
• Update aggregate metrics to have only positive values in grid consumption.
• Update grid feed-in metrics to first include negative values from grid column and simplify the grid feed-in logic.

What's Changed

• chore(deps): update pyarrow requirement from <23.0.0,>=20.0.0 to >=20.0.0,<24.0.0 by @dependabot[bot] in #247
• chore(deps): bump the minor group with 2 updates by @dependabot[bot] in #242
• chore(deps-dev): bump the patch group with 2 updates by @dependabot[bot] in #241
• chore(deps-dev): bump the patch group with 2 updates by @dependabot[bot] in #250
• Update repo config to v0.14.0 by @cyiallou in #251
• Bump black from 25.12.0 to 26.1.0 by @cyiallou in #252
• bump pandas-stubs from 2.3.3.251219 to 2.3.3.260113 by @cyiallou in #253
• Fix grid feed in by @Mohammad-Tayyab-Frequenz in #254

Full Changelog: v0.14.3...v0.14.4

v0.14.3

Tooling Library for Notebooks Release Notes

Summary

Upgrading

• Breaking change for solar and alert notebooks: environment variable names have been updated.

New Features

• Added test cases for reporting metrics.

Bug Fixes

• Fill missing values in aggregated component columns.
• Update aggregate metrics to have only positive values in grid consumption.

What's Changed

• docs: prepare release notes for release by @Mohammad-Tayyab-Frequenz in #240

Full Changelog: v0.14.2...v0.14.3

v0.14.1

Tooling Library for Notebooks Release Notes

Summary

Minor dependency updates.

Upgrading

New Features

Bug Fixes

What's Changed

• chore(deps): update frequenz-gridpool requirement from <0.2,>=0.1.1 to >=0.1.1,<0.3 by @dependabot[bot] in #233
• Reset release notes after v0.14.0 release by @cyiallou in #227
• chore(deps-dev): bump the patch group with 2 updates by @dependabot[bot] in #231
• chore(deps): bump actions/upload-artifact from 5 to 6 by @dependabot[bot] in #230
• chore(deps): bump actions/download-artifact from 6 to 7 by @dependabot[bot] in #229
• chore(deps-dev): bump pandas-stubs from 2.3.3.251201 to 2.3.3.251219 by @dependabot[bot] in #234
• chore(deps-dev): bump async-solipsism from 0.8 to 0.9 by @dependabot[bot] in #232
• Prepare for release by @cyiallou in #235

Full Changelog: v0.14.0...v0.14.1

v0.14.0

Tooling Library for Notebooks Release Notes

Summary

• Align tooling with the latest reporting client, gridpool, and repository config releases while tightening typing and plotting helpers across the solar reporting suites.

Upgrading

• Point dependencies at the new frequenz-client-reporting >= 0.20 line, frequenz-gridpool >= 0.1.1, and frequenz-repo-config 0.13.8 so packaging matches the newest releases.
• Update the default solar metric to Metric.AC_POWER_ACTIVE alongside the v2 Metric import path.

New Features

• N/A

Bug Fixes

• Fix nox formatting/type warnings by casting timezone conversions, enforcing literal aggregation functions, and keeping area/line plotting parameters typed in the solar maintenance views.
• Calculate consumption in scenarios where consumption is missing from the data.

What's Changed

• Switch to MicrogridConfig from fz-gridpool by @cwasicki in #216
• chore(deps): bump the minor group with 2 updates by @dependabot[bot] in #218
• chore(deps): update plotly requirement from <6.4.0,>=6.0.0 to >=6.0.0,<6.6.0 by @dependabot[bot] in #220
• chore(deps-dev): bump mkdocstrings[python] from 0.30.1 to 1.0.0 by @dependabot[bot] in #221
• chore(deps-dev): bump pytest-asyncio from 1.2.0 to 1.3.0 by @dependabot[bot] in #222
• chore(deps-dev): bump pytest from 8.4.2 to 9.0.2 by @dependabot[bot] in #219
• fix: update client reporting dependency by @Mohammad-Tayyab-Frequenz in #224
• Add missing consumption by @Mohammad-Tayyab-Frequenz in #226

Full Changelog: v0.13.2...v0.14.0

v0.13.2

Tooling Library for Notebooks Release Notes

Summary

Upgrading

New Features

Bug Fixes

• Fixed wind components in the energy_report_df and aggregating metrics.

What's Changed

• Update wind component by @Mohammad-Tayyab-Frequenz in #214

Full Changelog: v0.13.1...v0.13.2