Technical documentation

The two water simulations: how much water arrives, and how fast

Two readings of the same system: the dose that reaches the ground and the speed at which it arrives. What each one shows, how to read the colour map, and what changes when you change soil, planting or nozzle.

November 18, 2026

Why two simulations and not one

An irrigation system can fail in two completely different ways, and the two failures are not visible with the same instrument:

  • Getting the amount wrong. An area receives less water than the plant consumes and turns yellow. Or it receives too much, and the excess ends up below the roots, where it is no use to anyone.
  • Getting the rate wrong. The total amount is right, but it arrives faster than the soil can absorb it. Water stays on the surface, puddles and runs off: the correct dose was delivered, but much of it never entered the soil.

These are independent properties. A system can be perfect on dose and disastrous on rate, or the other way round. That is why SprinklerMap has not one simulation but two: Water Coverage answers the first question, Runoff Risk the second.

One calculation grid, two readings

The two simulations are not separate models that could contradict each other. Both start from the same calculation grid: the garden is divided into cells, and for each cell a single physical quantity is computed — the application rate, how many millimetres of water per hour reach that point while the sprinklers are running, summing the contribution of every sprinkler that reaches it.

From that one number, per cell, both maps follow:

  • Water Coverage multiplies it by the irrigation runtime to get the dose in millimetres, and compares that with the estimated need of the planting.
  • Runoff Risk compares it with the soil's infiltration rate and works out how much water is left on the surface.

The practical consequence: the two maps cannot say incompatible things about the same system, because the same numbers sit underneath them. The Areas panel — runtime, flow, application rate, number of cycles — reads the same grid.

Cells with no water are shown, not hidden: an area no sprinkler reaches stays grey on both maps. It is the easiest mistake to miss when looking only at the drawn coverage arcs.

Water Coverage: the amount of water against the need

Water Coverage shows how the dose builds up over time — the animation is elapsed time — and colours each area by the ratio between the water received and what the planting needs.

How to read the scale

ColourDose receivedMeaning
GreyNoneDry area: no sprinkler reaches it
Red / orangeBelow 90% of the needToo little water: the planting goes into stress
GreenBetween 90% and 140%On target: this is the band to aim for
Yellow / brownAbove 140%Too much water: waste and percolation below the roots

The green band is a range, not a single value: from 90% to 140% of the need. Demanding exactly 100% everywhere makes no sense — no real system distributes perfectly evenly, and a moderate excess margin is normal design tolerance.

On the test garden (English lawn, full sun, loam soil) the estimated need is 5.0 mm per day, met by a 30-minute cycle with a system flow of 21.9 L/min.

Water Coverage on the test garden: green where the dose is on target, grey in the areas no sprinkler reaches. A 30-minute cycle for a 5.0 mm need.
Water Coverage on the test garden: green where the dose is on target, grey in the areas no sprinkler reaches. A 30-minute cycle for a 5.0 mm need.

Runoff Risk: the rate against soil absorption

Runoff Risk answers a different question: can the soil keep up with the spray? It compares the water left on the surface with what the soil can hold before it starts running off.

The model, in full

Every soil type has two agronomic parameters: the infiltration rate (how many mm/h it can absorb) and the surface storage (how many mm it can hold on the surface without running off). Water beyond the infiltration rate accumulates:

excess [mm] = (application rate − infiltration) × minutes / 60

As long as the excess stays below surface storage, the water has time to soak in and nothing happens. Once it exceeds it, runoff begins.

On the test garden: the measured application rate is 13.7 mm/h, and the infiltration rate of loam soil is 25 mm/h. The rate is lower than infiltration, so the excess is zero: the panel reports 0.0 mm left on the surface of the 5 the soil can hold. The map is green almost everywhere.

Runoff Risk on the same layout and the same loam soil: green wherever the water soaks in, with a few red spots where throws overlap and local rate rises above the average.
Runoff Risk on the same layout and the same loam soil: green wherever the water soaks in, with a few red spots where throws overlap and local rate rises above the average.

The red that still appears in places is exactly why the map is needed and the panel average is not enough: average rate is not local rate. Where two or three throws overlap, that cell receives the sum of the contributions and can exceed infiltration even when the garden average looks comfortable.

What changes when you change the soil

Soil type is set in the Areas panel and touches neither the sprinklers nor their layout: it only changes how fast the ground absorbs. These are the three values the app uses:

SoilInfiltrationSurface storageBehaviour
Sandy50 mm/h8 mmAbsorbs fast: runoff is rare, the risk is deep percolation instead
Loam25 mm/h5 mmMiddle ground, the default
Clay12 mm/h3 mmAbsorbs slowly: this is where runoff becomes a real problem
Clay soil: same sprinklers, same dose, but infiltration drops to 12 mm/h.
Clay soil: same sprinklers, same dose, but infiltration drops to 12 mm/h.
Sandy soil: at 50 mm/h of infiltration the water soaks in faster than it arrives.
Sandy soil: at 50 mm/h of infiltration the water soaks in faster than it arrives.

Clay soil: look at the map, not just the average

Switching to clay, the panel on the test garden still proposes one 30-minute run. With an average intensity of 13.7 mm/h against an infiltration of 12 mm/h, one run leaves (13.7 − 12) × 30 / 60 ≈ 0.85 mm of excess, below the 3 mm surface storage: on average there is no need to split.

The map, however, turns red where two or three streams overlap: there the local intensity is well above the average, which is exactly what the panel's single number cannot show. Those areas are fixed by reducing the overlap, with low-intensity nozzles, or by splitting the irrigation anyway into several runs with a pause in between (cycle and soak). When the average excess itself exceeds the storage, for example with spray nozzles on clay, the panel proposes several cycles on its own; if even that cannot get below the threshold, the app leaves the risk warning on rather than pretending an impractical schedule solves the problem.

