Hydro-DEM Engine
Calculates Flow Direction and Flow Accumulation on a terrain mesh to extract stream networks. Depressions are filled first (Priority-Flood) so streams run through hollows to the terrain edge; the hollows are reported as ponds.
Overview
Calculates Flow Direction and Flow Accumulation on a terrain mesh to extract stream networks.
Inputs (5)
- Terrain (Mesh): The base topography mesh
- Threshold (Integer): Minimum flow accumulation to form a stream
- Run (Boolean): Optional. False = skip the analysis and keep showing the last results (cached). Share one toggle with the Analysis Dashboard to switch everything on/off together.
- Fill Pits (Boolean): Fill depressions before routing (Priority-Flood, Barnes et al. 2014). False = old behaviour: flow stops in every hollow.
- Min Pond Depth (Number): Hollows shallower than this (m) are not reported as ponds (still routed through).
Outputs (8)
- Streams (Curve): Extracted stream networks (Polylines)
- Accumulation (Integer): Flow accumulation value per topology vertex
- Topology Points (Point): Topology vertices matching the accumulation list
- Info (Text): Component information and methodology
- Dashboard Data (Text): Unified JSON payload containing legend and key analysis metrics for the Analysis Dashboard
- Pond Depth (Number): Water depth per topology vertex when hollows fill up (0 = dry).
- Ponds (Mesh): Water surface of every pond at its spill level.
- Catchment (Integer): Catchment id per topology vertex: the outlet vertex its water leaves the terrain at.
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Graph: one node per mesh topology vertex, linked to its mesh neighbours.
- Outlets: vertices on the open edge of the mesh (water leaves the model there); a closed mesh drains at its lowest vertex.
- Depression filling (Priority-Flood): a flood grows inward from the outlets, lowest first; every vertex is raised to at least the level it was reached from, so each hollow fills to its spill level.
- Flow direction: steepest descent (drop / plan distance) on the filled surface; on flats and inside filled hollows a vertex drains to the vertex that flooded it, so every vertex reaches an outlet and there are no loops.
- Accumulation: one unit of rain per vertex, summed downstream; Streams follow vertices with accumulation at or above Threshold.
- Ponds: connected wet vertices (depth above Min Pond Depth) at one spill level; volume = depth × the vertex's share of the surrounding faces' plan area.
- Catchment: the outlet vertex each vertex drains to.
Assumptions
- Water leaves only at the mesh edge; hollows fill completely before they overflow (static spill level).
- Uniform rain per vertex, no infiltration, evaporation or storage in the soil.
- Use a regular mesh: accumulation counts vertices, so a denser area collects more.
Simplifications and limits
- Single flow direction per vertex (D8-style on mesh neighbours): no splitting of flow.
- Accumulation is a vertex count, not an area or a discharge.
- Pond volume is approximate (vertex area share); culverts, pipes and drains are not modelled.
- Fill Pits = false restores the old behaviour: flow stops in every hollow.
Workflow
- Terrain mesh (for example Site Fetch Terrain) -> Terrain. Streams -> Keypoint Engine. Ponds and Pond Depth show where water collects.
References
- Barnes R., Lehman C. and Mulla D. (2014), Priority-Flood: an optimal depression-filling and watershed-labeling algorithm for digital elevation models, Computers and Geosciences 62.
- O'Callaghan J.F. and Mark D.M. (1984), the extraction of drainage networks from digital elevation data (D8).