Overview
The WIWB Import connects to the Hydronet WIWB API and has support for downloading observations and forecasts for both scalar and grid data. WIWB has a concept of DataSources which have to be configured as a property of the import. Using the meta data api of the WIWB API the type of data is determined and processed accordingly.
Import Configuration
To configure the WIWB import the dataSource property has to be specified.
Valid values for dataSource are provided by the meta data api, but at the time of writing the following dataSources are available:
- Knmi.Radar.Uncorrected
- Knmi.Radar.CorrectedC2
- Knmi.Radar.CorrectedB
- Knmi.Radar.CorrectedD2
- Knmi.Hirlam
- Knmi.Harmonie
- Knmi.Evaporation
- Knmi.IrisUnvalidated
- Knmi.IrisValidated
- Knmi.RegionalEps
- Knmi.Synops
- Knmi.WaterSetupEps
- Knmi.Warnings
- Knmi.AwsTenMinutes
- Meteobase.Evaporation.Makkink
- Meteobase.Evaporation.PennmanMonteith
- Meteobase.Precipitation
- Knmi.WaquaTs
- Knmi.Naval.Warnings
- Knmi.Naval.Forecasts
- Knmi.FromMeteobase.Synops
- Knmi.FromMeteobase.Evaporation
Missing values.
If the WIWB specifies the missing value for a datasource, this will be used by FEWS. The missing value can also be specified in the import configuration as well. The default value for missing value is -9999 for the WIWB api.
Examples
This example is configured to import scalar observations from the Knmi.AwsTenMinutes dataSource:
<?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>WIWB</importType> <serverUrl>https://wiwb.hydronet.com/api</serverUrl> <user>USERNAME</user> <password>PASSWORD</password> <relativeViewPeriod unit="hour" start="-24" end="0" startOverrulable="true"/> <idMapId>IdImport</idMapId> <expiryTime unit="week" multiplier="52"/> </general> <properties> <string key="dataSource" value="Knmi.AwsTenMinutes"></string> </properties> <timeSeriesSet> <moduleInstanceId>Import</moduleInstanceId> <valueType>scalar</valueType> <parameterId>P</parameterId> <locationId>06269</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="nonequidistant"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import> </timeSeriesImportRun></timeSer
The following example is configured for importing grids from the Knmi.Radar.Uncorrected dataSource
<import> <general> <importType>WIWB</importType> <serverUrl>https://wiwb.hydronet.com/api</serverUrl> <user>USERNAME</user> <password>PASSWORD</password> <relativeViewPeriod unit="hour" start="-24" end="0" startOverrulable="true"/> <idMapId>IdImport</idMapId> <expiryTime unit="week" multiplier="52"/> </general> <properties> <string key="dataSource" value="Knmi.Radar.Uncorrected"></string> </properties> <timeSeriesSet> <moduleInstanceId>Import</moduleInstanceId> <valueType>grid</valueType> <parameterId>P</parameterId> <locationId>grid_location</locationId> <timeSeriesType>external forecasting</timeSeriesType> <timeStep unit="nonequidistant"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import>