Frequency & data

Find stream gauge data near your site

The Stream Gauge Finder searches the Department of Water and Sanitation's 2 896 South African stations by distance from a point, inside a catchment or along a river, then filters them by station type, record length and status. Each result links to the station's verified data and its monthly and annual peak-flow files, and the annual peaks go straight into flood frequency analysis.

What the finder searches

The tool is open to every Studio account. A country picker sets which national network you search, and the search modes change with it:

CountryNetworkStationsSearch modesRecords linked
South AfricaDWS flow, reservoir and meteorological stations2 896Browse map, point, polygon, watercourse, saved watershedDWS station page, monthly peaks CSV, annual peaks CSV
United StatesUSGS NWIS stream gauges with peak-flow recordsNationwidePoint, upstream or downstream trace, polygon, watercourse, saved watershedNWIS annual peak-flow file with qualification codes
AustraliaBureau of Meteorology National Flood Gauge Network3 836Point, polygon, watercourse, saved watershedAnnual maxima of the daily discharge record from Water Data Online, by July–June water year

Not every DWS station measures river flow. The station list the tool carries breaks down like this:

Station typeCountUse for flood frequency
River1 297The primary target
Meteorological574No flow record
Canal313Regulated flow
Reservoir and Components261Stage; inflow only after a water balance
Closed Conduit214Pipe or tunnel flow
Downstream River Components150Below a dam; regulated
Eye (spring)70Groundwater emergence
Lake or Pan17Level monitoring

Catchment area is recorded for 1 615 of the 2 896 stations, about 56 %. A catchment-area filter therefore hides every station without one.

Search modes and filters

  • Point: the nearest gauges to a clicked point or typed coordinates, by great-circle distance, 1 to 50 results.
  • Polygon: upload a catchment boundary. Gauges inside it are listed first, then the nearest outside it to fill the count, with distances from the polygon centroid.
  • Watershed: the same search on a catchment saved from watershed delineation.
  • Watercourse: gauges within a buffer of an uploaded river line. Use 5–10 km for a major river and 1–3 km for a tributary, so the buffer catches the main stem without reaching a parallel river.
  • Trace (United States): follow the NHDPlus network upstream or downstream from a clicked river for a set distance.

Filters combine: station type, drainage region, catchment-area range, minimum record years, maximum distance, station name or number, and active only. A station counts as active when its last record is less than two years old. Record length is measured from the first to the last date, so it does not subtract gaps inside the record.

Worked example: a culvert site near Howick

A point search on a site at 29.47°S, 30.23°E in KwaZulu-Natal, run through the Studio search engine on the DWS station list (record lengths as at 8 October 2026), narrows like this:

Filter applied (30 km radius)Stations left
None25
Station type: River15
Minimum record: 30 years8
Active only7
StationPlaceDistance (km)Catchment (km²)Record (years)
U2H007Lions River (Mpofana River) @ Weltevreden8.535871.5
U2H006Karkloof River @ Shafton10.833972.1
U2H013Mgeni River @ Petrus Stroom13.929965.6
U2H011Msunduze River @ Henley Dam19.917668.2
U2H057Slang Spruit @ Pietermaritzburg21.54830.6
U2H058Msunduze River @ Masons Mill23.132730.7
U2H012Sterk River @ Groothoek25.643865.4

The active filter removed one station: U2H001, Mgeni River @ Howick, 2.1 km from the site with 44 years of record that ended in 1993. For a catchment of a few hundred square kilometres, U2H006, U2H007 and U2H013 each offer more than 65 years from catchments of similar size, and U2H001 is worth reading too despite its closure. The next step is to send the annual peaks from three or more of them to flood frequency analysis, where the regional consistency check tests whether they behave as one group.

Checking a peak record before you fit it

A station’s record length is not its sample size. Before sending peaks to a frequency analysis, open the annual peaks file and check three things.

  • Count the years that have a value. A 70-year station with a 15-year gap holds 55 annual maxima, and the frequency analysis should see 55.
  • Read the quality flags. A year with missing data may have missed the flood, so its maximum can understate the true annual peak. Treat it as a lower bound or leave it out.
  • Look for regulation. Compare the record against the construction dates of dams upstream. A record that spans a new dam is two different populations.

USGS peaks carry qualification codes that Studio reads on import and shows beside each value:

NWIS codeMeaning
1Maximum daily average, not an instantaneous peak
2Estimated
3Affected by dam failure
4Less than the indicated value
5Affected to an unknown degree by regulation or diversion
6Affected by regulation or diversion
7Historic peak, from outside the systematic record
8Actually greater than the indicated value
9Snowmelt, hurricane, ice-jam or debris-dam breakup
A, BYear, or month and day, of occurrence uncertain
CAffected by urbanisation, mining or channelisation
DBase discharge changed this year
EOnly the annual maximum is available

Codes 5, 6 and C mark a record that no longer describes a natural catchment. Code 7 matters most for Bulletin 17C, because a historic peak belongs in the historical-data input, not in the gauged series.

DWS station numbers and drainage regions

A DWS station number such as A2H019 reads as primary drainage region (A), secondary region (2), station type (H for flow, R for reservoir, M for meteorological) and sequence number (019). South Africa has 22 primary drainage regions, lettered A to X without I and O:

