Multiple Output Location Thresholds

Since 2023.01 the multiple output location thresholds transformation is available.

This is meant for writing specific values to the out put time series when input time series have crossed certain threshold.

In practice this transformation has been developed for the use case where at input locations thresholds are crossed, for different output locations warnings must be sent.

In the configuration the input locations will have multi valued attributes consisting of different output location id's and different threshold levels.

Example configuration:

	<transformation id="MultipleOutputLocationThresholdsDown">
		<multipleLocationAttributes>
			<multipleOutputLocationThresholds>
				<inputVariable>
					<variableId>input</variableId>
				</inputVariable>
				<thresholdValueAttributeId>thresholdValue</thresholdValueAttributeId>
				<crossingDirection>down</crossingDirection>
				<filterAttribute id="filter" value="include"/>
				<outputValue>1</outputValue>
				<outputLocationAttributeId>outputId</outputLocationAttributeId>
				<outputVariable>
					<variableId>output</variableId>
				</outputVariable>
			</multipleOutputLocationThresholds>
		</multipleLocationAttributes>
	</transformation> 

Config options:

• thresholdValueAttributeId: This id refers to the attribute that will contain the different threshold values. This multivalued attribute must have the same number of values as the outputLocationAttribute and filter attribute, since each output location has its own threshold value.
• crossingDirection: Optional element, default is up. This determines if a value should be written on the up or down crossing of the threshold value.
• filterAttribute: This attribute determines which of the threshold values should be included for the transformation. Only if this attribute has an exact match for the configured "value" it will be included. This option requires and id and value, for example => id="filter" value="include". This multivalued attribute must have the same number of values as the thresholdValueAttribute and outputLocationAttribute, since each threshold value must be ableto be filtered individually.
• outputValue: The value to be written to the output time series when one of the input time series has a crossing
• outputLocationAttributeId: This id refers to the attribute that will contain the different threshold values. This multivalued attribute must have the same number of values as the outputLocationAttribute, since each output location has its own threshold value.