Presets
Playback
Parameters
Camera
Layers
Quality
Model check
The science
What is modelled
A garden pond with a school of koi. Each fish steers as a boid (separation, alignment, cohesion, a soft shoreline and a pull towards floating food) at a cruising speed that depends on water temperature. Its tail-beat frequency follows the Strouhal rule that cruising fish, dolphins and birds obey in nature: f = St U / A with St between 0.2 and 0.4. A travelling body wave bends the Blender-built fish from nose to tail (amplitude growing towards the tail). The tails stir the water; the surface is a 104 x 104 wave-equation field that also reacts to wind, rain and your clicks. Its curvature focuses sunlight into moving caustics on the pebbles, and Beer-Lambert absorption tints the koi and the bed with depth.
Equations
- Swimming kinematics:
y(s,t) = (A/2)(0.08 + 0.92 s²) sin(2πs/λ − 2πft), s = distance from the nose in body lengths, tail-tip peak-to-peak amplitude A = 0.2 L, Strouhal numberSt = fA/U. - Lighthill slip efficiency
η = (1 + U/V)/2with body-wave speedV = λf; the fish can only thrust while U < V. - Drag and power:
D = ½ρCfSU², S = 0.45 L²,Cf = 1.328/√Re(laminar, Re < 5×105) or0.074 Re-1/5, Re = UL/ν,P = DU/η; ν(T) from a fit to the viscosity of water. - Water surface:
∂²u/∂t² = c(x)²∇²u − γ∂u/∂twithc² = c0² d(x)/d0(shoaling: ripples slow down over the shallow rim); the bank damps the waves. Real surface waves are dispersive:ω² = (gk + σk³/ρ) tanh(kd), with a minimum phase speed of about 0.23 m/s at λ = 1.7 cm (graph 2). - Caustics: a vertical ray refracted by n = 1.333 lands at
X = x + d tan(θi − θt), so the irradiance on the bed isE = 1/(1 + d(1 − 1/n)∇²h) ≈ 1 − d(1 − 1/n)∇²h. - Light in water:
I(z) = I0 e−Kzwith K = 0.45, 0.07 and 0.03 per metre for red, green and blue in clean water, plus turbidity, so deep koi lose their reds first.
Simplifications
The wave equation is non-dispersive with an adjustable effective speed (a pond ripple of wavelength 30 cm really travels at about 0.7 m/s, a 1 cm ripple at 0.25 m/s); amplitudes are millimetres and are drawn with a visual gain so you can see them (the gain does not enter the physics or the checks). Caustics use the small-slope formula (it fails when rays cross, which real caustic lines do). Koi are steered boids with simple temperature scaling, not a metabolic model; the body wave is imposed rather than solved from fluid-structure interaction; the flat-plate friction law ignores form drag and the real shape of the koi. The Strouhal band is an empirical observation, not a derived law.
What to try
- Lower the temperature to 6 degrees C: the koi slow down, their tail beats drop and Re falls.
- Drag St towards 0.5 and watch the dots on graph 3 leave the efficient band.
- Set raindrops to 25 per second and turn the caustic gain up: the bed lights flicker.
- Raise turbidity to 1.2 and use the Underwater camera: reds fade quickly with depth.
- Choose "Drop a food pellet" and click: the nearest koi break from the school, speed up and eat it, leaving ring waves.