Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

See http://www.knmi.nl/datacentrum/catalogus/catalogus/content/nl-ecm-eps-waqua-skewsurge-nsea-info.htm and http://www.knmi.nl/datacentrum/catalogus/catalogus/content/nl-ecm-eps-waqua-skewsurge-nsea.htm.

The following data will be read by the importer:

  • An astronomical tide timeSeries for the defined timesteps. The location is based on the header (06514 in the following example). The parameter is based on the first column of the values (054003 in the following example)
  • A deterministic skew surge forecast timeSeries for the defined timesteps. The location is based on the header (06514 in the following example). The parameter is based on the first column of the values (054004 in the following example). To differentiate the deterministic forecast with the control forecast, a qualifier is used: "0010920".
  • A control skew surge forecast timeSeries for the defined timesteps. The location is based on the header (06514 in the following example). The parameter is based on the first column of the values (054004 in the following example). To differentiate the deterministic forecast with the control forecast, a qualifier is used: "0010921".
  • Ensembles with skew surge forecast timeSeries for the defined timesteps. The location is based on the header (06514 in the following example). The parameter is based on the first column of the values (054004 in the following example). To differentiate the deterministic forecast with the control forecast, a qualifier is used: "0010921". Ensembles are marked with an ensembleId (001091 in the following example) and an ensemble member index (1 .. 50).
  • Timesteps are determined by the times specified with the Astronomical tide. Times are given in HHH:mm format.

Annotated Example

The following is an annotated example of the Wmo Bufr Ascii format:

Code Block
xml
xml
Header
06514 2008102300   52.00    4.12 52 38

Astronomical tide
004025  +003:45 +009:06 +014:15 ⋅⋅⋅ +224:35 +231:35
054003   -36     +75     -53    ⋅⋅⋅  -50    +136

Deterministic forecast
001092  0
054004    -9  -19  -19  ⋅⋅⋅  -22  -18

Control forecast
001092  1
054004   -10  -18  -20  ⋅⋅⋅   +6   +5

50 perturbed forecasts
001091  1
054004    -9  -18  -20  ⋅⋅⋅  +11   +6
001091  2
054004   -10  -18  -22  ⋅⋅⋅  -29  -32
⋅⋅⋅
001091 49
054004   -10  -17  -17  ⋅⋅⋅  -15  -16
001091 50
054004    -9  -18  -22  ⋅⋅⋅  +66  +63

 

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:

Code Block
xml
xml
<?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="WmoBufrAsciiImportWmoBufrAscii">
		<moduleId>TimeSeriesImportRun</moduleId>
	</moduleInstanceDescriptor>
...
</moduleInstanceDescriptors>

An example of the WmoBufrAscii import (filename: ImportWmoBufrAscii.xml) configuration will be given here. The importType is named WmoBufrAscii which should be configured in the general section of the import.

Code Block
xml
xml
<?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 fews
	http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd">
	    <import>
		<general>
			        <general>
            <importType>WmoBufrAscii</importType>
			<folder>$IMPORT_FOLDER$/anna</folder>
			<idMapId>wmoBufrAsciiMapId</idMapId>
		</general>
		<timeSeriesSet>
			<moduleInstanceId>ImportWmoBufrAscii</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>H.observed</parameterId>
			<locationId>06514</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="hour" multiplier="1"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</import>
            <folder>$IMPORT_FOLDER_EPS$</folder>
            <idMapId>BUFR_dcsmv5eps_import</idMapId>
            <unitConversionsId>ImportUnitConversions</unitConversionsId>
            <importTimeZone>
                <timeZoneOffset>+00:00</timeZoneOffset>
            </importTimeZone>
        </general>
        <timeSeriesSet>
            <moduleInstanceId>DIM_dcsmv5eps</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>H.voorspeld.astro</parameterId>
            <locationSetId>KNMI_EPS</locationSetId>
            <timeSeriesType>external forecasting</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <readWriteMode>add originals</readWriteMode>
        </timeSeriesSet>
        <timeSeriesSet>
            <moduleInstanceId>DIM_dcsmv5eps</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>H.opzet.voorspeld</parameterId>
            <qualifierId>0010920</qualifierId>
            <locationSetId>KNMI_EPS</locationSetId>
            <timeSeriesType>external forecasting</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <readWriteMode>add originals</readWriteMode>
        </timeSeriesSet>
        <timeSeriesSet>
            <moduleInstanceId>DIM_dcsmv5eps</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>H.opzet.voorspeld</parameterId>
            <qualifierId>0010921</qualifierId>
            <locationSetId>KNMI_EPS</locationSetId>
            <timeSeriesType>external forecasting</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <readWriteMode>add originals</readWriteMode>
        </timeSeriesSet>
        <timeSeriesSet>
            <moduleInstanceId>DIM_dcsmv5eps</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>H.opzet.voorspeld</parameterId>
            <locationSetId>KNMI_EPS</locationSetId>
            <timeSeriesType>external forecasting</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <readWriteMode>add originals</readWriteMode>
            <expiryTime unit="day" multiplier="7"/>
            <ensembleId>001091</ensembleId>
            <ensembleMemberIndexRange start="1" end="50"/>
        </timeSeriesSet>
        <externUnit parameterId="H.opzet.voorspeld" unit="cm"/>
        <externUnit parameterId="H.voorspeld.astro" unit="cm"/>
    </import>
</timeSeriesImportRun>

The IdMapping configuration wmoBufferAsciiMapIdBUFR_dcsmv5eps_import.xml is is needed to maps the internal FEWS Id's to the WmoBufferAscii Id's. An example IdMapping file importer is shown below.:

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<idMap version="1.1" 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/idMap.xsd">
	....
	    <parameter internal="H.voorspeld.astro" external="054003" />
    <parameter internal="H.opzet.voorspeld" external="054004"/>
    <parameter internal="H.observedopzet.voorspeld" external="054004" externalQualifier="054003"0010920" internalQualifier="0010920"/>
	....    <parameter internal="H.opzet.voorspeld" external="054004" externalQualifier="0010921" internalQualifier="0010921"/>
    <location external="06511" internal="delfzijl" />
    <location external="06512" internal="den_helder"/>
    <location external="06513" internal="harlingen"/>
    <location external="06514" internal="hoekvanholland"/>
    <location external="06515" internal="huibertgat"/>
    <location external="06516" internal="roompot_buiten"/>
    <location external="06520" internal="vlissingen"/>
    <location external="06522" internal="ijmuiden"/>
</idMap>