Skip to content

docs(piecewise): rewrite reference page + tutorials for correctness and pedagogy #677

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
FabianHofmann merged 29 commits into from
May 12, 2026
+557 −396
Merged

docs(piecewise): rewrite reference page + tutorials for correctness and pedagogy #677

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
cdc2df6
docs(piecewise): tighten language and fix small inaccuracies
FBumann May 11, 2026
e7cd756
docs(piecewise): rename tutorial heading to "Creating Piecewise Linea…
FBumann May 11, 2026
c5104be
docs(piecewise): rename inequality-bounds tutorial heading to match
FBumann May 11, 2026
716eb71
docs(piecewise): polish both tutorials for readability
FBumann May 11, 2026
c5055ab
docs(piecewise): make solver_name='highs' explicit in tutorials
FBumann May 11, 2026
29cc65b
docs(piecewise): reframe inequality-bounds tutorial as power ≤ f(fuel)
FBumann May 11, 2026
9829e8e
docs(piecewise): reframe tutorial 1 §4 as fuel ≥ f(power)
FBumann May 11, 2026
d7592f3
docs(piecewise): use fuel ≥ f(power) in the rst Quick Start
FBumann May 11, 2026
31f31f0
docs(piecewise): switch Quick Start + tutorial §4 to power ≤ f(fuel)
FBumann May 11, 2026
f516fc9
docs(piecewise): align tutorial 2 breakpoints with the rest
FBumann May 11, 2026
dbcea0b
docs(piecewise): silence EvolvingAPIWarning in tutorial setup cells
FBumann May 11, 2026
3d84a90
docs(piecewise): switch unified inequality example to fuel ≥ f(power)
FBumann May 11, 2026
825af88
docs(piecewise): add reformulate_sos="auto" to tutorial 2's solve
FBumann May 11, 2026
1e691ea
docs(piecewise): restructure rst + tutorial flow tweaks
FBumann May 11, 2026
e706734
docs(piecewise): drop "Formulation math" subsection, fold warning int…
FBumann May 11, 2026
c2fe7f6
docs(piecewise): explain why active is not supported with method="lp"
FBumann May 11, 2026
04fccec
ci: trigger docs build
FBumann May 11, 2026
644bb50
docs(piecewise): replace §3 (0,0) "off" segment with discrete-sizing …
FBumann May 11, 2026
7935b4c
docs(piecewise): replace (0,0) segment in rst example with discrete-s…
FBumann May 11, 2026
bf32c46
docs(piecewise): use pump VSD as the disjunctive example
FBumann May 11, 2026
6438db0
docs(piecewise): two pumps with two bands each, demand catches the gap
FBumann May 11, 2026
c0c4cb4
docs(piecewise): flatten §3 output to a 3-column DataFrame
FBumann May 11, 2026
2628952
docs(piecewise): show per-pump flow and power in §3 output
FBumann May 11, 2026
5b590d5
docs(piecewise): inline §3 demand to stop clobbering §1's
FBumann May 11, 2026
522e78d
docs(piecewise): pull the inequality Quick Start explanation out of t…
FBumann May 11, 2026
79fb8e2
docs(piecewise): trim the disjunctive snippet's comment to one line
FBumann May 11, 2026
53d3fa5
docs(piecewise): use .html extension in tutorial cross-links
FBumann May 11, 2026
65f6154
docs(piecewise): use .rst / .nblink in tutorial cross-links
FBumann May 11, 2026
532dab6
docs(piecewise): address review feedback (PR #677)
FBumann May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Loading