Live source status
https://api.open-meteo.com/v1/forecast: 429 Too Many Requests
What is fetched
| Source | Used for | Kind | Cadence |
|---|---|---|---|
| NASA POWER / MERRA-2 monthly | 10-year rainfall, temperature, soil wetness, PET inputs | live | 24 h |
| NASA POWER / MERRA-2 daily | recent rain and soil at a hydrologic centroid | live | 6 h |
| Open-Meteo forecast | 16-day rain, ET0, temperature, humidity, wind; 92-day fire-weather baseline | live | 30 min |
| Open-Meteo GloFAS flood | 60-day past + 16-day forecast river discharge | live | 60 min |
| NASA EONET | open drought, flood, wildfire, dust and temperature events | live | 30 min |
| World Bank | population, renewable freshwater per capita, withdrawal, forest and arable land | reference | 7 days |
| Wikidata + Wikipedia sitelinks | global notable-dam inventory (names, coordinates, country, height, power) | reference | 30 days |
| Natural Earth 50m | country geometry for the map | reference | static |
| Mass-balance / screening model | reservoir storage, soil and index calculations | modeled | recomputed |
Refresh
The world layer is designed to be refreshed without a page being open. The UI also has a Refresh live data button that starts a single-flight background refresh.
python manage.py bootstrap_world # fetch + recompute + snapshot python manage.py bootstrap_world --offline # use cached/source files only python manage.py bootstrap_world --limit 10 # smoke run python manage.py load_dam_atlas --reset # rebuild the dam catalogue python manage.py dedupe_dams # merge duplicate monitored rows
For unattended operation, run python manage.py refresh_world --loop --interval 900 in a second terminal. The page polls /api/world/meta/ every 60 seconds and updates the map when the snapshot version changes.
Honesty rules
- Live is a successful fetch with a stored timestamp, not a label of intent.
- Cached is the last successful copy; the UI never calls it live.
- Modeled storage is a mass-balance/reference estimate, not SCADA telemetry.
- Proxy groundwater uses root-zone wetness when no aquifer inventory exists.
- Missing data is neutral with low confidence; it is never a hidden zero or a fake 50 in the score.
- Scenario values are simulated, tagged, and never overwrite an observed snapshot.
- “Not for operational decisions” appears in the footer and in the API language.
Coverage
The dam atlas is built from notable dams with an English Wikipedia article and a Wikidata coordinate, supplemented by curated public inventories. It is a catalogue, not a complete census. Country geometry covers 236 polygons and 13 point markers; boundaries are Natural Earth, not legal.
Attribution: NASA POWER / MERRA-2, Open-Meteo and GloFAS, NASA EONET, World Bank, Natural Earth, Wikidata and Wikipedia contributors, OpenStreetMap contributors, IBM Plex (SIL OFL), Leaflet (BSD-2-Clause).