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 data. 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 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
When the time zone is not present in the PI file the default timezone configured in the general adapter or import module is used. The time zone is always written to the pi time series file when exported from FEWS.
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 for 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:
