# Spherical helix ## What this builds A small museum of 3D paths you wander rather than only watch. Each room is a parameterized curve — a spherical helix, a torus knot, a 3D Lissajous figure — with a camera that can ride along it. The math is listed, and tests assert that a curve passes through documented points. Golden camera views are taken in each room. The presentation is original. Read `spekkr.inputs.json` first. `title` is in the first room. `room` is where a visit starts; all three rooms exist. `turns` is used by the helix. `ribbon` and `guides` change the picture. ## Out of scope - A general computer-algebra system. - Network or a user-uploaded equation in this version. - A fourth family of curves in this version. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. The curves - Each curve is a function r(t) for t in [0, 1], with the formulas in `design.md`. - At the listed t values, r(t) matches the points in `fixtures/curves-points.json` within 1e-4. - The spherical helix lies on a sphere of radius 1: |r(t)| is 1 within 1e-4 for 64 sample t values, at the default `turns`. Accept when: every listed point matches, and the helix samples lie on the sphere. ### R2. The ride - A camera ride sets position to r(t) minus a documented offset along the normal, looking at r(t). - At t = 0, 0.25, 0.5 the camera pose matches `fixtures/curves-cameras.json` for the helix at 5 turns. Accept when: the three poses match within 0.01 units and 0.5 degrees. ### R3. Frames and files - Goldens: each room from a still camera, and one along-path helix view at t = 0.25. - One command runs the point, sphere, and pose tests, and writes the frames. No network. Accept when: the command passes at turns 2 and 5, and the frames match the goldens. ### R4. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ## Verification Each parameterized curve passes through documented points within 1e-4, and the spherical helix stays on the unit sphere at 64 samples. Camera poses along a ride match a file. Golden views are taken in each room and along the path. No network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to wander the rooms, how to change turns, and how to run the checks.