Theory¶
Complex subjects get a dedicated chapter that takes a reader from novice to able to implement — not a literature dump, and not a proof: a constructive path. Every chapter follows the same seven-part shape (PRD 15.3):
the problem in one paragraph, in physical terms;
the minimum background, developed from scratch with notation defined at first use;
the derivation, in steps small enough to check individually;
the algorithm as pseudocode matching the real function names in this codebase;
a worked numerical example with actual numbers a reader can reproduce;
failure modes, and how the code guards them;
references, open-access preferred, each annotated with why you would read it.
Most chapters below are outlines: section 1 and the failure modes are written, the derivation and the worked example are not. Each chapter is filled in by the milestone that implements it, because a derivation written before the code is a guess and a worked example written before the code has no numbers to quote.