| Excerpt | ||
|---|---|---|
| ||
ValuesAfterChangeWithTimeWindow: The transformation SelectionValuesAfterChangeWithTimeWindow can be used e.g. to filter out measurement values during periods where the measured system is not in a (quasi) steady state due to changes happening in the system. This transformation creates a time window after each change in a configured condition variable. The length of each time window is determined by a custom expression in the configuration. Depending on the configured selection type the input values inside or outside the time windows are selected. All selected input values are then copied to the output variable. Missing output values are produced at times where there is not enough reliable or doubtful data available in the condition and/or expression variables to determine if there is a change or to determine the length of a time window. Any such missing output values are truncated from the start and end of the run period of the transformation, to avoid overwriting data from previous runs with overlapping run periods. |
...
| scrollbar |
|---|
Information
Transformation: | ValuesAfterChangeWithTimeWindow |
|---|---|
Transformation Group: | Selection |
Description: | The This transformation SelectionValuesAfterChangeWithTimeWindow can be used e.g. to filter out measurement values during periods where the measured system is not in a (quasi) steady state due to changes happening in the system. This transformation creates a time window after each change in a configured condition variable. The length of each time window is determined by a custom expression in the configuration. Depending on the configured selection type the input values inside or outside the time windows are selected. All selected input values are then copied to the output variable. Missing output values are produced at times where there is not enough reliable or doubtful data available in the condition and/or expression variables to determine if there is a change or to determine the length of a time window. Any such missing output values are truncated from the start and end of the run period of the transformation, to avoid overwriting data from previous runs with overlapping run periods. |
Hydrological Information
Purpose and use of Transformation: | Can be used e.g. to filter out measurement values during periods where the measured system is not in a (quasi) steady state due to changes happening in the system. For example when a pump is switched on/off in a system of pipes, then the pressure in the pipes will fluctuate for some time until reaching an equilibrium value. If data analysis depends only on the equilibrium value, then this transformation can be used to filter out the fluctuating values just after a pump has been switched on/off in the system. |
|---|---|
Background and Exceptions: |
|
Input
description of common and transformation specific input
Options
description of (schema) options to use in this transformation
CoefficientSets
description of connection to CoefficientSets
Output
description of common and transformation specific output
Configuration Example
config example in ready-to-use xml
Produces missing output values at times where there is not enough reliable or doubtful data available in the condition and/or expression variables to determine if there is a change or to determine the length of a time window. Any such missing output values are truncated from the start and end of the run period of the transformation, to avoid overwriting data from previous runs with overlapping run periods. |
Input
TODO
Options
TODO
CoefficientSets or CoefficientSetFunctions
TODO
Output
TODO
Configuration Example
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<transformation id="SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest">
<selection>
<valuesAfterChangeWithTimeWindow>
<variableDefinition>
<variableId>input</variableId>
<timeSeriesSet>
<moduleInstanceId>SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<relativeViewPeriod unit="minute" start="0" end="40"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variableDefinition>
<variableDefinition>
<variableId>condition</variableId>
<timeSeriesSet>
<moduleInstanceId>SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.value.resolution</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<relativeViewPeriod unit="minute" start="0" end="40"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variableDefinition>
<variableDefinition>
<variableId>expression1</variableId>
<timeSeriesSet>
<moduleInstanceId>SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.obs</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<relativeViewPeriod unit="minute" start="0" end="40"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variableDefinition>
<variableDefinition>
<variableId>expression2</variableId>
<timeSeriesSet>
<moduleInstanceId>SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q.m</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<relativeViewPeriod unit="minute" start="0" end="40"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variableDefinition>
<variableDefinition>
<variableId>output</variableId>
<timeSeriesSet>
<moduleInstanceId>SelectionValuesAfterChangeWithTimeWindowSelectOutsideTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>P.m</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<relativeViewPeriod unit="minute" start="0" end="40"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</variableDefinition>
<inputVariable>
<variableId>input</variableId>
</inputVariable>
<conditionVariable>
<variableId>condition</variableId>
</conditionVariable>
<timeWindowLengthExpression>10*a*b*expression1 + expression2</timeWindowLengthExpression>
<coefficientSet>
<coefficient id="a" value="2"/>
<coefficient id="b" value="5"/>
</coefficientSet>
<selectionType>select_outside_time_window</selectionType>
<outputVariable>
<variableId>output</variableId>
</outputVariable>
</valuesAfterChangeWithTimeWindow>
</selection>
</transformation>
| ||||
| No Format | ||||
<Config> Config example in this box for copy & paste </Config>
|