Overview
Time series data represent data collected over a given period of time at a specific location. Time series files can contain both equidistant times series and non-equidistant series. Multiple time series can be stored in a single file. All time and date information is given in GMT unless otherwise stated. The default (and preferred) missing value definition is NaN.
A detailed description of the format is described elsewhere. In short these are XML files that can hold (scalar) time series data. Each series has a small header followed by a number of events. An event is defined by a date/time, a value and an (optional) quality flag.
The file format
Please consult the full documentation and the xsd schema as this short sample of the format is incomplete.
<TimeSeries xmlns="http://www.wldelft.nl/fews/PI"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_timeseries.xsd"
version="1.2">
<timeZone>0.0</timeZone>
<series>
<header>
<type>instantaneous</type>
<locationId>locA</locationId> <!-- Put the locationId here.
Without ID mapping set up the ID should be identical
to the ID in your Delft-Fews configuration -->
<parameterId>H.obs</parameterId> <!-- Put the parameterId here.
Without ID mapping set up the ID should be identical
to the ID in your Delft-Fews configuration -->
<timeStep unit="second" multiplier="3600"></timeStep>
<!-- start and end date/time are required! -->
<startDate date="2006-08-23" time="17:00:00"></startDate>
<endDate date="2006-08-24" time="00:00:00"></endDate>
<missVal>-8888.0</missVal>
<longName>Bobbio Trebbia</longName>
<units>m</units>
</header>
<event date="2006-08-23" time="17:00:00" value="8.66"></event>
<event date="2006-08-23" time="18:00:00" value="9.66"></event>
<event date="2006-08-23" time="19:00:00" value="8.66" flag="33"></event>
<event date="2006-08-23" time="20:00:00" value="-8888.0"></event>
<event date="2006-08-23" time="21:00:00" value="8888.0"></event>
<event date="2006-08-23" time="22:00:00" value="8888.0" flag="9"></event>
<event date="2006-08-23" time="23:00:00" value="8888.0" flag="99"></event>
<event date="2006-08-24" time="00:00:00" value="-8888.0" flag="33"></event>
</series>
</TimeSeries>
A layout of the schema that defines this format is shown below:
