Module 4 — Integrable systems, action-angle coordinates and KAM theory
Lecture notes written against midi-sink as shipped (libsumi 1.12.0, Voxo 0.26.0, 2026-10-25) and checked claim by claim against the engine before this fold (2026-10-26; libsumi is unchanged since, and Voxo’s later versions add the sampler’s second generation and touch no synth claim here). Code citations and gate numbers refer to docs/PROJECT_SPEC.md (spec v6), docs/DECISIONS.md Part XIII (cited DECISIONS_13 #n), voxo/src/suzu.h, and site/src/content/docs/operators/. The lab beside the module is a standalone teaching re-implementation, never the engine; the engine’s own lab is the Suzu lab.
Lecture Notes
Section titled “Lecture Notes”4.1 Complete Integrability ( Commuting Integrals) & The Liouville–Arnold Theorem
Section titled “4.1 Complete Integrability (nnn Commuting Integrals) & The Liouville–Arnold Theorem”In Module 3 (§3.4), we saw that any 1-DoF Hamiltonian on a 2-dimensional phase space with compact regular energy curves is automatically integrable: the energy itself is the single required conserved quantity, each connected level set is a 1-torus , and the enclosed phase-space area gives canonical action-angle coordinates .
What happens in higher dimensions (), such as a 2D stadium billiard (), a double pendulum (), a 3-vortex Kirchhoff chord braid (), or an -node modal/Toda ring ()? Conservation of energy restricts the trajectory only to a -dimensional hypersurface. To confine trajectories to -dimensional tori , we need independent conservation laws that commute with one another:
Definition 4.1 (Liouville Complete Integrability): A Hamiltonian system on a -dimensional symplectic manifold is completely integrable (in the sense of Liouville) if there exist smooth functions (with ) such that:
- Involution (Mutual Commutativity): Every pair of integrals has vanishing Poisson bracket:
- Functional Independence: The differentials are linearly independent () on a dense open subset of .
Why Commuting Integrals Force Invariant Lagrangian Tori
Section titled “Why Commuting Integrals Force Invariant Lagrangian Tori Tn\mathbb{T}^nTn”Suppose is a regular value of the momentum map , and consider the joint level set:
By the Regular Value Theorem, is a smooth submanifold of dimension . Now examine the Hamiltonian vector fields along :
- Tangency to : The derivative of along is . Therefore, every is tangent to , and since are linearly independent and is non-degenerate, forms a basis for the tangent space at every point !
- is a Lagrangian Submanifold: Evaluating the symplectic 2-form on any two basis vectors of gives: A half-dimensional submanifold () on which vanishes identically is called a Lagrangian submanifold. Notice that is the maximum possible number of independent commuting integrals on , because the skew-orthogonal complement of an -dimensional isotropic subspace has dimension .
- Commuting Flows & Torus Topology: Recall from Module 2 (§2.2) that the Lie bracket of two Hamiltonian vector fields satisfies . Because the vector fields commute pairwise and are complete on a compact level set , their flows define a smooth, locally free, transitive group action of the additive group on each connected component of . The quotient of by a discrete lattice of periods is an -torus !
This geometric picture culminates in the Liouville–Arnold Theorem (1855, 1963):
Theorem 4.2 (Liouville–Arnold): Let be a completely integrable system with momentum map . If a regular level set is compact and connected, then:
- is diffeomorphic to the -torus .
- In an open neighbourhood foliated by invariant Lagrangian tori, there exist canonical Darboux action-angle coordinates defined by the cycle integrals of the tautological 1-form around independent homology cycles of : (Why is independent of how we deform the loop on ? Because is Lagrangian: between two homologous loops bounding a surface , Stokes’ theorem gives !)
- In action-angle coordinates, depend only on the actions . In particular, , and Hamilton’s equations linearize completely:
Integrable Tori Across midi-sink (Suzu & libsumi)
Section titled “Integrable Tori Across midi-sink (Suzu & libsumi)”- The Circle vs. Bunimovich Stadium Billiard (
suzu::Billiard,voxo/src/suzu.h): Insuzu::Billiard, a particle moves in 2D with conjugate velocity () under the harmonic spring inside a stadium wall of aspect and straight half-length (g(x_1, x_2) = 0).- When and (Circular Billiard), the wall is radially symmetric. The angular momentum is conserved across every specular reflection ( because ) and commutes with : ! With commuting integrals on a 4D phase space, the circular billiard is Liouville integrable: every trajectory is confined to an invariant 2-torus , and in
tests/voxo_suzu_tests.cpp(gates 61–62,DECISIONS_13 #3) the engine’s strobe — the pair sampled at the bass’s reference phasor — stays on a line occupying only 24 / 576 cells (a central kick is radial), the 66 393 collisions of a minute lossless within dB; the collision map used below is this lesson’s own coordinate on the same orbit, not what the suite counts. - The instant you raise the mod wheel (, the Bunimovich Stadium), the straight wall segments break rotational symmetry: at wall reflections, the invariant 2-tori shatter via defocusing hyperbolicity, and a single trajectory ergodically sprays across 153 / 576 strobe cells!
- When and (Circular Billiard), the wall is radially symmetric. The angular momentum is conserved across every specular reflection ( because ) and commutes with : ! With commuting integrals on a 4D phase space, the circular billiard is Liouville integrable: every trajectory is confined to an invariant 2-torus , and in
- The Toda Lattice — integrable in continuous time, near-integrable as the engine’s ring (
suzu::TodaRing): Why does a nonlinear exponential lattice never thermalize or break into chaos like a generic Fermi–Pasta–Ulam–Tsingou (FPUT) chain? Because Hénon and Flaschka (1974) proved that the continuous-time lattice possesses independent global integrals in involution: where is the periodic Jacobi Lax matrix with on the diagonal and on the off-diagonals! In action-angle coordinates , multi-soliton collisions are simply linear phase shifts on an -torus . The engine’s ring is the discrete leapfrog on this Hamiltonian: it conserves a modified , not the Lax invariants — near-integrable, which is why its gate measures the soliton’s shape (amplitude × width within 0.72 %) instead of asserting that the ring never breaks into chaos (DECISIONS_13 #1, the shape gate). - Uncoupled Modal Banks (
suzu::Cell[MODES_MAX],voxo/src/suzu.h): A bank of modal resonators with frequencies has commuting actions . When the modes have irrational frequency ratios (such as the zeros of Bessel functions on a circular membrane or the roots of on a free bar), the flow winds densely around the -torus , producing a crystalline, non-repeating inharmonic timbre.
4.2 Perturbed Integrable Systems, Small Divisors & The KAM Theorem
Section titled “4.2 Perturbed Integrable Systems, Small Divisors & The KAM Theorem”Almost no real physical system is exactly integrable: strings couple across a bridge (lattice_kick in voxo/src/suzu.h), planets tug on one another, and nonlinear oscillators experience periodic drives (suzu::Rotor in voxo/src/suzu.h). Written in the action-angle coordinates of an unperturbed integrable system , a perturbed Hamiltonian takes the form:
with perturbed equations of motion:
In 1892, Henri Poincaré called the study of the “fundamental problem of dynamics.” For decades before 1954, physicists assumed (following Boltzmann’s ergodic hypothesis) that any generic perturbation would immediately destroy all invariant tori and make the motion ergodic on the -dimensional energy surface.
Classical Canonical Perturbation Theory & The Small Divisor Crisis
Section titled “Classical Canonical Perturbation Theory & The Small Divisor Crisis”Why did classical perturbation series diverge? Let us try to straighten the perturbed system back into integrable form by applying a near-identity Type-2 Generating Function (Module 3, §3.3):
which generates the canonical transformation:
Taylor-expanding to first order in yields:
To eliminate the -dependence at , must solve the homological partial differential equation on :
Expanding and in Fourier series on the -torus , we can solve for each Fourier coefficient algebraically:
Look at the denominator :
- Exact Rational Resonance (): Whenever the frequencies are rationally commensurate ( for some integer vector ), the denominator vanishes and blows up!
- Dense Small Divisors: Even if is irrational ( for all ), integer combinations become arbitrarily close to zero as ! Furthermore, if is non-degenerate (, meaning the frequencies vary with action ), then the resonant actions form a dense subset of action space !
The Kolmogorov–Arnold–Moser (KAM) Theorem (1954, 1962, 1963)
Section titled “The Kolmogorov–Arnold–Moser (KAM) Theorem (1954, 1962, 1963)”In 1954, Andrey Kolmogorov announced (and Vladimir Arnold and Jürgen Moser proved in 1962–1963) a stunning resolution to the small divisor problem: most invariant tori do not break!
How does KAM overcome the small divisors ? By combining two insights:
- Diophantine Irrationality Condition: Instead of trying to save all tori, fix a frequency vector that is poorly approximated by rationals — a Diophantine vector satisfying, for some constants and : When is real-analytic (or sufficiently smooth), its Fourier coefficients decay exponentially: . On a Diophantine torus, the polynomial growth of the small divisor is completely overwhelmed by the exponential decay of the numerator, so the solution of the homological equation converges!
- Kolmogorov’s Superconvergent Newton Iteration (Quadratic Convergence ): Because the frequency shifts slightly at each perturbative step, a standard power series in still diverges. Kolmogorov instead adjusted the action at each step to keep the frequency vector locked to the fixed Diophantine (requiring the twist / non-degeneracy condition ) and applied a Newton–Kantorovich iteration in canonical transformations, squaring the error at step () so fast that it outruns the shrinking analyticity strip!
Theorem 4.3 (KAM Theorem): Let be analytic (or with , Moser 1962) on , and suppose is non-degenerate: Then for sufficiently small, every unperturbed torus whose frequency vector satisfies the Diophantine condition with persists as a smoothly deformed invariant Lagrangian torus of the perturbed flow, on which the motion is canonically conjugate to the linear quasi-periodic translation . Moreover, the union of surviving KAM tori is a fat Cantor set of positive Lebesgue measure whose complement (the resonant gaps and chaotic layers) has measure as .
4.3 Poincaré Sections, Rotation Numbers, Poincaré–Birkhoff Islands & Arnol’d Lock
Section titled “4.3 Poincaré Sections, Rotation Numbers, Poincaré–Birkhoff Islands & Arnol’d Lock”How do we visualize a 4D continuous Hamiltonian flow (like the Hénon–Heiles galactic/molecular potential or Suzu’s Billiard) or a 2D time-periodic system on a 2D GPU canvas?
Poincaré Surface of Section & Empirical Rotation (Winding) Numbers
Section titled “Poincaré Surface of Section & Empirical Rotation (Winding) Numbers”Given a 2-DoF autonomous Hamiltonian on a 3D energy hypersurface , we slice with a 2D transverse plane — for instance, with — and record the 2D coordinates every time the trajectory pierces the plane. By Liouville’s Theorem / Poincaré’s recurrence construction, the resulting Poincaré return map is an exact area-preserving symplectomorphism ()!
Similarly, for a periodically kicked rotor on the cylinder , sampling once per kick period gives the Chirikov Standard Map (site/src/content/docs/operators/chirikov.mdx, suzu::Rotor in voxo/src/suzu.h):
How does a GPU shader distinguish a surviving KAM torus, a resonant Poincaré–Birkhoff island chain, and a chaotic sea on a grid of initial conditions ? By computing each pixel’s empirical rotation (winding) number over iterations (using the un-wrapped angle ):
Look at the three distinct geometric signatures of :
-
Diophantine KAM Curve ( irrational): The orbit traces a smooth, unbroken 1D curve wrapping all the way around the cylinder , and converges rapidly (, or with Birkhoff weighting) to a constant irrational number!
- Which KAM curve is the last to break? By Hurwitz’s theorem on Diophantine approximation, a real number’s continued fraction is hardest to approximate by rationals when every partial quotient is as small as possible: for all ! That gives the noble golden-ratio winding numbers:
- Using Greene’s Residue Method (1979) on the Fibonacci rational periodic orbits (), John Greene proved that the golden KAM curve survives up to the universal critical kick strength:
- In 2D phase space, a 1D closed curve divides the cylinder into two disconnected halves. Therefore, for , the golden KAM curves act as impenetrable topological dams: no chaotic trajectory can ever cross them, and momentum is strictly bounded forever! For , the golden KAM curve shatters into a Cantor dust (cantorus) with turnstile gaps through which trajectories leak across the entire cylinder (
suzu::Rotortransitions from sideband-modulated tone to pitched noise across the octave!).
-
Resonant Torus Breakup & The Poincaré–Birkhoff Theorem (): What happens at an unperturbed rational winding number (), where every point of the unperturbed circle is a fixed point of the -fold iterate ? When , the Poincaré–Birkhoff Theorem proves that the continuous circle of period- points cannot survive intact; instead, at least periodic points survive in an alternating chain around the cylinder:
- stable elliptic periodic points (), each surrounded by a vortex-like resonant island of librating trajectories whose rotation number is locked flat at across the entire finite width of the island! Plotting as a function of initial momentum produces a fractal ** Devil’s Staircase** of flat rational plateaus at
- unstable hyperbolic saddle points (), whose stable and unstable manifolds split apart and intersect transversely infinitely many times (Poincaré’s homoclinic tangle), forming a chaotic stochastic layer framing the island chain!
-
How
libsumi’s Arnol’d Lock Operator (arnold_fs) Draws Musical Intervals as Poincaré–Birkhoff Islands: Look at the Arnol’d lock page. In Kessho mode (press_mode = 3), holding a chord locks every upper voice to the lowest held bass note! The engine reads the frequency ratio (including MPE pitch bend), takes its fractional part , and finds the nearest continued-fraction rational () inside the Arnol’d tongue . Every frame,arnold_fsapplies one iteration of the canonical kicked twist map in Darboux polar coordinates generated by the Type-2 generating function: followed by the Lamb–Oseen twist rotating the ring by turns per frame (inverted in the shader by 5 scalar Newton steps on , keeping identically):- Just Intonation = Phase-Locked Poincaré–Birkhoff Islands: A pure fifth () or major third () sits at the exact rational centre of the tongue: the Poincaré–Birkhoff islands stand still on the water over 600+ frames while ink librates inside them!
- Equal Temperament = Stroboscopic Island Precession: An equal-tempered MIDI fifth (, 2 cents flat of ) has , so its 2 islands precess once every 600 frames; an equal-tempered major third (, 14 cents sharp of ) precesses faster!
4.4 Polyphonic Torus Sonification at 48 kHz: Diophantine Chords vs. Resonant Phase-Locking
Section titled “4.4 Polyphonic Torus Sonification at 48 kHz: Diophantine Chords vs. Resonant Phase-Locking”In Part 2 of this module’s lab (and inside Suzu’s coupled modal lattice lattice_kick, voxo/src/suzu.h, as well as suzu::Rotor), we turn the geometry of an -torus directly into polyphonic sound at 48 kHz.
Consider an -dimensional torus with angles and conjugate actions evolving under the perturbed Hamiltonian:
where each torus coordinate drives an audible partial with instantaneous frequency:
Listen to what happens in three distinct dynamical regimes as you move the initial condition across phase space or sweep the perturbation :
- On a Diophantine KAM Torus (e.g., Golden-Ratio / Metallic-Mean Ratios ): Because is bounded away from zero, the resonant angle combinations rotate rapidly and never lock. The actions undergo only tiny, bounded ripples around , and the instantaneous frequencies stay locked to their Diophantine ratio. Audibly, the polyphonic sum is a stationary, crystalline, shimmer-free inharmonic chord whose Lissajous projection on weaves an unbroken ergodic carpet!
- Inside a Broken Rational Resonance / Poincaré–Birkhoff Island (, e.g., , , or ):
Define the resonant slow phase and its conjugate resonant action . Expanding near the resonance surface reduces the slow dynamics to the pendulum Hamiltonian of Module 2:
Inside the resonant island (), the resonant phase cannot circulate; instead, it librates back and forth around at the low island libration frequency !
What does that sound like at 48 kHz?
- Rhythmic Phase-Locking: The ratio of the average frequencies is pinned exactly to the rational ratio (an Arnol’d tongue!).
- Low-Frequency FM & AM Sidebands: Because and oscillate back and forth at the slow libration frequency , the voices frequency-modulate and exchange action energy rhythmically at ! You hear unmistakable pulsing FM sidebands () and slow acoustic beating inside the locked interval!
- Across the Separatrix / Above Greene’s Threshold ():
Placing the cursor right on the hyperbolic saddle / homoclinic tangle of a broken resonance (or pushing ) sends tumbling erratically between libration and rotation, causing the instantaneous frequencies to wander chaotically — the exact acoustic signature of
suzu::Rotor(voxo/src/suzu.h) crossing Greene’s threshold!
Lab Instructions (module_04_lab.html)
Section titled “Lab Instructions (module_04_lab.html)”Open the module’s lab (a standalone page — a teaching re-implementation, never the engine) in a WebGL2 + WebAudio browser. The two workspaces are directly linked: clicking any point on the GPU Poincaré / Winding-Number Shader Map in Part 1 immediately sets the initial condition of the 48 kHz Polyphonic Torus Synthesizer in Part 2!
Part 1: Shader Lab — GPU Poincaré Maps, Winding Numbers & KAM / Poincaré–Birkhoff Structure
Section titled “Part 1: Shader Lab — GPU Poincaré Maps, Winding Numbers & KAM / Poincaré–Birkhoff Structure”Each pixel in the WebGL2 shader represents an initial condition for the Chirikov Standard Map (or Arnol’d Tongue Circle-Twist Map arnold_fs / Stroboscopic Hénon–Heiles Map). For every pixel in parallel, the fragment shader iterates the symplectic map up to 500 steps per frame and computes the empirical rotation number:
-
Locate Golden-Ratio KAM Curves vs. Poincaré–Birkhoff Island Chains:
- Start in High-Contrast Winding Number + Golden KAM & Rational Resonance Highlight mode at (below Greene’s threshold ).
- Observe how the shader highlights:
- Bright Gold Contours: The surviving Golden-Ratio Diophantine KAM Tori at and , stretching unbroken all the way across as topological barriers!
- Cyan / Magenta Island Chains: The Poincaré–Birkhoff Resonant Islands at , where the rotation number locks onto a flat constant plateau across each elliptic eye!
- Sweep the Perturbation / Kick Strength slider across Greene’s Threshold :
- At , invariant KAM curves foliate almost the entire phase space.
- At (click the Snap (Greene) button), watch the golden-ratio curve wrinkle critically between the growing , , and Fibonacci island chains.
- Above , the golden barrier breaks and the chaotic sea floods vertically across the cylinder!
-
Inspect the Devil’s Staircase Slice & Single-Orbit Strobe Overlay:
- Move or click your cursor anywhere on the WebGL2 map. The live CPU Orbit Strobe & Devil’s Staircase Overlay traces the 500-point trajectory of your selected initial condition right on top of the shader and plots the 1D Devil’s Staircase curve along the vertical cross-section!
Part 2: Sound Lab — 48 kHz Polyphonic -Torus Sonification
Section titled “Part 2: Sound Lab — 48 kHz Polyphonic nnn-Torus Sonification”The bottom 48 kHz WebAudio engine integrates a 3-Voice Coupled Torus System driven by the cursor’s action ratio (or selected via one-click presets):
- Hear a Diophantine KAM Torus vs. a Broken Rational Resonance:
- Click Start 48 kHz Torus Synth and click Preset 1: Golden Diophantine KAM Torus ().
- Listen to the polyphonic output : even with coupling , the frequencies stay locked to their Diophantine ratio with zero phase-locking and zero low-frequency beating — a pure, crystalline inharmonic bell chord! Look at the Torus Lissajous Scope (filling a smooth invariant annulus) and the Instantaneous Frequency Strip Chart (three steady horizontal tracks).
- Now click Preset 2: Broken Poincaré–Birkhoff Resonance Island (or click directly inside the or island eye on the Part 1 shader canvas!).
- Immediately hear the chord phase-lock into the rational resonance while the slow pendulum libration inside the island produces rhythmic low-frequency FM sidebands and action-exchange pulsing between the partials!
- Now click Preset 3: Homoclinic Separatrix / Chaotic Sea () to hear the resonant phase slip erratically across the hyperbolic saddle, turning the stationary chord into a shimmering chaotic texture.
Problem Set
Section titled “Problem Set”Problem 4.1: Complete Integrability of the Circular Billiard & The 2-Body Toda Ring
Section titled “Problem 4.1: Complete Integrability of the Circular Billiard & The 2-Body Toda Ring”-
Commuting Integrals on the Circular Billiard (
suzu::Billiard,voxo/src/suzu.h): Consider the 2-DoF harmonic oscillator in the plane with symplectic form , Hamiltonian , and angular momentum .- Compute the canonical Poisson bracket directly and verify .
- Show that at a specular reflection off the boundary wall , is conserved if and only if the wall normal is everywhere parallel to the position vector (i.e., the circular wall ). Explain why setting (
hl > 0insuzu::Billiard) breaks -conservation on the straight segments and destroys the invariant 2-tori.
-
Lax Pair & Involution for the Toda Ring (
suzu::TodaRing,voxo/src/suzu.h): For the 2-node periodic Toda ring (, , ), the Hamiltonian is: Identify the two commuting integrals and , verify , and construct the canonical transformation to center-of-mass and relative coordinates that separates the 4D phase space into two independent 1-DoF systems.
Problem 4.2: Small Divisors, Diophantine Numbers & Greene’s Golden KAM Threshold
Section titled “Problem 4.2: Small Divisors, Diophantine Numbers & Greene’s Golden KAM Threshold”Consider a 2-torus perturbation where and (so the twist matrix is on the isoenergetic slice).
-
The Homological Equation & Measure of Resonant Zones: For each integer pair with , the resonant ratio is surrounded by a Diophantine exclusion zone of width: Show that for and any exponent , the total Lebesgue measure of the union of all exclusion zones over all is bounded by , where . Conclude that as , the set of Diophantine numbers in has full Lebesgue measure despite having an empty interior!
-
Why the Golden Ratio Survives Longest (
chirikov.mdx,suzu::Rotor): Show that satisfies , so its continued-fraction expansion is with rational convergents given by the ratios of consecutive Fibonacci numbers . Verify that for all integers with : which is the largest possible asymptotic constant allowed by Hurwitz’s theorem ().
Problem 4.3: Arnol’d Tongue Generating Function & Pendulum Reduction at Resonance (arnold.mdx)
Section titled “Problem 4.3: Arnol’d Tongue Generating Function & Pendulum Reduction at Resonance (arnold.mdx)”-
Bijectivity Bound of
arnold_fs(the Arnol’d lock page): In Kessho’s Arnol’d Lock operator, the kick in polar action-angle coordinates is generated by the Type-2 generating function:- Derive the canonical relations and , and verify that they reproduce equations (23)–(24) of
arnold.mdx: - Show that for fixed , the angle map has derivative , so the map is strictly monotonic and globally invertible on whenever (explaining the shipped engine’s safety bound at line 34 of
arnold.mdx!).
- Derive the canonical relations and , and verify that they reproduce equations (23)–(24) of
-
Libration Frequency Inside a Resonant Island: Near a resonance () of the Arnol’d map at action where and the Lamb–Oseen twist has shear , linearize the -step deviation and resonant phase to show that the island’s elliptic fixed point sits at and small oscillations inside the island librate with frequency per -frame cycle.
midi-sink 2.0.0 · AGPL-3.0 · source
