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 ;

  • No labels