View Source

Overview

The WMO BUFR ASCII import function (<importType>WmoBufrAscii</importType>) imports scalar time series from a WMO BUFR format provided by KNMI.

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:

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:

<?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="ImportWmoBufrAscii">
		<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.

<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>WmoBufrAscii</importType>
            <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 BUFR_dcsmv5eps_import.xml is needed to maps the internal FEWS Id's to the WmoBufferAscii Id's. An example IdMapping file importer is shown below.:

<?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.opzet.voorspeld" external="054004" externalQualifier="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>