Versions Compared

Key

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

This is an import for time series published using the TAHMO API. 

FEWS configuration

In order to activate the TAHMO import as a FEWS import, it is required to set up a TimeSeriesImportRun module configuration file and an accompanying IdMap file.

The TAHMO import will take the serverUrl and append it with "stations" to obtain information about the available locations. It will then use the location id's to construct the query url's for the timeseries as such: "<serverUrl>/timeseries/<locationId>/hourly?startDate=...&endDate=...". Note that specifying a relativeViewPeriod is required. 

Example Import configuration file:

Code Block
languagexml
<?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">
<!-- This is an example import configuration file for importing Observations and Measurements data from a service -->
<import>
    <general>
        <importType>TAHMO</importType>
        <serverUrl>https://tahmoapi.host.net/v1/</serverUrl>
		<user>XXXXX</user>
        <password>XXXXX</password>
        <relativeViewPeriod unit="hour" start="-5" end="0" startOverrulable="true" endOverrulable="true"/>
        <idMapId>IdImportTahmo</idMapId>
    </general>
    <timeSeriesSet>
       <moduleInstanceId>ImportDD</moduleInstanceId>
       <valueType>scalar</valueType>
       <parameterId>MyPar</parameterId>
       <locationSetId>MyLocSet</locationSetId>
       <timeSeriesType>external historical</timeSeriesType>
       <timeStep unit="nonequidistant"/>
       <readWriteMode>add originals</readWriteMode>
       <synchLevel>1</synchLevel>
    </timeSeriesSet>
</import>
</timeSeriesImportRun>

Example IdMap file:

Code Block
languagexml
<?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">
 <!--
    map internal timeseries directly to external timeseries
    externalLocation should be set to the location id
    externalParameter should be set to the parameter name
 -->
 
<map internalLocation="MyLoc1" internalParameter="MyPar1" externalLocation="TA00269" externalParameter="atmosphericPressure" />
<map internalLocation="MyLoc2" internalParameter="MyPar1" externalLocation="TA00099" externalParameter="windspeed" />
 
</idMap>

...