What changes when you change the planting

Planting does not affect runoff: it changes the need, that is, the target Water Coverage uses to decide which green counts as "on target".

On the same garden with the same 6 sprinklers, switching from English lawn to shrubs and hedging drops the estimated need from 5.0 to 3.0 mm per day, and with it the irrigation runtime from 30 to 18 minutes. Areas that were just below target now fall inside it, because the target has come down.

Water Coverage with planting set to shrubs and hedging: 3.0 mm need instead of 5.0, a 18-minute cycle instead of 30.
Water Coverage with planting set to shrubs and hedging: 3.0 mm need instead of 5.0, a 18-minute cycle instead of 30.

This is the practical reason lawn and shrubs should not share a circuit: they have different targets, and a single runtime cannot hit both. Whatever needs less water ends up watered for as long as whatever needs more.

The Areas panel: planting, exposure, soil type and pressure. These are the values that move both simulations.
The Areas panel: planting, exposure, soil type and pressure. These are the values that move both simulations.

What changes when you change the nozzle type

The last variable is the most underestimated, and it is not in the Areas panel but in the sprinkler list: the nozzle type. A spray discharges all its water in a fixed fan; a rotator spreads it with rotating streams. For the same wetted area, a spray applies far more water per unit of time.

Direct test: same garden, same 6 sprinklers, same positions, same loam soil. Only the nozzle changes, from rotator to spray.

The irrigation runtime collapses from 30 to 12.0 minutes — sprays deliver the same dose in less than half the time. But the runoff map gets worse: a wide yellow band near the limit appears, and the orange and red areas grow compared with rotators.

With rotator nozzles: 30 minutes of irrigation, map almost entirely green.
With rotator nozzles: 30 minutes of irrigation, map almost entirely green.
With spray nozzles: 12.0 minutes for the same dose, but runoff risk spreads across much of the lawn.
With spray nozzles: 12.0 minutes for the same dose, but runoff risk spreads across much of the lawn.

The point is that the same amount of water, delivered faster, is not the same thing. Water Coverage would see the two systems as nearly identical — the dose is the same — while Runoff Risk tells them apart immediately. It is the clearest example of why you need to look at both.

On slow soils, nozzle choice therefore matters as much as layout: with a clay soil at 12 mm/h, a spray-based system almost certainly has to be split into several runs.

How to read the two simulations together

The order that works is this:

  1. Grey areas first. On both maps grey means "no water". If there are grey areas inside the lawn, the problem is placement and must be fixed there, before looking at anything else.
  2. Then Water Coverage. Look for widespread green. Red flags areas that will yellow, yellow/brown flags areas where you are wasting water. Fix by moving sprinklers, changing radius or separating hydrozones.
  3. Finally Runoff Risk. If orange and red appear, the dose is right but arrives too fast. Fix by splitting the irrigation into several runs, moving to low-rate nozzles, or reducing overlap where throws add up.
  4. Re-read Water Coverage after touching the sprinklers, because every change to the layout also changes the dose.

A system that is ready is green on both maps. Green on only one is not enough.

Stated limits of the simulations

  • They do not simulate wind. The distribution model is radial: wind distorts the real throw and moves water, and that effect is not represented.
  • They do not account for slope. On ground steeper than 15% surface water runs downhill instead of spreading, and runoff risk is underestimated.
  • Soil parameters are typical values for the three classes (sandy, loam, clay). Real soil may be compacted, have an impermeable layer or already be saturated from recent rain — all conditions that reduce effective infiltration.
  • The need is a seasonal estimate based on planting and exposure, not a real-time measurement. A controller fed with weather data will always be more precise than any a priori estimate.
  • The simulation shows a single run, not the whole irrigation season.

Formulas, parameter sources and the tool's general limits are collected in the calculation methodology. To understand where the sprinkler layout you are simulating comes from: how automatic placement works →

Frequently asked questions

Why are there two simulations (Water Coverage and Runoff Risk) instead of one?

Because a system can fail in two independent ways. Getting the amount wrong: a zone gets less water than the planting consumes and turns yellow, or too much and the excess ends up below the roots. Getting the speed wrong: the total amount is right, but it arrives faster than the soil can absorb it, so it stays on the surface and runs off instead of soaking in. A system can be perfect on dose and disastrous on speed, or the other way round — that's why two maps are needed, not one. Both still start from the same calculation grid (the same application intensity per cell), so they can never contradict each other on the same system.

What changes in the simulation if the soil is clay instead of loam?

Clay soil absorbs much more slowly (12 mm/h against 25 for loam), so the Runoff Risk map gets worse for the same sprinklers and dose. On the test garden the average intensity (13.7 mm/h) stays just above infiltration and the panel still proposes a single 30-minute run, but the map turns red where the streams overlap. When the average excess of one run exceeds the soil's surface storage (3 mm), the panel splits the irrigation into several cycles with pauses (cycle and soak): the same total water, with time for the soil to absorb it between cycles.

What changes if I use spray nozzles instead of rotators?

For the same delivered dose, spray heads apply water much faster than rotators: on the same garden and the same loam soil, the irrigation run drops from 30 to 12.0 minutes, but the runoff map gets worse, with a wide yellow band near the limit and larger orange and red zones than with rotators. Water Coverage would see the two systems as nearly identical (the final dose is the same), while Runoff Risk tells them apart immediately — the clearest example of why both simulations are needed together, not just one. On slow soils like clay, nozzle choice therefore matters as much as sprinkler layout.