Information
Transformation: |
Maximum |
|---|---|
Transformation Group: |
Events |
Description: |
Calculates the maximum input value of the events initiated in the output period. An event in this transformation is defined as a the largest possible series of subsequent subevents where the duration of gaps (where there are no subevents) is shorter than the specified maxGapDuration parameter. A subevent is defined as a measurement in time in the input where the value is larger than the specified threshold parameter. |
Hydrological Information
Purpose and use of Transformation: |
This transformation can for instance be used to report the maximum value of the events for each month. |
|---|---|
Background and Exceptions: |
The output time step must be bigger than the input time step. All input values must be non-missings, otherwise the result will be set to missing value. In case one of the inputs is doubtful, the output flag is set to ORIGINAL_DOUBTFUL. |
Input
input Equidistant measurements.
Options
threshold Only measurements are used with a value above this value. Default is 0.
maxGapDuration When there is a gap between two subsequent subevents exceeding this duration, these subevents belong to two separate events. Default is 24 hours.
CoefficientSets
No connection to CoefficientSets.
Output
output Maximum of the input values of the events that initiated in the output period.
Configuration Example
Configuration example for calculation of the maximum for events for each month.
<?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 -->
<!-- output variables -->
<!-- transformations -->
<transformation id="events maximum">
<events>
<maximum>
<input>
<timeSeriesSet>
<moduleInstanceId>EventsMaximum</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.dis</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<relativeViewPeriod unit="day" start="0" end="113"/>
<readWriteMode>editing visible to all future task runs</readWriteMode>
</timeSeriesSet>
</input>
<output>
<timeSeriesSet>
<moduleInstanceId>EventsMaximum</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.arg</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep monthDays="--01-01 --02-01 --03-01 --04-01 --05-01 --06-01 --07-01 --08-01 --09-01 --10-01 --11-01 --12-01" />
<relativeViewPeriod unit="day" start="0" end="113"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</output>
</maximum>
</events>
</transformation>
</transformationModule>
