Ingesting Streamflow Observations into HydroForecast Models
HydroForecast uses machine learning to generate accurate streamflow forecasts — and the more relevant data we can incorporate, the better the results. To help us fine-tune forecasts to your site, you can provide your own streamflow, inflow, and outflow observations for ongoing model assimilation.
We support several ways to submit your data described below, so you can choose the method that works best for your team.
1. Automate with our API — recommended, most common method
Best for: teams with automated systems or technical capacity to integrate directly who want a hands-off method
Send observations directly to HydroForecast via a simple JSON structure using our secure REST API. See our HydroForecast Put Observations API (V1) support doc for full details and setup instructions.
Why we recommend the API: Submitting data via API ensures the most seamless, automated integration. It reduces manual work, eliminates formatting issues, and allows us to rapidly incorporate your latest observations into the model — meaning faster improvements to your forecast accuracy.
2. Upload a CSV via the HydroForecast Dashboard
Best for: teams who prefer a UI-based option for data uploads
We have a brand new Dashboard feature that lets you upload your observation data as a CSV.
- Upload a CSV to your HydroForecast dashboard
- The CSV file will require the following columns:
- siteId: you can get this information from your site URL, (example: siteId=tallapoosa-heflin)
- Datetime: please combine date, time and timezone (example: 2025-03-21T12:00+09:00)
- Flow, inflow or outflow depending on which column(s) are defined for your site
- When submitting the csv you will be asked to select the units of the flow data from a dropdown of menu below the CSV Preview. Please ensure to select the correct units, as data submitted can be used in forecast generation.
- The CSV file will require the following columns:
- Submit updates on your own schedule
Contact us to enable this feature for your team.
We’re here to guide you through the setup process so you get the most accurate forecast possible. Don’t hesitate to reach out at team@hydroforecast.com with any questions.