Versions Compared

Key

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

...

The following CEMIG data files have been tested for the importer: ANNA25, CPTEC15, ETA_CEMIG and TRMM. The CPTEC15 format is currently still under construction and not supported yet.

The importer has to be configured with some properties. Possible configuration properties are:

  • forecast (optional): Possible values are true or false. Default is false. If forecast is set to true, the forecast issue date will be registered as T0 and the first import value will be assumed to start at T0 + the configured timeStep.

  • vars (required): should contain one or more , separated list of parameter namesparameters separated by a  comma (,) . The parameters are expected to be present in the binary file in the specified order. Only one value per parameter  If more than one variable is specified, only one time step is assumed. Specifying a tdefUnit and tdefValue is considered an error in this case.

  • fileNameDateTimePattern (required): pattern of the filename where the date is marked with single quotes ('). For example "prec_'yyyyMMdd'.bin". The date is used to determine T0 or the forecast issue date from the file name.

  • tdefUnit (optional): Required if more than one timestep is available in the binary format. Possible values are: second, minute, hour, day, month, year. Only equidistant timesteps are supported.

  • tdefValue (optional): Specifify the amount of units specified in the tdefUnit.

...

An example of the CEMIG import (filename: ImportCEMIG-anna25.xml) configuration for the ann25 anna25 files will be given here. The importType is named CEMIG which should be configured in the general section of the import.

Code Block
xml
xml
<?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>CEMIG</importType>
			<folder>$IMPORT_CEMIG_FOLDER$/anna</folder>
			<idMapId>cemigMapId</idMapId>
			<missingValue>-999</missingValue>
		</general>
		<properties>
			<bool key="forecast" value="false"/> <!-- default is false -->
			<string key="vars" value="prec"/> <!-- comma (,) separated list of variabeles. If more than one variable is specified, only one timestep is assumed. Specifying a tdefUnit and tdefValue is considered an error in this case. -->
			<string key="fileNameDateTimePattern" value="prec_'ddMMyyyy'.bin"/> <!-- define the date format to determine T0 or the forecast date  from the file name. -->
			<string key="tdefUnit" value="hour"/> <!-- define the timestep unit: second, minute, hour, day, month, year -->
			<string key="tdefValue" value="3"/> <!-- specifify the value related to the tdefUnit. -->
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportCEMIG-anna25</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>H.observed</parameterId>
			<locationId>CMEG-anna25-location</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="hour" multiplier="3"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</import>

</timeSeriesImportRun>

...