What | nameofinstance.xml |
|---|---|
Description | Modify workflow run period based in a timeseries threshold |
schema location | https://fewsdocs.deltares.nl/schemas/version1.0/workflowLoopRunner.xsd |
| Table of Contents |
|---|
| Tip |
|---|
Although this manual mentions the SOBEK model this module can be used for any external module (e.g. also ISIS) |
What is the WorkflowLooprunner?
To decrease the run time length the SOBEK model for the Rhine basin is only run for periods where the discharge at Lobith exceeds a given threshold. Respectively the SOBEK model for the Meuse basin is only run for periods where the discharge at Borgharen exceeds a given threshold. To achieve this a so called WorkflowLooprunner was configured in FEWS. There are two options to select the periods for which the SOBEK model shall be run. The first option is to define a threshold for a given time series. If this threshold is exceeded the SOBEK model will be run. The second option is to define the length of a time interval, e. g. yearly. In each time interval SOBEK is run for a defined time window around the maximum value.
...
In the next two sections how to configure the different options in FEWS is explained.
Run SOBEK around the maximum value of a given period
In the Workflow LoopRunner the following things have to be defined:
...
It is recommended to choose the time step size in such a way that the relative view period is a multiple of the time step size. If this is not the case, the last part of the relative view period is not taken into account, e.g. if the relative view period contains ten days and the time step size is three than the last day of the relative view period will be ignored in the WorkflowLoopRunner. Furthermore, choose an adequate time period before the maximum value, so that the model can simulate the peak sufficiently. Also keep in mind that the run time increases if the relative run window increases. Besides, one single SOBEK run must not be longer than 30 days, due to an internal setting in the SOBEK model.
Run SOBEK where the discharge exceeds a pre-defined threshold
In the Workflow LoopRunner the following things have to be defined:
...
As an example for configuring the WorkflowLoopRunner see Figure 4.
_Figure 4 : WorkflowLoopRunner with trigger option "value trigger"_
In the example file the trigger time series is Q.uh, the discharge at Lobith calculated from HBV. The relative view period is 14610 days (40 years). For each time interval the maximum value of the trigger time series will be defined. As value option "above" was chosen. The threshold value is 4000. The relative run window includes the period where the discharge at Lobith exceeds the threshold value as well as to days before and after that period.
Run Model for entire view period if pre-defined threshold is exceeded
Next to running the model for a relative run window with respect to
threshold values found in the relative view period of the indicated
timeSeriesSet, an option exsists run the model for the entire view period in
this event.
This implies that the relative run window is similar to the total relative
view period, independant of the instance at which the threshold value is
exceeded. This is illustrated in Figure 5.
Figure 5: Definition of the run window for the runPeriodOption alwaysFullPeriod="true".
This feature is enabled by setting the alwaysFullPeriod flag to true at
runPeriodOptions. This is illustrated in Figure 6.
_Figure 6: Run model for entire view period by selecting
alwaysFullPeriod="true"._