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.

Site Analysis Nickname: HydroDEM

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

  1. Graph: one node per mesh topology vertex, linked to its mesh neighbours.
  2. Outlets: vertices on the open edge of the mesh (water leaves the model there); a closed mesh drains at its lowest vertex.
  3. 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.
  4. 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.
  5. Accumulation: one unit of rain per vertex, summed downstream; Streams follow vertices with accumulation at or above Threshold.
  6. 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.
  7. 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).