You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

Description

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 variable has to be specified 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 transformation is added below.


<transformationModule version="1.0" 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">
    <!--Input time series-->
    <variable>
        <variableId>Q_in</variableId>
        <timeSeriesSet>
            <moduleInstanceId>ImportDatabase</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>parameter</parameterId>
            <locationSetId>HydroGauges_HuangChuan</locationSetId>
            <timeSeriesType>external historical</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <relativeViewPeriod unit="day" start="-16" end="0" startOverrulable="true"/>
            <readWriteMode>add originals</readWriteMode>
        </timeSeriesSet>
    </variable>
    <!--Output time series-->
    <variable>
        <variableId>Q_out</variableId>
        <timeSeriesSet>
            <moduleInstanceId>HuangChuan_Update_Pre</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>Q.obs</parameterId>
            <locationSetId>HydroGauges_HuangChuan</locationSetId>
            <timeSeriesType>external historical</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <relativeViewPeriod unit="day" start="-16" end="0" startOverrulable="true"/>
            <readWriteMode>add originals</readWriteMode>
        </timeSeriesSet>
    </variable>
    <!--Transformations-->
    <transformation id="myHistoricalTransformation">
        <sample>
            <historical>
                <inputVariable>
                    <variableId>Q_in</variableId>
                </inputVariable>
                <startYear>1981</startYear>
                <ensembleMemberCount>40</ensembleMemberCount>
                <startWaterYear>--01-01</startWaterYear>
                <outputVariable>
                    <variableId>Q_out</variableId>
                </outputVariable>
            </historical>
        </sample>
    </transformation>
</transformationModule>



Here is another configuration example, with module parameter file:

<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

<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: 

  • No labels

Disclaimer