Overview
The HVZ-LILA import function (<importType>HVZ-LILA</importType>) imports grid time series from a text file format. The text file contains a meta data part and a content part.
The following meta data attributes are are used by the importer:
Zeitzone: timezone
Datenart: external parameter id
Datenursprung: qualifier
Stationsnummer: external location id
- Vorhersagezeitpunks: external forecast time
After reading the meta data all timeSeries times and values are read.
Times are set in the dd.MM.yyyy HH:ss format.
Missing values are determined by "-" values.
Alle lines starting with a # are considered comments and will be skipped by the importer.
Configuring the Import
To make the importer known to FEWS, the import module has to be declared in the moduleInstanceDescriptors.xml in the RegionConfigFiles directory of the FEWS configuration:
<?xml version="1.0" encoding="UTF-8"?> <moduleInstanceDescriptors xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/moduleInstanceDescriptors.xsd" version="1.0"> ... <moduleInstanceDescriptor id="ImportHVZ-LILA"> <moduleId>TimeSeriesImportRun</moduleId> </moduleInstanceDescriptor> ... </moduleInstanceDescriptors>
An example of the import (filename: ImportHVZ-LILA.xml) configuration will be given here. The importType is named HVZ-LILA which should be configured in the general section of the import.
<?xml version="1.0" encoding="UTF-8"?> <timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd"> <import> <general> <importType>HVZ-LILA</importType> <folder>$IMPORT_FOLDER$/lila</folder> </general> <timeSeriesSet> <moduleInstanceId>ImportHVZ-LILA</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q</parameterId> <locationId>213</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="minute" multiplier="15"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import> </timeSeriesImportRun>
An example of the HVZ-LILA format is as follows:
Station;Gießen; Gewaesser;Argen; Betreiber;RP Tübingen; Datenart;Q; Datentyp;M; Status; ; Pruefvermerk;U; Datenursprung;mes; Zeitzone;UTC+1; Zeitintervall;00:15; Vorhersagezeitpunkt;29.09.2015 05:00; Dimension;cbm/s; X-Koordinate;3544878.0; Y-Koordinate;5276797.0; Stationsnummer;213; 23.01.2015 16:00; 17.98 ; 23.01.2015 16:15; 17.98 ; 23.01.2015 16:30; 17.98 ; 23.01.2015 16:45; 18.04 ; 23.01.2015 17:00; 18.04 ; 23.01.2015 17:15; 18.04 ; 23.01.2015 17:30; 18.04 ; 23.01.2015 17:45; 17.98 ; 23.01.2015 18:00; 18.04 ; 23.01.2015 18:15; 18.04 ; 23.01.2015 18:30; 17.98 ; 23.01.2015 18:45; 17.92 ;