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: