Page History

Excerpt

hidden	true

MeanInterval: This transformation calculates the accumulative mean from the input time series within several intervals.

Information

Transformation:	MeanInterval
Transformation Group:	Accumulation
Description:	This transformation calculates the accumulative mean from the input time series within several intervals. The intervals are defined by the specified intervalTimeStep. For a given interval the first output value equals the first input value within the interval and the other output values are equal to the mean of the corresponding input value and all previous input values within the interval. The startTime of an interval is exclusive and the endTime of an interval is inclusive. The output time series must have the same timeStep as the input time series. The calculation starts at the first valid interval time step within the run period. Therefore the relative view period for the input and output variables must be large enough so that it contains at least one interval time step.

Hydrological Information

Purpose and use of Transformation:	To create accumulative mean curves for several intervals.
Background and Exceptions:	This transformation also works for grid input and output. It does not work for irregular time steps. If the transformation is from instantaneous/mean input parameter type to accumulated output parameter type, then the result is multiplied by the timestep in seconds, before the mean is calculated. In this case the input data is assumed to be in units/second.

Input

Input variable.

Options

intervalTimeStep This time step defines the intervals that are used for the accumulation. Each time in this time step is the boundary between two intervals. The calculation starts at the first valid interval time step within the run period. Therefore the relative view period for the input and output variables must be large enough so that it contains at least one interval time step.

ignoreMissing Optional. If true, then missing values are ignored. If false, then output values will be set to missing values starting from the first missing input value in an interval until the end of that interval. Default is true.

Output

Output variable with accumulative mean curves.

Configuration Example

Code Block

	xml
	xml

<?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">
	<variable>
		<variableId>input</variableId>
		<timeSeriesSet>
			<moduleInstanceId>AccumulationMeanInterval</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>H.obs</parameterId>
			<locationId>H-2001</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="hour" multiplier="1"/>
			<relativeViewPeriod unit="day" start="0" end="3"/>
			<readWriteMode>editing visible to all future task runs</readWriteMode>
		</timeSeriesSet>
	</variable>
	<variable>
		<variableId>output</variableId>
		<timeSeriesSet>
			<moduleInstanceId>AccumulationMeanInterval</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>H.mean</parameterId>
			<locationId>H-2001</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="hour" multiplier="1"/>
			<relativeViewPeriod unit="day" start="0" end="3"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</variable>
	<transformation id="accumulation mean interval">
		<accumulation>
			<meanInterval>
				<inputVariable>
					<variableId>input</variableId>
				</inputVariable>
				<intervalTimeStep times="08:00"/>
				<ignoreMissing>true</ignoreMissing>
				<outputVariable>
					<variableId>output</variableId>
				</outputVariable>
			</meanInterval>
		</accumulation>
	</transformation>
</transformationModule>

Page tree

Versions Compared

Old Version 6

New Version 7

Key