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. Time series 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. 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. 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 described elsewhere. In
The file format
Please consult the full documentation and the xsd schema as this short sample of the format is incomplete.
| No Format |
|---|
<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 identicallocationId is defined by the data supplier. Delft-Fews
will map this to the ID in your Delft-Fews configuration an internal location if needed.
-->
<parameterId>H.obs</parameterId> <!-- Put the parameterId here.
the parameterIdis defined by the data supplier. Delft-Fews
Without ID mapping set up the ID should be identical
will map this to thean IDinternal inlocation your Delft-Fews configurationif 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>
</TimeSeries>
|
...