Skip to content

Hydraulic Erosion ​

Simulate simulate.hydraulic

Rivers carve branching valleys over geological time and drop their sediment where they slow down. Strength limits where it acts; hardness resists wear. Water leaves at the world's edges.

Hydraulic Erosion with default settings

Output with default settings, rendered by LibreTerrain.

Inputs ​

PortType
TerrainHeightfield
StrengthMaskOptional
Rock hardnessMaskOptional

Outputs ​

PortType
HeightHeightfield
FlowMask
WearMask
DepositionMask
SedimentMask

Settings ​

SettingDefaultRange / optionsDescription
Duration1,000 kyr0 to 5,000 kyrTime simulated, in thousands of years. Zero leaves the terrain unchanged.
Rainfall1 m/yr0 to 10 m/yrYearly rainfall. More rain makes bigger rivers that cut faster.
Rock softness0.50 to 1How easily rivers wear the rock; multiplied by 1 - hardness.
Sediment capacity1.50 to 10How much sediment a river can carry, relative to what it erodes. Lower values leave more sediment in valleys.
Deposition0.50 to 1Share of the excess sediment that settles per 100 m of flow. 0 = never settles.
Evaporation0.020 to 1Share of the water lost per kilometre it flows.
Downcutting10 to 4Multiplier on river erosion. Zero stops new wear.
Detail size8 m1 to 1,000 mCell size the rivers are simulated at, in metres: about the width of the smallest valleys. Smaller is slower. The result is the same at any preview or build resolution.
Hillslope creep0.002 m²/yr0 to 1 m²/yrSoil creep that rounds hillslopes and smooths small rills between rivers.

Notes ​

Hydraulic Erosion is usually the slowest node in a graph. Keep the preview resolution low while you tune it; because every setting is in metres and years, the full-resolution build gives the same landforms with more detail.

A common chain is Hydraulic Erosion → Thermal Erosion: water carves the valleys, then thermal erosion adds scree below steep faces. The bundled Scottish Highlands example uses exactly this.

See also ​

Lakes · Rivers · Sea · Snow · Thermal Erosion

Code dual-licensed MIT / Apache-2.0. "LibreTerrain" and its logo belong to EllisonDigital.