Choose your tutorial

The documentation is organised by topic — data model, case preparation, OPF, bounds. That is the right shape for reference, but not always for a newcomer who knows their goal and wants a starting point. This page routes by goal.

If you are brand new, read the end-to-end tutorial first — it is the one-sitting overview every path below assumes.

Route by goal

The judgment spine

Six of the tutorials, read in order, teach the reasoning a defensible study needs — not just how to call the tools, but when to trust the answer:

1. Triage — Findings triage. A raw import arrives with dozens of findings; learn to separate defects (fix), judgment calls (decide and document), and disclosures (keep — they are the case's provenance record).
2. Assumptions — From nameplate data to a defensible model. Incomplete datasheets in; a model out. What can be derived, what needs an assumption, and what must stay unknown — and the difference between standards-derived, standards-inspired, and synthetic values.
3. Solve — end-to-end tutorial and the OPF model. Turn the model into a solved dispatch.
4. Verify — Trust but verify. Take one solved OPF and independently recompute KCL, voltage bounds, thermal loading, losses, and the objective — learning what a solver's LOCALLY_SOLVED status does and does not guarantee.
5. Consequences — Impedance models & OPF decisions and Trusting the solver. How the modelling choices made in step 2 change the answer, and where the remaining traps live.
6. Formulation — Custom formulations. When least-cost dispatch is not your question: hooks, replaced objectives, and multi-period coupling — with the discipline each rung demands.

Read top to bottom you get the missing arc: triage → model assumptions → solve → independent verification → fidelity consequences → your own formulation.

The modelling-choices track

Step 2's "assumptions" fan out into deep dives, one per modelling choice — each demonstrating live how that choice writes the answer:

• Units, bases, scaling, and economics — the three unit systems every result rests on.
• Impedance models & OPF decisions — network fidelity, symmetry, and what balanced models hide.
• Choosing and identifying a load model — when constant-P/I/Z, ZIP, or exponential behaviour is defensible.
• From test report to transformer model — test data into validated fields, with the conventions made explicit.
• Ground, neutral, and earth return — grounding assumptions, Kron reduction, and sequence coordinates.