...
This transformation is used to sample a timeseries of several years into members of an ensemble, each year being copied to another ensemble members. The start year i.e. the first year to be considered within the input value variable has to be specified , as well as the beginning of the year in startWaterYear if different from Jan 1st. Output in startYear. The beginning of the year is January 1st by default but can be changed in startWaterYear by giving the month and day. The start year is considered a water year when this option is used. A water year is a term commonly used in hydrology to describe a time period of 12 months for which precipitation totals are measured. For example, in the US, the water year starts on October 1st: <startWaterYear>--10-01</startWaterYear>. The index of the ensemble members can be specified in firstEnsembleMemberIndex. The number of ensemble members can be specified in ensembleMemberCount, if not specified it will calculated from the number of year between the time zero and the start year. All these elements can also be defined in a moduleParameterFile. The output variable should be of the same type as the input variable. This transformation is mainly used to create climatological ensembles.
Configuration
A basic configuration of the function is described below.
...
Here is a configuration example, with a module parameter file:
| Code Block | ||
|---|---|---|
| ||
<transformationModule 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/transformationModule.xsd" |
...
version="1.0"> <!-- |
...
input variables--> |
...
<variable> <variableId>Precip_Historic</variableId> <timeSeriesSet> <moduleInstanceId>PreprocessRDRS</moduleInstanceId> <valueType>scalar</valueType> <parameterId>PC.rdrs</parameterId> <locationSetId>RAVEN_$MODEL$</locationSetId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="hour" multiplier="3"/> <relativeViewPeriod unit="day" |
...
start="- |
...
36500" startOverrulable="false" end="0 |
...
"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variable>
<variable>
<variableId>Temp_Historic</variableId>
<timeSeriesSet>
<moduleInstanceId>PreprocessRDRS</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>TA.rdrs</parameterId>
<locationSetId>RAVEN_$MODEL$</locationSetId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="hour" multiplier="3"/>
<relativeViewPeriod unit="day" start="-36500" startOverrulable="false" end="0"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variable>
<!-- output variables-->
<variable>
<variableId>Precip_ESP</variableId>
<timeSeriesSet>
<moduleInstanceId>PreprocessESP</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>PC.nwp</parameterId>
<locationSetId>RAVEN_$MODEL$</locationSetId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="3"/>
<relativeViewPeriod unit="day" start="-1" startOverrulable="true" end="$ENDTIME$" endOverrulable="true"/>
<readWriteMode>add originals</readWriteMode>
<expiryTime unit="day" multiplier="10"/>
<ensembleId>ESP</ensembleId>
</timeSeriesSet>
</variable>
<variable>
<variableId>Temp_ESP</variableId>
<timeSeriesSet>
<moduleInstanceId>PreprocessESP</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>TA.nwp</parameterId>
<locationSetId>RAVEN_$MODEL$</locationSetId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="3"/>
<relativeViewPeriod unit="day" start="-1" startOverrulable="true" end="$ENDTIME$" endOverrulable="true"/>
<readWriteMode>add originals</readWriteMode>
<expiryTime unit="day"/>
<ensembleId>ESP</ensembleId>
</timeSeriesSet>
</variable>
<transformation id="SampleESP_Precip">
<sample>
<historical>
<inputVariable>
<variableId>Precip_Historic</variableId>
</inputVariable>
<moduleParameterFile>Sample_ESP_Forecast</moduleParameterFile>
<outputVariable>
<variableId>Precip_ESP</variableId>
</outputVariable>
</historical>
</sample>
</transformation>
<transformation id="SampleESP_Temp">
<sample>
<historical>
<inputVariable>
<variableId>Temp_Historic</variableId>
</inputVariable>
<moduleParameterFile>Sample_ESP_Forecast</moduleParameterFile>
<outputVariable>
<variableId>Temp_ESP</variableId>
</outputVariable>
</historical>
</sample>
</transformation> |
where Sample_ESP_Forecast file is
| Code Block | ||
|---|---|---|
| ||
<parameters 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_modelparameters.xsd" version="1.5">
<modifierType>HISTORICWATERYEARS</modifierType>
<group id="default">
<parameter id="startYear">
<intValue>2001</intValue>
</parameter>
<parameter id="firstEnsembleMemberIndex">
<intValue>2001</intValue>
</parameter>
<parameter id="ensembleMemberCount">
<!-- NOTE: This value has to be increased at the beginning of every year-->
<intValue>19</intValue>
</parameter>
<parameter id="startWaterYear">
<stringValue>--10-01</stringValue>
</parameter>
</group>
</parameters> |
This leads to the following results for the Mesomikenda Lake Control Dam location:
