docs: release notes for v0.10.0 by FabianHofmann · Pull Request #1027 · PyPSA/linopy

FabianHofmann · 2026-10-09T13:48:14Z

Note

The following content was generated by AI.

Prepares the release notes for v0.10.0.

Adds the Version 0.10.0 section and restructures it into thematic sections (v1 semantics, sparse models, scaling, softening, cuOpt, other features, performance, bug fixes, breaking changes, deprecations, documentation) with shorter bullets.
Adds missing entries: Model.to_netcdf(compression=...) (feat(io): add compression option to Model.to_netcdf #1007, compressed by default), sparse groupby(...).sum(sparse=True) (feat(v1): CSR-backed sparse groupby-sum - skew-independent build memory (6-9x on the #745 hub case) #870, feat(v1): CSR sparse groupby-sum accepts multi-key groupers (#757) #940), sparse has_terms/drop_vars (Preserve sparse expressions during metadata reads #1003).
Drops the stale claim that penalty= with freeze=True raises (supported since Native sparse soften for frozen constraints (penalty= with freeze=True) #975).
Encourages switching to v1 now: linopy 1.0 removes the legacy semantics. The rollout in migrating-to-v1.rst and design/goals.rst is shortened from three steps to two (0.10 opt-in, 1.0 v1 only).

…on in 1.0

# Conflicts: # doc/release_notes.rst

github-actions · 2026-10-10T10:36:25Z

Build cost — v1 vs legacy

v1 build peak & time relative to legacy, on this commit — not a comparison against master (that is CodSpeed).

peak — v1 / legacy	time — v1 / legacy

Full table (time + peak, mean)

benchmarks/drivers/test_build.py::test_build[basic-n=10]
                  time (s)         peak (KiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.06531 (1.16)   │   15.03 (1.00) 
 (v1)        0.05642 (1.0)   │    15.00 (1.0) 

benchmarks/drivers/test_build.py::test_build[basic-n=250]
                  time (s)         peak (MiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.06863 (1.14)   │   12.04 (1.00) 
 (v1)        0.06039 (1.0)   │    12.04 (1.0) 

benchmarks/drivers/test_build.py::test_build[cumsum-severity=0]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.02712 (1.12)   │   15.20 (1.0) 
 (v1)        0.02431 (1.0)   │   15.20 (1.0) 

benchmarks/drivers/test_build.py::test_build[cumsum-severity=100]
                 time (s)        peak (MiB) 
 name                mean   │          mean 
────────────────────────────────────────────
 (legacy)   0.0394 (1.08)   │   44.93 (1.0) 
 (v1)       0.03663 (1.0)   │   44.93 (1.0) 

benchmarks/drivers/test_build.py::test_build[cumsum-severity=50]
                  time (s)        peak (MiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.02949 (1.10)   │   11.51 (1.0) 
 (v1)         0.0267 (1.0)   │   11.51 (1.0) 

benchmarks/drivers/test_build.py::test_build[expression_arithmetic-n=10]
                 time (s)         peak (KiB) 
 name                mean   │           mean 
─────────────────────────────────────────────
 (legacy)   0.0711 (1.10)   │   24.45 (1.06) 
 (v1)       0.06436 (1.0)   │    23.04 (1.0) 

benchmarks/drivers/test_build.py::test_build[expression_arithmetic-n=250]
                  time (s)         peak (MiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.07811 (1.09)   │   16.12 (1.00) 
 (v1)        0.07142 (1.0)   │    16.12 (1.0) 

benchmarks/drivers/test_build.py::test_build[knapsack-n=10000]
                 time (s)          peak (KiB) 
 name                mean   │            mean 
──────────────────────────────────────────────
 (legacy)   0.0167 (1.09)   │   752.18 (1.10) 
 (v1)        0.0153 (1.0)   │    685.15 (1.0) 

benchmarks/drivers/test_build.py::test_build[knapsack-n=100]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.01628 (1.09)   │   3.12 (1.33) 
 (v1)        0.01499 (1.0)   │    2.34 (1.0) 

benchmarks/drivers/test_build.py::test_build[kvl_cycles-severity=0]
                  time (s)          peak (MiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.04711 (1.25)   │   126.16 (1.44) 
 (v1)        0.03761 (1.0)   │     87.71 (1.0) 

benchmarks/drivers/test_build.py::test_build[kvl_cycles-severity=100]
                  time (s)          peak (MiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.04621 (1.26)   │   126.16 (1.44) 
 (v1)        0.03682 (1.0)   │     87.71 (1.0) 

benchmarks/drivers/test_build.py::test_build[kvl_cycles-severity=50]
                  time (s)          peak (MiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.04667 (1.25)   │   126.16 (1.44) 
 (v1)        0.03726 (1.0)   │     87.71 (1.0) 

benchmarks/drivers/test_build.py::test_build[masked-n=100]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.03834 (1.04)   │    712.45 (1.0) 
 (v1)        0.03684 (1.0)   │   787.73 (1.11) 

benchmarks/drivers/test_build.py::test_build[masked-n=10]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.03725 (1.12)   │   4.62 (1.29) 
 (v1)        0.03326 (1.0)   │    3.57 (1.0) 

benchmarks/drivers/test_build.py::test_build[merge_balance-severity=0]
                 time (s)          peak (KiB) 
 name                mean   │            mean 
──────────────────────────────────────────────
 (legacy)   0.2556 (1.05)   │   707.91 (1.10) 
 (v1)        0.2438 (1.0)   │    643.85 (1.0) 

benchmarks/drivers/test_build.py::test_build[merge_balance-severity=100]
                time (s)        peak (MiB) 
 name               mean   │          mean 
───────────────────────────────────────────
 (legacy)   0.267 (1.05)   │   18.34 (1.0) 
 (v1)       0.2552 (1.0)   │   18.34 (1.0) 

benchmarks/drivers/test_build.py::test_build[merge_balance-severity=50]
                 time (s)       peak (MiB) 
 name                mean   │         mean 
───────────────────────────────────────────
 (legacy)   0.2659 (1.04)   │   9.54 (1.0) 
 (v1)        0.2546 (1.0)   │   9.54 (1.0) 

benchmarks/drivers/test_build.py::test_build[milp-n=10]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.05316 (1.12)   │   3.85 (1.14) 
 (v1)        0.04765 (1.0)   │    3.37 (1.0) 

benchmarks/drivers/test_build.py::test_build[milp-n=50]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.05304 (1.11)   │   216.98 (1.11) 
 (v1)          0.048 (1.0)   │    196.23 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance-severity=0]
                  time (s)         peak (KiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.02702 (1.11)   │   938.49 (1.0) 
 (v1)        0.02444 (1.0)   │   938.49 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance-severity=100]
                  time (s)       peak (MiB) 
 name                 mean   │         mean 
────────────────────────────────────────────
 (legacy)   0.02779 (1.10)   │   9.66 (1.0) 
 (v1)        0.02524 (1.0)   │   9.66 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance-severity=50]
                  time (s)       peak (MiB) 
 name                 mean   │         mean 
────────────────────────────────────────────
 (legacy)   0.02719 (1.08)   │   5.32 (1.0) 
 (v1)        0.02508 (1.0)   │   5.32 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance_sparse-severity=0]
                  time (s)       peak (MiB) 
 name                 mean   │         mean 
────────────────────────────────────────────
 (legacy)    0.01338 (1.0)   │   1.28 (1.0) 
 (v1)       0.01343 (1.00)   │   1.28 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance_sparse-severity=100]
                  time (s)       peak (MiB) 
 name                 mean   │         mean 
────────────────────────────────────────────
 (legacy)   0.01341 (1.01)   │   1.28 (1.0) 
 (v1)        0.01328 (1.0)   │   1.28 (1.0) 

benchmarks/drivers/test_build.py::test_build[nodal_balance_sparse-severity=50]
                 time (s)       peak (MiB) 
 name                mean   │         mean 
───────────────────────────────────────────
 (legacy)   0.0134 (1.01)   │   1.28 (1.0) 
 (v1)       0.01332 (1.0)   │   1.28 (1.0) 

benchmarks/drivers/test_build.py::test_build[piecewise-n=1000]
                 time (s)          peak (KiB) 
 name                mean   │            mean 
──────────────────────────────────────────────
 (legacy)   0.1301 (1.07)   │   946.85 (1.06) 
 (v1)        0.1215 (1.0)   │    891.54 (1.0) 

benchmarks/drivers/test_build.py::test_build[piecewise-n=10]
                 time (s)         peak (KiB) 
 name                mean   │           mean 
─────────────────────────────────────────────
 (legacy)   0.1277 (1.06)   │   12.01 (1.00) 
 (v1)        0.1201 (1.0)   │    11.99 (1.0) 

benchmarks/drivers/test_build.py::test_build[qp-n=1000]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.03349 (1.09)   │   147.70 (1.06) 
 (v1)         0.0306 (1.0)   │    139.87 (1.0) 

benchmarks/drivers/test_build.py::test_build[qp-n=10]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.03304 (1.09)   │   2.60 (1.09) 
 (v1)        0.03031 (1.0)   │    2.38 (1.0) 

benchmarks/drivers/test_build.py::test_build[rolling-severity=0]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.02801 (1.10)   │   704.59 (1.05) 
 (v1)        0.02538 (1.0)   │    673.70 (1.0) 

benchmarks/drivers/test_build.py::test_build[rolling-severity=100]
                  time (s)         peak (MiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.05995 (1.02)   │   137.97 (1.0) 
 (v1)        0.05899 (1.0)   │   137.97 (1.0) 

benchmarks/drivers/test_build.py::test_build[rolling-severity=50]
                  time (s)        peak (MiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)    0.04215 (1.0)   │   69.22 (1.0) 
 (v1)       0.04367 (1.04)   │   69.22 (1.0) 

benchmarks/drivers/test_build.py::test_build[sos-n=1000]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.03242 (1.14)   │   402.37 (1.00) 
 (v1)        0.02832 (1.0)   │    402.30 (1.0) 

benchmarks/drivers/test_build.py::test_build[sos-n=10]
                  time (s)        peak (KiB) 
 name                 mean   │          mean 
─────────────────────────────────────────────
 (legacy)   0.03165 (1.13)   │   3.23 (1.20) 
 (v1)        0.02809 (1.0)   │    2.69 (1.0) 

benchmarks/drivers/test_build.py::test_build[sparse_network-n=10]
                  time (s)         peak (KiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.03504 (1.10)   │   29.00 (1.54) 
 (v1)        0.03181 (1.0)   │    18.84 (1.0) 

benchmarks/drivers/test_build.py::test_build[sparse_network-n=250]
                  time (s)         peak (MiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.04365 (1.15)   │   37.95 (1.43) 
 (v1)         0.0378 (1.0)   │    26.51 (1.0) 

benchmarks/drivers/test_build.py::test_build[storage-n=10]
                  time (s)          peak (KiB) 
 name                 mean   │            mean 
───────────────────────────────────────────────
 (legacy)   0.06678 (1.01)   │    410.14 (1.0) 
 (v1)         0.0658 (1.0)   │   427.84 (1.04) 

benchmarks/drivers/test_build.py::test_build[storage-n=250]
                  time (s)         peak (MiB) 
 name                 mean   │           mean 
──────────────────────────────────────────────
 (legacy)   0.07107 (1.00)   │     9.94 (1.0) 
 (v1)        0.07077 (1.0)   │   10.22 (1.03)

📊 Interactive plots + CSV: download the semantics-report-v1-vs-legacy artifact from this run.

_{Report-only · not a gate · refreshed on every push · obsolete once legacy is dropped.}

codspeed · 2026-10-10T10:37:55Z

Merging this PR will not alter performance

✅ 181 untouched benchmarks
⏩ 181 skipped benchmarks¹

_{Comparing release-v0.10 (90666ff) with master (e0177b2)}

181 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

FabianHofmann added 2 commits October 9, 2026 15:48

docs: prepare release notes for v0.10.0; v1 becomes the only conventi…

7814ac5

…on in 1.0

Merge remote-tracking branch 'origin/master' into release-v0.10

90666ff

# Conflicts: # doc/release_notes.rst

FabianHofmann merged commit 2d6aaf9 into master Oct 10, 2026
24 checks passed

FabianHofmann deleted the release-v0.10 branch October 10, 2026 12:34

Navigation Menu

Repository navigation

docs: release notes for v0.10.0 - #1027

docs: release notes for v0.10.0#1027
FabianHofmann merged 2 commits into
masterfrom
release-v0.10

FabianHofmann commented Oct 9, 2026

Uh oh!

github-actions Bot commented Oct 10, 2026

Uh oh!

codspeed Bot commented Oct 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

FabianHofmann commented Oct 9, 2026

Uh oh!

github-actions Bot commented Oct 10, 2026

Build cost — v1 vs legacy

Uh oh!

codspeed Bot commented Oct 10, 2026

Merging this PR will not alter performance

Footnotes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant