...
The associated root directory structure of the Delft-FEWS export for this type of dataset is as follows:
<archiveRoot>/<yyyy>/<MM>/<areaId>/<dd>/simulated/<workflowId><TimeZero><DispatchTime>
Where <dd> refers to the date of the forecast time T0.
This directory holds the metaData.xml as well as runInfo.xml file with the FEWS taskrun properties (see Figure 3.8). Within this directory the following sub-folders may exist:
/timeseries, /reports, /modifiers, /states
The exportArchiveModule.xsd has a dedicated exportSimulated section to configure the messages that need to be archived (see Figure 3.7). The associated specification is given in Table 4.4.
Table 4.4 Delft-FEWS export configuration for archiving simulations
Store time series in the netcdf storage
It is possible to store a simulation partly in the Open Archive (meta data, states, reports, modifiers and reports) and partly (time series) in the netcdf storage. This can be useful when you want to have a 'clean' time series only storage. This can be configured by add the element netcdfStorageExport to the general section. An example is given below.
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<exportArchiveModule 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/exportArchiveModule.xsd">
<exportSimulated>
<general>
<archiveFolder>folder</archiveFolder>
<areaId>area</areaId>
<netcdfStorageExport>
<matchingAttributeId>attribute1</matchingAttributeId>
<matchingAttributeId>attribute2</matchingAttributeId>
</netcdfStorageExport>
</general>
<activities>
<netcdfExportActivities>
<netcdfExportActivity>
<fileName>test.nc</fileName>
<timeSeriesSet>
<moduleInstanceId>test</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>par</parameterId>
<locationId>loc</locationId>
<timeSeriesType>simulated forecasting</timeSeriesType>
<timeStep unit="hour"></timeStep>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</netcdfExportActivity>
</netcdfExportActivities>
</activities>
</exportSimulated>
</exportArchiveModule> |
Element | Format | Description |
GeneralExportForecastSection ComplexType | ||
archiveFolder | string | Export destination folder, assumes that the account running the FEWS (FSS) application has write access |
relativePeriod | Exports entire simulated timeseries by workflow. | |
| workflowId | string | This option should be in combination with the relativePeriod. Al the forecasts of the workflowId which exists in the relative period will be exported |
idMap | string | idMap applied to translate internal FEWS identifiers to identifiers that meet NetCDF-CF criteria.E.g. netcdf does not allow a full stop ('.') in the variable name |
| relatedWorkflowId | String | If the export is done without the relativePeriod and workflowId option but not in the workflow which created the forecasts the workflow id of the forecast you are trying to export should be configured to make sure that the modifiers which are used in this forecast will be exported. |
ForecastActivities ComplexType | ||
NetcdfForecastExportActivities ComplexType | ||
NetcdfForecastExportActivity ComplexType* | ||
fileName | string | without nc extension, preferably no spaces |
areaId | string | area to which the dataset belongs |
ncMetaData | string elem. | optional metadata tags within NetCDF file following CF convention. Supported by the internal catalogue of the THREDDS Data Server |
includeFlags | bool | only applied for scalar values. |
includeComments | bool | only applied for scalar values. |
timeSeriesSets | FEWS timeseries sets | |
ReportsExportActivity ComplexType* | ||
subfolder | string | Subdirectory within the 'reports' directory |
moduleInstanceId | string | moduleInstanceId which created the report |
ModuleStatesExportActivity ComplexType* | ||
moduleInstanceId | string | moduleInstanceId which created the state |
...