Versions Compared

Key

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

...

Values are assumed to never be negative. If a timeseries should allow negative number, a transformation has to be applied with for each value, if the value is greater than 1310.71, then subtract 1310.72 from the value and change the sign to negative.

Note that the only times provided by contained in the data are the times at which the data was received by the server, which is different from when the data was measured. The last measurement and the reception time can be a few minutes apart. That This is why the minutes time of the most recent measurement time has to be specified in the configuration as a property. It is 45 by default. You can find this value by looking at the times of the defined values of the VB parameter for your location on the following website: https://cloud.xylem.com/hydrosphere/public-sitesdata is assumed to be the previous quarter of an hour. Taking the content of the file below as example, the data was received at 12:55 (518244D424059125511G39). The most recent time and value to be imported will be at 12:45.

The data is provided in chunks separated by a space. Each chunk is for one location only and for one hour. It contains all values of 7 seven parameters (Main Stage, Secondary Stage, Rainfall, AirTemp, RH, Internal RH and Repeater Battery) every 15 minutes for three hours and one value for one parameter (Main Battery).

...

Code Block
languagexml
<import>
     <general>
         <importType>GOES</importType>
         <folder>$IMPORT_FOLDER$</folder>
         <idMapId>import_mapping</idMapId>
	 </general>
     <properties>
         <int key="minutesOfLatestMeasurement" value="45"/>
     </properties>
     <timeSeriesSet>
   		 <moduleInstanceId>my_module_Id</moduleInstanceId>
         <valueType>scalar</valueType>
         <parameterId>H.m</parameterId>
         <locationId>Delft</locationId>
         <timeSeriesType>external historical</timeSeriesType>
         <timeStep unit="minute" multiplier="15"/>
         <readWriteMode>add originals</readWriteMode>
     </timeSeriesSet>
</import>


The import_mapping configuration configuration is as follow. Note that the external names of the parameters cannot be changed. They correspond to the 8 eight different parameters in the data, in order of appearance. 

Code Block
languagexml
<idMap>
    <parameter internal="H.m" external="Main Stage"/>
    <parameter internal="SecStage" external="Secondary Stage"/>
    <parameter internal="Precipitation" external="Rainfall"/>
    <parameter internal="Temperature" external="AirTemp"/>
	<parameter internal="Humidity" external="RH"/>
	<parameter internal="InternalHumidity" external="Internal RH"/>
	<parameter internal="RepeaterBattery" external="Repeater Battery"/>
	<parameter internal="MainBattery" external="Main Battery"/>
</idMap>

...