Overview

The GrdcTimeSeriesSerializer class can export any number of timeSeriesSet's but the following restrictions apply due to the nature of the GRDC Near Real-Time Data Format Version 3.0:

  • for each locationId it expects exactly one timeSeriesSet wit parameterId='Water Level' and exactly one timeSeriesSet with parameterId='Discharge'. When not configured properly, an exception will be thrown.
  • the GRDC format enforces a specific file naming convention. This should be configured properly. When this convention is violated, a warning is given, but no exception is thrown.

The following flags are set statically, because they are not stored in FEWS:

  • is value directly determined' is always false
  • aggregation interval and offset are always 0
  • is ice cover' is always false
  • is ice jam' is always false
  • is weedage' is always false
  • is influenced by backwater' is always false

Configuration (Example)

A complete export module configuration consists of an ID Mapping file and a Export Module Instance file.

ModuleConfigFiles

ExportGRDC.xml
<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesExportRun ......">
<export>
	<general>
		<exportType>grdc</exportType>
		<folder>$EXPORT_EFAS_FOLDER$</folder>
	    	<exportFileName>
			<name>-3.0.nrt</name>
			<prefix>
			    <currentTimeFormattingString>'NL-1008-'yyyyMMddHHmmss</currentTimeFormattingString>
			</prefix>
	    	</exportFileName>
	    	<validate>false</validate>
		<idMapId>IdExportEFAS</idMapId>
		<exportTimeZone>
			<timeZoneName>GMT</timeZoneName>
		</exportTimeZone>
	</general>
	<timeSeriesSet>
		<moduleInstanceId>ImportMSW</moduleInstanceId>
		<valueType>scalar</valueType>
		<parameterId>H.m</parameterId>
		<locationId>H-MS-BORD</locationId>
		<timeSeriesType>external historical</timeSeriesType>
		<timeStep unit="hour" multiplier="1"/>
		<relativeViewPeriod unit="hour" start="-192" end="0"/>
		<readWriteMode>read only</readWriteMode>
	</timeSeriesSet>
</export>
</timeSeriesExportRun>

IdMapFiles

Defines mappings between FEWS parameters and locations and the expected GRDC locations and parameters.

MapIdExportGRDC.xml
<?xml version="1.0" encoding="UTF-8"?>
<idMap xmlns=".......">
	<!---->
	<parameter internal="Q.m" external="Discharge"/>
	<parameter internal="H.m" external="Water Level"/>
	<!---->
	<location internal="H-MS-BORD" external="BORGHAREN"/>
	<location internal="H-RN-0001" external="LOBITH"/>
</idMap>
  • No labels

Disclaimer