Aquarium: nitrogen cycle, oxygen and fish survival

A Blender-built home tank where ammonia, nitrite, nitrate and oxygen decide how many fish live.

Switch to 2D

Presets

Playback

Fish, water and filter

Camera

Layers

Quality

Model check

The science

What you are looking at

A 200 L home aquarium modelled in Blender (cabinet, glass tank, gravel, rocks, wood, three plant types, filter, heater, three fish species). The fish, bubbles and water colour are driven live by a well-mixed nitrogen-cycle model, so you can watch a new tank go through its ammonia and nitrite spikes and see what overstocking, heat, high pH or a missing filter does to the fish.

The model

Fish feed produces ammonia: P = feed × 0.40 protein × 0.144 g total ammonia nitrogen (TAN) per g of feed (Timmons & Ebeling). Two nitrifier groups follow Monod kinetics, r1 = q1B1·TAN/(K1+TAN) (ammonia to nitrite) and r2 = q2B2·NO2/(K2+NO2) (nitrite to nitrate), with biomass growth dB/dt = Y r − bB, a 1.07T−20 temperature factor and a pH factor that slows nitrification below pH 7. Nitrate accumulates until water changes or plants remove it. Oxygen: dO/dt = kLa (Osat(T) − O) − fish respiration (allometric, Q10 = 2) − 4.57 r1 − 1.14 r2. Only the un-ionised share of ammonia is toxic: NH3/TAN = 1/(1+10pKa−pH), pKa = 0.09018 + 2729.92/T (Emerson et al.). Fish die with a hazard rate that grows steeply with NH3, nitrite and low oxygen.

Honest simplifications

One well-mixed box; nitrifiers live only in the filter and their constants (growth rates, yields, pH factor) are rounded textbook-style values, not fitted to a real tank. Plant uptake is first order. Toxicity scales (NH3 level at which half the fish die per day) are illustrative numbers per species, not measured LC50 values, and fish do not grow. Water changes are instant, fresh water holds no nitrogen. The fish swimming behaviour, the cloudy/green water tint and the bubbles are visual only.

Checks on this page

(1) Closed form TAN = P t/V without bacteria, plus RK4 step halving. (2) Nitrogen mass balance. (3) Literature values for oxygen saturation and the ammonia fraction. (4) The drawn fish count equals the model's survivors and no fish leaves the tank.

Loading model...
Loading Blender model...
Ammonia, nitrite and nitrate
Toxic un-ionised ammonia
Dissolved oxygen
Nitrifying bacteria and fish alive
Made with 🟠 Blender · Three.js