chore: bump tsam from 3.4.0 to 4.0.0

[dependabot]

Bumps tsam from 3.4.0 to 4.0.0.

Release notes

Sourced from tsam's releases.

v4.0.0

4.0.0 (2026-08-02)

tsam v4 is a rewrite of the internals: aggregation is now a chain of stateless functions in src/tsam/pipeline/, the class-based TimeSeriesAggregation API has been removed — tsam.aggregate() is the single entry point — and every internal identifier moved from camelCase to snake_case. For the overwhelming majority of configurations the results are bit-identical to 3.4.2; the exceptions are listed below and in the migration guide, which says for each change whether — and what — you need to do.

The v4 line was squash-merged as a single commit (#234); the entries below are reconstructed from the pull requests it contains.

⚠ BREAKING CHANGES

• the legacy TimeSeriesAggregation API and the v3 compatibility shims have been removed — use tsam.aggregate() instead (#337, #338)
• package structure reorganized (utils/ → algorithms/, new pipeline/, public serializers) (#338)
• new pipeline architecture, weight decoupling, and snake_case API (#176)
• per-column weights are now a top-level argument of aggregate(); ClusterConfig(weights=...) raises TypeError (#176)
• cluster and segment representations are resolved independently — v3 silently discarded the cluster setting when both were set (#436)
• the duration representation preserves the integral and the min/max envelope (#376)
• cluster_representatives, reconstructed, and original return columns in input order instead of alphabetically sorted (#234)
• MinMaxMean naming a column that is not in the data — or the same column in both min_columns and max_columns — now raises ValueError instead of being silently ignored (#234)
• review follow-ups on the v4 pipeline (#434)

Features

• new pipeline architecture (#234) (5d99d59)
• concurrency-preserving distribution ordering (#377, #400)
• type annotations for all functions in src/tsam (#339, #402)
• plot: compare() gained time_slice and a color dimension (#338)
• plot: new cluster-representative plot (#412)

Bug Fixes

• result: ClusteringResult.apply() is now faithful to the run it replays (#438)
• algorithms: representative selection breaks ties deterministically (#439)
• pipeline: restore v3 parity for period sums (#436)
• representations: correct maxoid variable name and document its scope (#366, #419)
• docs: disable navigation.instant so notebook plots render (#388)

Deprecations

• result.plot.cluster_weights() is renamed to result.plot.cluster_counts(); the old name still works and emits a FutureWarning
• Distribution(scope="cluster") is renamed to Distribution(scope="local"); "cluster" is normalized and emits a FutureWarning (#378, #382, #383)

Documentation

• documentation restructured along Diátaxis (Tutorials / How-to / Explanation / Reference) (#412)
• v4 API reference and architecture docs (#331)
• docstrings normalized to Google style (#339, #379, #384, #416)
• terminology in docs and notebooks aligned with the glossary (#422)
• branding and logos unified across README and the RTD landing page (#433)
• tuning-notebook animation starts at full resolution (#421)

... (truncated)

Changelog

Sourced from tsam's changelog.

4.0.0 (2026-08-02)

tsam v4 is a rewrite of the internals: aggregation is now a chain of stateless functions in src/tsam/pipeline/, the class-based TimeSeriesAggregation API has been removed — tsam.aggregate() is the single entry point — and every internal identifier moved from camelCase to snake_case. For the overwhelming majority of configurations the results are bit-identical to 3.4.2; the exceptions are listed below and in the migration guide, which says for each change whether — and what — you need to do.

The v4 line was squash-merged as a single commit (#234); the entries below are reconstructed from the pull requests it contains.

⚠ BREAKING CHANGES

• the legacy TimeSeriesAggregation API and the v3 compatibility shims have been removed — use tsam.aggregate() instead (#337, #338)
• package structure reorganized (utils/ → algorithms/, new pipeline/, public serializers) (#338)
• new pipeline architecture, weight decoupling, and snake_case API (#176)
• per-column weights are now a top-level argument of aggregate(); ClusterConfig(weights=...) raises TypeError (#176)
• cluster and segment representations are resolved independently — v3 silently discarded the cluster setting when both were set (#436)
• the duration representation preserves the integral and the min/max envelope (#376)
• cluster_representatives, reconstructed, and original return columns in input order instead of alphabetically sorted (#234)
• MinMaxMean naming a column that is not in the data — or the same column in both min_columns and max_columns — now raises ValueError instead of being silently ignored (#234)
• review follow-ups on the v4 pipeline (#434)

Features

• new pipeline architecture (#234) (5d99d59)
• concurrency-preserving distribution ordering (#377, #400)
• type annotations for all functions in src/tsam (#339, #402)
• plot: compare() gained time_slice and a color dimension (#338)
• plot: new cluster-representative plot (#412)

Bug Fixes

• result: ClusteringResult.apply() is now faithful to the run it replays (#438)
• algorithms: representative selection breaks ties deterministically (#439)
• pipeline: restore v3 parity for period sums (#436)
• representations: correct maxoid variable name and document its scope (#366, #419)
• docs: disable navigation.instant so notebook plots render (#388)

Deprecations

• result.plot.cluster_weights() is renamed to result.plot.cluster_counts(); the old name still works and emits a FutureWarning
• Distribution(scope="cluster") is renamed to Distribution(scope="local"); "cluster" is normalized and emits a FutureWarning (#378, #382, #383)

Documentation

• documentation restructured along Diátaxis (Tutorials / How-to / Explanation / Reference) (#412)
• v4 API reference and architecture docs (#331)
• docstrings normalized to Google style (#339, #379, #384, #416)
• terminology in docs and notebooks aligned with the glossary (#422)
• branding and logos unified across README and the RTD landing page (#433)
• tuning-notebook animation starts at full resolution (#421)

Already shipped in 3.x (v4 ports — not new when upgrading from 3.4.2)

... (truncated)

Commits

• a7284f7 Merge pull request #457 from FZJ-IEK3-VSA/release-please--branches--master--c...
• 0734e53 docs: flesh out the 4.0.0 release notes
• b36430b chore(master): release 4.0.0
• 8fd1b5e Merge pull request #456 from FZJ-IEK3-VSA/develop
• bcc7669 ci(publish): only publish for release tags, and gate the release on the build...
• f1d2f8e chore(deps): Update github-actions (#431)
• 5d99d59 feat!: new pipeline architecture (#234)
• de01f14 test: regenerate the full v4 case matrix on the v3 line (#440)
• a44480b chore(deps): Update dependency tqdm to <=4.69.1 (#429)
• 8f1cc4c chore(deps): Update dependency highspy to <=1.15.1 (#427)
• Additional commits viewable in compare view