3D Koi Pond

Koi schooling in a Blender-built garden pond: tail beats scaled by the Strouhal number, drag and swimming power, a wave-equation water surface, refraction caustics and light absorption with depth.

Switch to 2D

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 number St = fA/U.
  • Lighthill slip efficiency η = (1 + U/V)/2 with body-wave speed V = λ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) or 0.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/∂t with c² = 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 is E = 1/(1 + d(1 − 1/n)∇²h) ≈ 1 − d(1 − 1/n)∇²h.
  • Light in water: I(z) = I0 e−Kz with 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.
Loading model...
Loading Blender model...
Water surface along the pond centre line
Ripple phase speed vs wavelength
Tail-beat frequency vs speed (Strouhal)
Made with 🟠 Blender · Three.js