The equations behind the animation
Everything on the Simulation tab comes from integrating one vector ODE for ω, plus one kinematic ODE for orientation. Numbers below update live from the sidebar & each Step.
1. State
2. Newton–Euler law (the master equation)
I is only diagonal in the body frame, which itself rotates — transporting the world-frame law into the rotating body frame introduces a correction term, giving the equation actually integrated each step:
The cross-product term ω×(Iω) is the entire gyroscopic effect: it vanishes only if ω and Iω are parallel (symmetric top spinning on-axis) — otherwise it couples all three axes together.
3. Component form — Euler's equations
These nonlinear terms are what makes an asymmetric object spun about its intermediate-inertia axis tumble unpredictably (the tennis-racket / Dzhanibekov effect). Toggle "coupling" off in the sidebar (dimmed above when off) to see cheap-engine physics: each axis then obeys its own linear dωdt = τ/I, fully decoupled, and the flip never happens.
4. Live substitution (current state)
5. Orientation kinematics
Integrated exactly each step via the axis-angle exponential map: qn+1 = qn ⊗ exp(½ ωmid dt), then renormalized — this is what rotates the rectangle you see on the Simulation tab.