CodeRegionCodeRegion
ALimpopoNSondags
BOlifantsPBoesmans
CVaalQFish
DOrangeRNahoon/Keiskamma
EOlifants/DoornSGreat Kei
FBuffelsTMzimvubu/Umbashe
GBergUMvoti/Mgeni/Mkomazi
HBreedeVTugela
JGouritzWUsutu/Phongolo/Mfolozi
KCoastal RiversXSabie/Krokodil/Komati
LGamtoos
MSwartkops

Limitations

  • Gaps. DWS records are not always continuous, so the record length shown can overstate the number of usable annual maxima. Open the annual peaks file and count.
  • Rating-curve extrapolation. The largest recorded floods are often computed from stages above the highest gauged flow, which makes the peaks that matter most the least certain.
  • Change over time. Dams, abstractions, transfers and land-use change can make an old record unrepresentative. A trend test in flood frequency analysis flags the obvious cases; local knowledge catches the rest.
  • Coverage. The tool covers South Africa, the United States and Australia. Elsewhere, go to the national hydrological service directly.

From gauge to design flood

Each station row has Send to FFA, which opens a flood frequency analysis with the annual peaks loaded and their metadata kept: gauge height, the agency’s qualification codes and catchment area. USGS peaks coded as historic peaks are moved into the historical-data panel for a Bulletin 17C analysis. Select three or more stations and send them together for a regional consistency check. Results save to a project and export as a CSV station list or a Word or Excel report.

Where no usable gauge exists, the regional methods take over. The index flood method was calibrated on 383 DWS records of at least 20 years (Calitz and Smithers, 2020), the quantile regression technique gives an independent regional estimate, and daily rainfall statistics supplies the rainfall side for a rainfall-runoff cross-check.

FAQ

Common questions

Where can I find stream gauge data in South Africa?
The Department of Water and Sanitation publishes verified flow records for its gauging stations on its Hydrology website, including pre-packaged monthly and annual peak-flow CSV files. The Stream Gauge Finder holds the full DWS station list with coordinates, catchment areas and record dates, so you can find the relevant stations on a map and open those files without browsing the DWS site station by station.
How do I read a DWS station number such as A2H019?
The first letter is the primary drainage region, here A for the Limpopo. The digit is the secondary drainage region within it. The next letter is the station type: H for a flow station, R for a reservoir and M for a meteorological station. The last three digits are a sequence number, so A2H019 is flow station 19 in secondary region A2.
How many years of record do I need for flood frequency analysis?
Longer is always better, because every quantile beyond the record is an extrapolation. The Studio flood frequency documentation treats 25 to 30 years as the practical minimum for a 1:100-year estimate. Calitz and Smithers screened South African stations at a minimum of 20 years before using them in regional analysis. Short records are better used in a regional method than on their own.
Should I use a gauge that has closed?
Often, yes. A gauge that ran for 40 years and closed in the 1990s still holds 40 annual maxima, which may be worth more than ten years from a newer station next door. Clear the active-only filter to see closed stations, then check whether a dam, transfer scheme or land-use change since the closure makes the old record unrepresentative of today's catchment.
Can the tool find USGS or Australian gauges?
Yes. Its country picker switches between DWS stations in South Africa, USGS NWIS gauges in the United States and the Bureau of Meteorology flood gauge network of about 3 800 stations in Australia. US searches add an upstream or downstream trace along the NHDPlus stream network, and annual peaks from all three agencies can be sent to flood frequency analysis.
Full documentation: Stream Gauge Finder
Every input, option and equation in the Studio tool, with its limitations.
Run it from your AI agent
This engine is open to Claude, ChatGPT, Cursor and other MCP clients as search_stream_gauges. The agent passes the inputs, the engine does the calculation, and the record is saved to your project for you to review.

References

  1. Department of Water and Sanitation (DWS). Hydrology: Verified Data. Government of the Republic of South Africa, Pretoria.
  2. U.S. Geological Survey. National Water Information System (NWIS): peak streamflow data. USGS, Reston, Virginia.
  3. Bureau of Meteorology. Water Data Online and the National Flood Gauge Network. Commonwealth of Australia.
  4. World Meteorological Organization (2009) Guide to Hydrological Practices, Volume II: Management of Water Resources and Application of Hydrological Practices, 6th ed. WMO-No. 168, Geneva.
  5. Calitz, J.P. and Smithers, J.C. (2020) Development and Assessment of Regionalised Approaches to Design Flood Estimation in South Africa. WRC Report No. 2748/1/20, Water Research Commission, Pretoria.
  6. England, J.F., Cohn, T.A., Faber, B.A., Stedinger, J.R., Thomas, W.O., Veilleux, A.G., Kiang, J.E. and Mason, R.R. (2019) Guidelines for Determining Flood Flow Frequency, Bulletin 17C. U.S. Geological Survey Techniques and Methods, Book 4, Chapter B5.

Last reviewed by the Delta Hydro engineering team.

Keep the whole study in one place

Delta Hydro Studio puts this tool alongside catchment, rainfall, runoff and hydraulics tools, with projects, team sharing and Word and Excel reports. Run them by hand, or let your AI agent run them for you to review.