Overview
The Delft-Fews Published interface format (PI) consists of a number of xsd schemas defining a number of XML formats for the exchange of date. The timeseries format deals with (scalar) timeseries data.
Time series data represent data collected over a given period of time at a specific location. Within the PI XML format timeseries 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. 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. A missing value definition can be defined in the files. The default (and preferred) missing value definition is NaN.
As described in the timeseries XML schemas a single quality flag may be given. It is up to the data supplier to describe the meaning of the quality flags used. Delft-Fews will map these to internal flags on import.
A detailed description of all PI formats is can be found at http://public.deltares.nl/display/FEWSDOC/The+Delft-Fews+Published+interface+%28PI%29
. The latest versions of the schema files are always available at the Deltares website at: http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_timeseries.xsd
The file format
Please consult the full documentation (http://public.deltares.nl/display/FEWSDOC/The+Delft-Fews+Published+interface+%28PI%29) and the xsd schema fro more details.
<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.
the locationId is defined by the data supplier. Delft-Fews
will map this to an internal location if needed.
-->
<parameterId>H.obs</parameterId> <!-- Put the parameterId here.
the parameterIdis defined by the data supplier. Delft-Fews
will map this to an internal location if needed. -->
<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>
<series>
<header>
<type>instantaneous</type>
<locationId>locB</locationId> <!-- Put the locationId here.
the locationId is defined by the data supplier. Delft-Fews
will map this to an internal location if needed.
-->
<parameterId>H.obs</parameterId> <!-- Put the parameterId here.
the parameterIdis defined by the data supplier. Delft-Fews
will map this to an internal location if needed. -->
<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>-999.0</missVal>
<longName>Fitz</longName>
<units>m</units>
</header>
<event date="2006-08-23" time="17:00:00" value="2.66"></event>
<event date="2006-08-23" time="18:00:00" value="2.66"></event>
<event date="2006-08-23" time="19:00:00" value="2.66"></event>
<event date="2006-08-23" time="20:00:00" value="-2.0"></event>
<event date="2006-08-23" time="21:00:00" value="2.0"></event>
<event date="2006-08-23" time="22:00:00" value="2.0"></event>
<event date="2006-08-23" time="23:00:00" value="2.0"></event>
<event date="2006-08-24" time="00:00:00" value="-2.0"></event>
</series>
</TimeSeries>
A layout of the schema that defines this format is shown below: