Information

Transformation:

Sum

Transformation Group:

Accumulation

Description:

Calculates for each timestep in the output period, the accumulated sum of the input values. In case the input is instantaneous or mean and the output is accumulation, then the sum is multiplied by the duration of the input time step in seconds. Each output value is the sum of the corresponding input value and all previous input values.

Hydrological Information

Purpose and use of Transformation:

This transformation can for instance be used to report the accumulated sum of the discharge per month.

Background and Exceptions:

In case the input is instantaneous or mean and the output is accumulation, the unit of the input must be unit/s. The input type (scalar or grid) must be the same as the output type and their timestep must be regular. In case the ignoreMissing value is set to false, once a missing value is encountered, the output will only contain missing values after that time step.

Input

inputVariable Regular scalar timeseries or regular grid.

Options

ignoreMissing Treat a missing value as 0 (default true).

CoefficientSets

No connection to CoefficientSets.

Output

outputVariable Accumulated sum of the input data.

Configuration Example

Configuration example for calculation of accumulation sum.

<?xml version="1.0" encoding="UTF-8"?>
<transformationModule version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.wldelft.nl/fews" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/transformationModule.xsd">
	<!-- input variables -->
	<variable>
		<variableId>input</variableId>
		<timeSeriesSet>
			<moduleInstanceId>AccumulationSum</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>H.m</parameterId>
			<locationId>H-2001</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="day"/>
			<relativeViewPeriod unit="day" start="0" end="30"/>
			<readWriteMode>editing visible to all future task runs</readWriteMode>
		</timeSeriesSet>
	</variable>
	<!-- output variables -->
	<variable>
		<variableId>output</variableId>
		<timeSeriesSet>
			<moduleInstanceId>AccumulationSum</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>Q.m</parameterId>
			<locationId>H-2001</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="day"/>
			<relativeViewPeriod unit="day" start="5" end="25"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</variable>
	<!-- transformations -->
	<transformation id="accumulation sum">
		<accumulation>
			<sum>
				<inputVariable>
					<variableId>input</variableId>
				</inputVariable>
				<ignoreMissing>false</ignoreMissing>
				<outputVariable>
					<variableId>output</variableId>
				</outputVariable>
			</sum>
		</accumulation>
	</transformation>
</transformationModule>

  • No labels