Versions Compared

Key

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

Table of Contents

AQUARIUS Timeseries (AQTS 3.x)

This is an import that makes use of the custom import mechanism described in Custom import formats. The AQUARIUS server import offers two ServerParsers (AquariusTimeSeriesSoapServerParser.java and AquariusTimeSeriesRestServerParser.java), and a few parsers to parse the Aquarius response formats:

...

Code Block
titleAquarius IdMap
<?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">
    
     <!-- IdMapping for the Aquarius import requires that the FEWS parameter is mapped to:
       externalQualifier = Aquarius ratingcurve input parameter,
       externalQualifier1 = Aquarius ratingcurve output parameter
       externalQualifier2 = either StageDischarge or DischargeStage
      -->
    <locationIdFunction internalLocationSet="Aquarius.Ratings" externalLocationFunction="@AQUARIUSID@" externalQualifierFunction="HG" externalQualifierFunction1="QR"         externalQualifierFunction2="StageDischarge"/>
 
 </idMap>

AQUARIUS Timeseries AQTS 20xx


Depending on the server version a different parser might be needed.

When the AQUARIUS server has a version similar to AQTS 3.x the old legacy parser (documented on top of this page) should be used.

When the AQUARIUS server has a version similar to AQTS is 20xx a newer version of the parser is needed: 

nl.wldelft.aquarius.timeseriesparsers.AquariusTimeSeriesRestServerParserV2

The FEWS configuration will mostly be similar but the parser uses a by Aquatic Informatics provided library. This is currently version 19.1.2 which is still compatible with server versions up to 20.3.1 and probably future versions as well. 

Code Block
languagexml
titleAquarius import (AQTS 20xx)
<?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>
			<parserClassName>nl.wldelft.aquarius.timeseriesparsers.AquariusTimeSeriesRestServerParserV2</parserClassName>
			<binDir>%REGION_HOME%/Modules/aquarius</binDir>
			<serverUrl>http://server:port/AQUARIUS/Publish/v2</serverUrl>
			<user>deltares</user>
			<password>deltares</password>
			<relativeViewPeriod unit="day" start="-365" end="0" startOverrulable="true" endOverrulable="true"/>
			<idMapId>IdImportAquarius</idMapId>
			<flagConversionsId>ImportFlagConversion</flagConversionsId>
			<importTimeZone>
				<timeZoneOffset>-10:00</timeZoneOffset>
			</importTimeZone>
		</general>
		<properties>
			<!-- Optional: If the external location ids are equal to the TimeSeriesUniqueIds then
            	set value to 'true'. This way it is possible to skip the GetTimeSeriesDescriptionList requests.
            	Default:=false
            -->
			<bool key="SkipDataSetList" value="false"/>
			<!-- Optional: Only used if SkipDataSetList=false. In order to retrieve timeSeriesUniqueIds it
            	is necessary to call the GetTimeSeriesDescriptionList function. This function can be called per location
            	or for all locations in one go. Depending on the number of timeSeries on the server it can
            	be necessary to loop per location.
            	Default:=true (to avoid server errors)
            -->
			<bool key="LoopOverLocations" value="true"/>
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportMeasured</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>H.obs</parameterId>
			<locationSetId>Aquarius.Ratings</locationSetId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant"/>
			<readWriteMode>add originals</readWriteMode>
			<synchLevel>1</synchLevel>
			<expiryTime unit="day" multiplier="365"/>
		</timeSeriesSet>
	</import>
</timeSeriesImportRun>