...
see example configuration below and this figure <exportStateActivity>
<moduleInstanceId>HBV
Code Block | ||||
---|---|---|---|---|
| ||||
<exportStateActivity> <moduleInstanceId>HBV_AareBrugg_Hist</moduleInstanceId> |
...
<stateExportDir>%ROOT_DIR%/FEWS/states</stateExportDir> |
...
<stateConfigFile>%ROOT_DIR%/FEWS/states/states.xml</stateConfigFile> |
...
<stateLocations type="file"> |
...
<stateLocation> <readLocation>HBV_States.zip</readLocation> |
...
<writeLocation>HBV_States.zip</writeLocation> |
...
</stateLocation> </stateLocations> <stateSelection> <warmState> <stateSearchPeriod unit="hour" start="-240" end="-96"/> |
...
</warmState> </stateSelection> <writeIntermediateState>true</writeIntermediateState> <minimumRunLength unit="day" multiplier="4"/> |
...
</exportStateActivity> |
...
ExportTimeSeriesActivity
Figure 71 Elements of the exportTimeSeries section
description
Optional description of the timeSeries export configuration.
exportFile
Name (and location) of the PI-XML file with exported time series. If the directory location is not explicitly specified the file will be written in the exportDir defined in the general section.
exportBinFile
When true the events in the PI time series file are written to a binary file instead of the xml file. The written xml file will only contain the time series headers and optionally a time zone. The binary file has the same name as the xml file only the extension is "bin" instead of "xml". During PI time series import the bin file is automatically read when available. The byte order in the bin file is always Intel x86.
ignoreRunPeriod
When true the run period, written in the pi run file, will not be extended.
includeThresholds
When true any thresholds for the exported timeseries will be written in the timeserie headers
timeSerieSets
Root element for defining timeSerieSets to be exported.
timeSerieSets: timeSerieSet
TimeSeriesSets to be exported. These may contain either a (list of) locations or a locationSet. Multiple entries may be defined.
omitMissingValues
Are missing values to be written to the export file or should they be left out.
omitEmptyTimeSeries
When true, a series is not exported when the time series is empty (or when omitMissingValues = true, when the time series is empty after removing the missing values.)
forecastSelectionPeriod
...
ExportMapStacksActivity
Figure 72 Elements of the ExportMapStacksActivity.
description
Optional description of the timeSeries export configuration.
exportFile
Name (and location) of the PI-XML file describing the map stack of the exported grid time series. If the directory location is not explicitly specified the file will be written in the exportDir defined in the general section.
gridFile
Root element for defining file name of grid to be exported
locationId
LocationId for grid to be exported.
gridName
Name of the files for the grid to be exported. For grid files where each time slice is stored in a different file, this name is the prefix for the full file name. The final file name is created using an index of files exported (e.g the file name for the 4^th^ time step is grid00000.004).
gridFormat
Format of the exported grid. Enumeration of options include;
- asc : for exporting to ARC-INFO ASCII grid format
- pcrgrid : for exporting to PCRaster native grid file format
- usgsdem : for exporting to USGS DEM format (BIL)
timeSerieSet
TimeSeriesSets to be exported. These should contain only one locationId. For exporting multiple grids, multiple exportMapStack activities should be defined.
exportProfilesActivity
...
ExportDataSetActvity
Figure 73 Elements of the exportDataSets section
description
Optional description of the module dataset export configuration.
moduleInstanceId
...
ExportParameterActivity
Figure 74 Elements of the exportParameter section
description
Optional description of the module parameter configuration.
moduleInstanceId
Optional reference to the moduleInstanceId of the moduleParameter to be exported. If not defined the moduleInstanceId of the current module instance is taken as a default (see section on Module Datasets and Parameters)
fileName
...
ExportTableActivity
Figure 1 Elements of the ExportTableActivity configuration
description
Optional description of the ExportTableActivity configuration.
exportFile
File to which the table will be exported. This file is always placed in exportDir.
tableType
Type of table to be exported. Currently enumeration must be "ratingCurve"
operation
ID of the table to be exported.
parameters
Parameters for the convertEquation operation. Must include minimumLevel, maximumLevel and stepSize
locationId/locationSetId
...
exportNetcdfActivity
Figure 2 Elements of the ExportNetcdfActivity configuration
description
Optional description of the ExportNetcdfActivity configuration.
exportFile
File to which the data will be exported. This file is always placed in exportDir.
timeSeriesSets
TimeSeriesSet that defines what data is to be exported.
omitMissingValues
Are missing values to be written to the export file or should they be left out.
omitEmptyTimeSeries
...
ExportRunFileActivity
Figure 3 Elements of the ExportRunFileActivity configuration
description
Optional description of the ExportRunFileActivity configuration.
exportFile
File to which the data will be exported. This file is always placed in exportDir.
properties
Kind of environment variables for the pre and post adapters. These properties are copied to the run file. This is also a convenient way to pass global properties to a pre or post adapter. An adapter is not allowed to access the FEWS global.properties directly. Global properties (between $) are replace by there literal values before copied to the run file. These extra options makes an additional pre or post adapter configuration file unnecessary.
Options:
- string
- int
- float
- bool
example of exported run file
Code Block | ||
---|---|---|
xml | xml |
h4. ExportTimeSeriesActivity
!ExportTimeSeriesActivityComplexType.png!
Figure 71 Elements of the exportTimeSeries section
\\
h5. description
Optional description of the timeSeries export configuration.
\\
h5. exportFile
Name (and location) of the PI-XML file with exported time series. If the directory location is not explicitly specified the file will be written in the exportDir defined in the general section.
\\
h5. exportBinFile
When true the events in the PI time series file are written to a binary file instead of the xml file. The written xml file will only contain the time series headers and optionally a time zone. The binary file has the same name as the xml file only the extension is "bin" instead of "xml". During PI time series import the bin file is automatically read when available. The byte order in the bin file is always Intel x86.
h5. ignoreRunPeriod
When true the run period, written in the pi run file, will not be extended.
h5. includeThresholds
When true any thresholds for the exported timeseries will be written in the timeserie headers
h5. timeSerieSets
Root element for defining timeSerieSets to be exported.
\\
h5. timeSerieSets: timeSerieSet
TimeSeriesSets to be exported. These may contain either a (list of) locations or a locationSet. Multiple entries may be defined.
h5. omitMissingValues
Are missing values to be written to the export file or should they be left out.
h5. omitEmptyTimeSeries
When true, a series is not exported when the time series is empty (or when omitMissingValues = true, when the time series is empty after removing the missing values.)
h5. forecastSelectionPeriod
Can be used to select all approved forecasts with a forecast start time lying within this period
\\
\\
h4. ExportMapStacksActivity
\\
!image015.png!
Figure 72 Elements of the ExportMapStacksActivity.
\\
h5. description
Optional description of the timeSeries export configuration.
\\
h5. exportFile
Name (and location) of the PI-XML file describing the map stack of the exported grid time series. If the directory location is not explicitly specified the file will be written in the exportDir defined in the general section.
\\
h5. gridFile
Root element for defining file name of grid to be exported
\\
h5. locationId
LocationId for grid to be exported.
\\
h5. gridName
Name of the files for the grid to be exported. For grid files where each time slice is stored in a different file, this name is the prefix for the full file name. The final file name is created using an index of files exported (e.g the file name for the 4^th\^ time step is grid00000.004).
\\
h5. gridFormat
Format of the exported grid. Enumeration of options include;
* _asc_ : for exporting to ARC-INFO ASCII grid format
* _pcrgrid_ : for exporting to PCRaster native grid file format
* _usgsdem_ : for exporting to USGS DEM format (BIL)
\\
h5. timeSerieSet
TimeSeriesSets to be exported. These should contain only one locationId. For exporting multiple grids, multiple exportMapStack activities should be defined.
\\
h4. exportProfilesActivity
Configuration of the exportProfiles activity is identical to the exportTimeSeries Activity.
!image016.png!\\
\\
h4. ExportDataSetActvity
!image017.png!
Figure 73 Elements of the exportDataSets section
\\
h5. description
Optional description of the module dataset export configuration.
\\
h5. moduleInstanceId
Optional reference to the moduleInstanceId of the moduleDataSet to be exported. If not defined the moduleInstanceId of the current module instance is taken as a default (see section on Module Datasets and Parameters).
\\
\\
h4. ExportParameterActivity
!image018.png!
Figure 74 Elements of the exportParameter section
\\
h5. description
Optional description of the module parameter configuration.
\\
h5. moduleInstanceId
Optional reference to the moduleInstanceId of the moduleParameter to be exported. If not defined the moduleInstanceId of the current module instance is taken as a default (see section on Module Datasets and Parameters)
\\
h5. fileName
Name (and location) of the PI-XML file with exported parameters. If the directory location is not explicitly specified the file will be written in the exportDir defined in the general section.
\\
\\
h4. ExportTableActivity
!ExportTableActivity.png!
Figure 1 Elements of the ExportTableActivity configuration
h5. description
Optional description of the ExportTableActivity configuration.
\\
h5. exportFile
File to which the table will be exported. This file is always placed in exportDir.
\\
h5. tableType
Type of table to be exported. Currently enumeration must be "ratingCurve"
\\
h5. operation
ID of the table to be exported.
\\
h5. parameters
Parameters for the convertEquation operation. Must include minimumLevel, maximumLevel and stepSize
\\
h5. locationId/locationSetId
location id to select the rating curve
\\
\\
h4. exportNetcdfActivity
!ExportNetcdfActivity.png!
Figure 2 Elements of the ExportNetcdfActivity configuration
h5. description
Optional description of the ExportNetcdfActivity configuration.
\\
h5. exportFile
File to which the data will be exported. This file is always placed in exportDir.
\\
h5. timeSeriesSets
TimeSeriesSet that defines what data is to be exported.
\\
h5. omitMissingValues
Are missing values to be written to the export file or should they be left out.
\\
h5. omitEmptyTimeSeries
The time series is not exported when the time series is empty or when; omitMissingValues = true and the time series is empty after removing the missing values.
\\
\\
h4. ExportRunFileActivity
!ExportRunFileActivity.png!
Figure 3 Elements of the ExportRunFileActivity configuration
h5. description
Optional description of the ExportRunFileActivity configuration.
\\
h5. exportFile
File to which the data will be exported. This file is always placed in exportDir.
\\
h5. properties
Kind of environment variables for the pre and post adapters. These properties are copied to the run file. This is also a convenient way to pass global properties to a pre or post adapter. An adapter is not allowed to access the FEWS global.properties directly. Global properties (between $) are replace by there literal values before copied to the run file. These extra options makes an additional pre or post adapter configuration file unnecessary.
Options:
* string
* int
* float
* bool
\\
example of exported run file
{code:xml}
<?xml version="1.0" encoding="UTF-8"?>
<Run xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.wldelft.nl/fews/PI" xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_run.xsd" version="1.5">
<logLevel>info</logLevel>
<timeZone>0.0</timeZone>
<startDateTime date="1900-01-01" time="00:00:00"/>
<endDateTime date="2100-01-01" time="00:00:00"/>
<time0 date="2000-01-01" time="00:00:00"/>
<workDir>workdir</workDir>
<outputDiagnosticFile>diagnostic</outputDiagnosticFile>
</Run>
|
...
Exports an area selection mask as a PiMapStack. This activity requires an embedded polygon to be specified within the areaSelectionShapeFileBase64 field of the TaskProperties. This file is then available to be used by the pre and post adapter.
description
Optional description for the activity. Used for reference purposes only.
exportFile
File name of the file to be exported. Always placed into the export dir.
...
Locations that contains the reference grid information.
gridFormat
Format of the PiMapStack file. Can be
...
Exports an area selection mask in the form of a PiMapStack. This activity requires selectedLocationIds to be specified within the TaskProperties. This selection is then available to be used by the pre and post adapter.
description
Optional description for the activity. Used for reference purposes only.
exportFile
File name of the file to be exported. Always placed into the export dir.
...
Locations that contains the reference grid information.
gridFormat
Format of the PiMapStack file. Can be
...
Root element for the definition of an execute activity. For each external executable or Java class to run, an executeActivity must be defined. Multiple entries may exist.
description
Optional description for the activity. Used for reference purposes only.
...
Figure 76 Elements of the ImportActivities configuration
description
Optional description of import activity. Used for reference purposes only
...