How DEM-based watershed delineation works
A watershed (catchment) is every piece of ground that drains through one outlet, the pour point. Automated delineation finds it from a digital elevation model (DEM) in five steps.
- Condition the DEM. Raw elevation data has pits: single cells lower than all their neighbours, usually noise, which would trap flow. Conditioning fills them, resolves flat areas and carves channels so that every cell has a downhill path to the sea or a genuine closed basin. MERIT-Hydro also removes the tree-canopy and building bias that radar DEMs carry.
- Assign a flow direction to every cell. The D8 method (Jenson and Domingue, 1988) sends each cell’s water to the one of its eight neighbours with the steepest drop.
- Accumulate flow. Each cell counts how many cells drain through it. Channels are the cells where that count is large.
- Snap the outlet. Your click is moved onto the nearest high-accumulation cell, because an outlet one cell off the channel traces a hillslope instead of the river.
- Trace upstream. Every cell whose flow path passes through the outlet is collected and its outline becomes the watershed boundary.
The D8 rule in step 2 is:
| Symbol | Meaning | Unit |
|---|---|---|
| Elevation of the cell being processed | m | |
| Elevation of neighbour (eight neighbours) | m | |
| Distance to neighbour : one cell width for the four sides, cell widths for the diagonals | m | |
| Drop per unit distance towards neighbour | m/m |
The Global Watersheds service that Studio calls for most of the world (Heberger, 2022) speeds this up for large basins: it unions precomputed MERIT-Basins unit catchments upstream and runs the raster trace only inside the unit catchment that holds your outlet. That split is what the precision setting controls.
Snapping the outlet: where most bad delineations start
A click “on” a stream is accurate to tens of metres at best. With the COP30 engine in South Africa, Studio looks up the COP30 channels within 120 m of your click and offers them, each labelled by the area already draining to it, its distance from the click and its stream order. Where several channels meet near the click, all of them are listed. Pick the one you are designing for and the outlet moves onto it, with the engine snap distance set to 0 m; or keep your point as placed. The outlet never moves without your choice. The Global Watersheds and USGS sources snap with their own fixed rules.
Confluences are the trap. An engine snaps to the highest flow accumulation within its snap distance, so near a junction it reaches across onto the bigger branch. Measured at one South African confluence, on a tributary whose true catchment is 57 km², clicks 15 m, 30 m, 50 m, 80 m and 150 m upstream of the junction all returned 114 km², which is the neighbouring river. The tributary only delineated as itself past 300 m. The answer looks plausible, which is why it gets into reports.
The COP30 engine lets you set its snap distance:
| Setting | Use when |
|---|---|
| 0 m | The outlet is a surveyed structure position and must be honoured exactly |
| 20–30 m | The outlet already sits on the channel you chose |
| 150 m (default) | The outlet was placed by eye, away from any confluence |
| Up to 500 m | The outlet is rough and the nearest channel is uncertain |
A larger snap distance is not safer. It is the setting that lets the engine cross a confluence.
Choosing a delineation source
| Source | Coverage | Terrain | Notes |
|---|---|---|---|
| Delta Hydro COP30 | South Africa | Copernicus GLO-30, 30 m, hydrologically corrected | Returns the longest-flowpath profile, elevation statistics and the downstream flowpath with the boundary |
| Global Watersheds | Land, 60°S to 85°N | MERIT-Hydro, about 90 m | The usual choice outside South Africa; high and low precision |
| Esri ArcGIS Watershed | Worldwide | HydroSHEDS | Independent cross-check |
| USGS StreamStats | United States | National datasets | Adds basin characteristics: impervious and forested percentage, mean annual precipitation, curve number |
| USGS NLDI | United States | NHDPlus network | Navigation on the national stream network |
US-only sources are disabled outside the US and COP30 is disabled outside South Africa. For a 1 km² culvert catchment in South Africa, COP30’s 30 m grid gives about nine times as many cells as MERIT-Hydro’s 90 m grid.
Worked example: six South African gauges
To check the engine against published areas, the Global Watersheds service was run on 8 October 2026 at the listed coordinates of six Department of Water and Sanitation (DWS) flow gauges, at both precision settings. The DWS catchment areas come from the station list used by the Stream Gauge Finder.
| Gauge | River | DWS area (km²) | High precision (km²) | Low precision (km²) |
|---|---|---|---|---|
| U2H006 | Karkloof @ Shafton | 339 | 337 | 387 |
| U2H013 | Mgeni @ Petrus Stroom | 299 | 295 | 300 |
| C5H007 | Renoster Spruit @ Shannon Valley | 348 | 338 | 343 |
| T5H004 | Mzimkulu @ FP 1609030 | 545 | 538 | 605 |
| K6H001 | Keurbooms @ M’Kama | 165 | 162 | 200 |
| G4H007 | Palmiet @ Welgemoed | 464 | 464 | 470 |
High precision landed within 3 % of every published area, and five of six within 2 %. Low precision overstated three of them by 11 % to 21 %, because it returns the whole unit catchment containing the outlet, including ground downstream of the gauge. Use high precision for anything you will size a structure from. Basins over 50 000 km² revert to low precision automatically.
What comes back
What a run returns depends on the source. Every source gives the boundary and area. Global Watersheds, USGS NLDI and COP30 also give a longest watercourse and a stream network (COP30 where the service returns its channels); Esri and StreamStats give the boundary only, and the Esri longest watercourse is traced afterwards from a headwater pin. Across the sources and the follow-up analyses, the result can hold:
- Area, perimeter and the snapped outlet coordinates, which can differ slightly from your click.
- Stream network with Strahler order (Strahler, 1957). Order 1 is a headwater stream; two order-1 streams make an order 2, and a lower order joining a higher one does not raise it. Each exported segment carries its order.
- Longest watercourse, the route from the most remote source to the outlet, with its length. Open it in Watercourse Profile for the long section and the 10-85, equal-area and Taylor-Schwarz slopes.
- Downstream flowpath from the outlet to the sea, with its length.
- Shape indices: maximum basin length, elongation ratio, form factor and circularity ratio, which indicate how fast runoff concentrates.
- Elevation statistics: minimum, maximum, mean, relief and mean slope of the catchment.
- Drainage density and stream frequency for South African catchments, measured on the 1:50 000 mapped channel network of the national topographic series.
Drainage density is total channel length divided by catchment area (Horton, 1932). The Studio documentation reads it as follows:
| Drainage density (km/km²) | Texture | Typical setting |
|---|---|---|
| < 0.5 | Coarse | Permeable substrate, low relief |
| 0.5–2.0 | Medium | Most South African catchments |
| 2.0–4.0 | Fine | Impermeable substrate, steeper relief, sparse vegetation |
| > 4.0 | Very fine | Badlands, highly dissected terrain |
Outside South Africa the value is left blank, never reported as zero: a missing measurement is not a catchment without channels.
Limitations and when to use something else
- Resolution. At about 90 m, MERIT-Hydro does not resolve catchments under roughly 1 km², narrow valleys or terraces. Use COP30 in South Africa or a local LiDAR DEM elsewhere.
- Flat terrain. On coastal plains, pans and deltas, D8 directions follow DEM noise. Check the result against imagery.
- Engineered drainage. Stormwater pipes, kerb inlets, canals and road cross-drainage are not in any DEM. In urban and peri-urban work, overlay the municipal stormwater layout and adjust the boundary by hand.
- Endorheic basins. Conditioning can force a closed basin to drain to the sea. Check known closed systems.
- Estuaries. The tidal channel on imagery may not match the flow grid. Move the outlet 100–500 m upstream to the freshwater channel.
- Service availability. Global Watersheds is an external service. If it is down, switch to the Esri source.
If you already have a catchment boundary from survey or another GIS, upload it as GeoJSON, KML, KMZ, a zipped Shapefile, GeoPackage or DXF instead of delineating.
What the full Studio tool adds
Watershed delineation is free with a Studio account. Results save to a project and export as GeoJSON, Shapefile or KML, as a Word or Excel report, and as a SWMM 5 input file with every assumed parameter listed for review. The catchment feeds straight into the next steps:
- Time of concentration and the Rational Method, using the longest flowpath length and slope.
- Stream Gauge Finder, searching for gauges inside the delineated boundary.
- Design Flood Estimation in South Africa, which delineates on the same 30 m terrain model before running its flood methods.
Common questions
How do I delineate a watershed from a point?
Is there a StreamStats alternative outside the United States?
How accurate is automated watershed delineation?
Why did my watershed come out twice the size I expected?
What DEM resolution do I need for a small catchment?
Can I export the watershed to GIS or SWMM?
snap_to_channel and delineate_watershed. The agent passes the inputs, the engine does the calculation, and the record is saved to your project for you to review.
References
- Yamazaki, D., Ikeshima, D., Sosa, J., Bates, P.D., Allen, G.H. and Pavelsky, T.M. (2019) MERIT Hydro: a high-resolution global hydrography map based on latest topography datasets. Water Resources Research, 55(6), 5053-5073.
- Heberger, M. (2022) Delineator: fast, accurate global watershed delineation using hybrid vector/raster methods. Zenodo, doi:10.5281/zenodo.7314287.
- Jenson, S.K. and Domingue, J.O. (1988) Extracting topographic structure from digital elevation data for geographic information system analysis. Photogrammetric Engineering and Remote Sensing, 54(11), 1593-1600.
- Strahler, A.N. (1957) Quantitative analysis of watershed geomorphology. Transactions, American Geophysical Union, 38(6), 913-920.
- Horton, R.E. (1932) Drainage-basin characteristics. Transactions, American Geophysical Union, 13(1), 350-361.
- Lehner, B., Verdin, K. and Jarvis, A. (2008) New global hydrography derived from spaceborne elevation data. Eos, Transactions American Geophysical Union, 89(10), 93-94.
- European Space Agency and Airbus (2022) Copernicus DEM GLO-30: Global 30 m Digital Elevation Model.
Last reviewed by the Delta Hydro engineering team.