Your network can have sensors in various locations, which capture flows, pressures, tank levels, pump/valve statuses, valve settings or even end user consumption.
You can feed this information into Qatium using our Ingest API (check this article to see how). By doing so, you’ll get a better understanding of your network behavior.
Using part of this information as an input to the model will increase its accuracy, which will come in handy when you start running scenarios.
Here’s what you need to know about how Qatium integrates your live data:
Asset variable validity and update frequency
Asset variables are updated through the Ingest API only if the data falls within the validity period established by Qatium.
Tank levels are used as input for the network only at the first timestep of the day: 00:00.
All other variables are propagated up to the end of the day, provided no asset control interferes with that value.
You can see which variables are updated and with what frequency in the table below:
| Asset variable | Asset Update Frequency |
| Pump Status | Every 15 min |
| Pump Speed | Every 15 min |
| Valve Status | Every 15 min |
| Valve Setting | Every 15 min |
| Tank Level | First time step of the day (e.g. 00:00), everyday |
| Junction Demands/Consumptions | Every pattern timestep /Every 15 min |
Important:
Pump and valve controls may reduce the validity period.
If the live data is available, the model will use them as initial state when running scenarios, like Demand Spike or Watermain Shutdown.
Values are assumed to be in the unit system of the model (the units of the data coming through the API are not taken into account).
Timestep assignment and missing data
In order to adjust or compare model performance with real data, Qatium maps the live data readings onto the matching hour step of the simulation. For example, readings from 15:00:00 to 15:59:59 will be assigned to hour timestep 15.
If there are several readings for the same asset and metric, the most recent reading will be selected.
If there is no data for a timestep, the comparison will be disabled for that point of time. In this case, Qatium will show the most recent valid data.
Tip from Q:
Want to find out more? Check out the Live Data Integration section
Ready to start running scenarios?