r/Hydrology • u/Pretty-Ad-2673 • 8h ago
I got tired of writing the same agency download script, so I put 62,560 gauges in a browser tab
Enable HLS to view with audio, or disable this notification
This started as a personal itch. I do hydrology research, and every study I've done began the same way: a week of writing download scripts before touching any science. One script for the US data, a different one for the UK, another for France, each portal with its own API, its own units, its own weird date column. At some point I realised I'd written basically the same script seven times for seven countries.
So over the past few months I built the thing I kept wishing existed: one map with every public gauge I could reach, about 62,000 across the US, Australia, the UK, France, Taiwan, Germany and Ireland. You click a gauge and get its record, a flood frequency curve with confidence bounds (GEV and Log-Pearson III, since someone will ask), flow duration and a trend test. Click anywhere that isn't a gauge and you get the climate and the upstream catchment of that spot instead.
The part I'm weirdly proud of: it all runs inside your browser tab. Actual Python, through Pyodide. I can't afford to run servers, so there's no server, and that means no account, no key, nothing to install for you either.
Rough edges, honestly: the flood analysis wants at least 10 full years of record, and if a gauge doesn't have that it just tells you no instead of fudging it. The German and Irish feeds only serve about a month of history. And the rainfall-runoff model isn't tuned for really big basins yet.
Try it: https://rekin226-aquascope-explorer.static.hf.space
Code is MIT, and it's the browser front end of a Python package you can pip install: https://github.com/Rekin226/aquascope
If your country's agency isn't on the map, tell me which one and I'll have a go at it.