Skip to content

Vortex

A vortex at VV rotates every point around the centre by an angle that depends on its radius, θ(r)\theta(r); the inverse lookup rotates by −θ(r)-\theta(r). Because a rotation moves every point on a circle to another point on the same circle, the map is exactly area-preserving and can never fold, however large the angle. midi-sink ships two profiles.

θ(r)=A e−r/R\theta(r) = A\,e^{-r/R}

Shear concentrates near the centre and fades smoothly: diffuse, breath-like agitation. The default for the mod wheel, the Airwave dimensions and wind routing — “wind over the water”.

Exponential profile: A is the angle at the centre, R the e-folding radius. +A just off the top-left cluster, −A just off the bottom-right, ramped in n passes — off-centre on purpose: a rotation of circles about their own centre is invisible.open full size ↗
θ(r)={ωr<Rω R2r2r≥R\theta(r) = \begin{cases} \omega & r < R \\[4pt] \omega\,\dfrac{R^2}{r^2} & r \ge R \end{cases}

The core rotates rigidly — zero interior shear, so whatever pattern sits inside spins as a solid disk and survives intact — while all the shear lands in the crease ring at r=Rr = R (the kink is intentional) and the 1/r21/r^2 fall-off outside. Mechanical, tight: the gesture literally grabs a disk of water and turns it.

Rankine profile, ω and −ω, each just off its cluster: the piece of the rings inside R turns as one rigid body, intact; all the shear lives in the crease ring at R and the 1/r² tail outside.open full size ↗
  • Exact at any angle. A finite rotation never folds, so neither profile is ever sub-stepped. Two passes of A/2A/2 equal one pass of AA.
  • Area-preserving by construction.
  • Rankine’s interior is exactly zero-shear: a ring cluster inside RR comes out bitwise as it went in, rotated.
  • CC 1 (mod wheel), Airwave CC 20 (Raise) → global vortex strength, exponential profile, through the CC map; CC 21/22 drift its centre.
  • Two-finger twist (tablets, Marble mode) and right-drag (desktop) → Rankine, with RR = half the finger separation and ω\omega = the twist delta; the settings’ Vortex profile selects which profile the gesture uses.
  • Not pen orientation. Every attempt to stir a vortex from stylus tilt or azimuth leaked a phantom vortex (absolute orientation is noisy and has no zero) and was removed — orientation only ever feeds the vibrato booster, as a decaying derivative.

The exponential profile is the vortex of Mathematical Marbling (Lu, Jaffer, Jin, Zhao & Mao, 2012). Rankine’s combined vortex is from his Manual of Applied Mechanics (1858) — see the citations. The soft, viscous sibling of both is the Lamb–Oseen swirl.

midi-sink 2.0.0-rc.5 · AGPL-3.0 · source