View Source

Overview

The Environment Agency has developed an XML format to exchange time series data. The EA XML files can be imported with the specific EA XML time series import and the general time series import. If the general time series import function is used the <importTypeStandard>ea</importTypeStandard> must be used.

The import function works as any other import function in Delft-FEWS.

More details on the EA XML format can be requested from the Environment Agency.

Configuration (Example)

In order to import data from an EA XML file one has to configure the following items:

Time series import configuration files
The mapping between internal location and parameter id's to EA XML known location and parameter id's
The mapping between internal data flags to EA XML known data flags.

<?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>
			<importTypeStandard>ea</importTypeStandard>
			<folder>$IMPORT_TELEMETRY_FOLDER$</folder>
			<failedFolder>$IMPORT_FAILED_FOLDER$</failedFolder>
			<backupFolder>$BACKUP_TELEMETRY_FOLDER$</backupFolder>
			<validate>true</validate>
			<idMapId>IdImportTelemetry</idMapId>
			<unitConversionsId>ImportUnitConversions</unitConversionsId>
			<flagConversionsId>ImportFlagConversions</flagConversionsId>
			<dataFeedId>RTS</dataFeedId>
		</general>
		<tolerance parameterId="P.obs" timeUnit="minute" unitCount="1" locationSetId="Gauges_P.obs"/>
		<timeSeriesSet>
			<moduleInstanceId>ImportTelemetry</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>P.obs</parameterId>
			<locationSetId>Anglian_P.obs</locationSetId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="minute" multiplier="15"/>
			<readWriteMode>add originals</readWriteMode>
			<synchLevel>1</synchLevel>
			<expiryTime unit="day" multiplier="400"/>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportTelemetry</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>P.obs</parameterId>
			<locationSetId>Anglian_P.obs</locationSetId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="hour"/>
			<readWriteMode>add originals</readWriteMode>
			<synchLevel>1</synchLevel>
			<expiryTime unit="day" multiplier="400"/>
		</timeSeriesSet>
	</import>
</timeSeriesImportRun>

In the example above the rainfall time series are imported as 15 minute and 60 minute interval time series as the EA XML time series files contain rainfall data with these two time intervals. If only a 15 minute interval timeSeriesSet is configured and the files contain 15 and 60 minute series, the import function will also try to store the 60 minute values in this time series set.