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.
MapIdTmx.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>