| Wiki Markup |
|---|
{scrollbar} |
| Excerpt | ||
|---|---|---|
| ||
Sets the forecast length |
Function: | Sets the forecast length |
|---|
Module Name: | ForecastLengthEstimator |
|---|---|
Where to Use? | In a workflow |
Why to Use? | To set the length of a forecast based on (external) timeseries |
Description: | The forecastLengthEstimator is a module that can be used at the start of a workflow the set the length of the operations in the other modules in that workflow. |
Preconditions: | the endoverrulable attribute in the relative view period in the time series sets must be set to true in all modules you want to apply the forecast length to |
Outcome(s): |
|
Scheendump(s): | link to attached screendump(s) for displays only |
Remark(s): |
|
Available since: | DelftFEWS200803 |
Contents
| Table of Contents |
|---|
Overview
The forecastLengthEstimator is a module that can be used at the start of a workflow to set the length of the operations in the other modules in that workflow. As most models cannot handle gaps in the input data, this option can be useful if you want to run a hydrological model only with the data available and thus avoid e.g. extrapolating the meteorological forecast data.
...
Forecast time series
A configuration example of the forecast length estimator using an external forecast time series is given below:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<forecastLengthEstimator 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/forecastLengthEstimator.xsd">
<externalForecastTimeSeries>
<moduleInstanceId>ImportCOSMO2</moduleInstanceId>
<valueType>grid</valueType>
<parameterId>P.fg</parameterId>
<locationId>COSMO2</locationId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="1"/>
<relativeViewPeriod unit="hour" start="0" end="30"/>
<readWriteMode>read only</readWriteMode>
</externalForecastTimeSeries>
<minForecastLength multiplier="3" unit="hour"/>
<maxForecastLength multiplier="30" unit="hour"/>
</forecastLengthEstimator>
|
...
Here is a configuration example of the forecast length estimator using a simulated forecast time series. Make sure that your are using the read write mode "read complete forecast" or define a relative view period instead.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<forecastLengthEstimator 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/forecastLengthEstimator.xsd">
<simulatedForecastTimeSeries>
<moduleInstanceId>HBV_AlpenRhein_COSMO2</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.fh</parameterId>
<locationId>H-2473</locationId>
<timeSeriesType>simulated forecasting</timeSeriesType>
<timeStep unit="hour"/>
<readWriteMode>read complete forecast</readWriteMode>
</simulatedForecastTimeSeries>
<minForecastLength multiplier="3" unit="hour"/>
<maxForecastLength multiplier="30" unit="hour"/>
</forecastLengthEstimator>
|
...
Since 2011.02, the forecastLengthEstimator can also be used to set a fixed end date, e.g. the end of the water year.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<forecastLengthEstimator 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/forecastLengthEstimator.xsd">
<timeZone>GMT-12:00</timeZone>
<externalForecastTimeSeries>
<moduleInstanceId>ImportDATACARD</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>MAP</parameterId>
<locationSetId>Catchments</locationSetId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<relativeViewPeriod unit="day" start="0" end="365" endOverrulable="true"/>
<readWriteMode>read only</readWriteMode>
</externalForecastTimeSeries>
<minForecastEndDay>--09-30</minForecastEndDay>
</forecastLengthEstimator>
|
As of 2012.02, the forecast length can be forced to the end of the 2nd wateryear by using a combination of <minForecastLength> and <minForecastEndDay>. The code will first evaluate the minForecastLength before evaluating <minForecastEndDay>.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<minForecastLength multiplier="365" unit="day"/>
<minForecastEndDay>--09-30</minForecastEndDay>
|
External historical time series
In contrary to external forecast and simulated forcast time series, external historical time series can not be used to determine the forecast length because they are not forecasts. These time series can be configured but will only be used to determine the last time step of measuments and use that time to export as the last observation time to a run file.
Sample input and output
Sample input and output
...