Range filter (BRangeFilterBlock)

This block filters numeric values that are outside the configured range. The Range Filter (filters values outside the range) is similar to the Deadband Filter (filters out values within the range) with inverted logic. The block only supports analytic trend requests. Value requests always return a value with a null status.

Values are considered in range if they are greater than or equal to the low limit and less than or equal to the high limit. Only trend requests are supported, value requests return null. The status of the resulting value is the combination of the in, high limit, and the low limit values.

Figure 103. Range Filter properties

To view these properties, double-click the block on the Wire Sheet block or the block name in the Nav tree.

Property	Value	Description
Out	read-only value slot	Outputs a filtered value.
Trend In	value slot	Links from the output of other logic blocks or data sources to supply trend data to the current logic block.
High Limit In	numeric value slot	Links from the output of other logic blocks or data sources to supply one or more values that define the maximum valid value. The framework merges status of the `High Limit In` and `Low Limit In` slots with the status of the `Trend In` record and applies all three to the resulting value.
Low Limit In	numeric value slot	Links from the output of other logic blocks or data sources to supply one or more input values to define a minimum valid value.

Examples

Consider a ZoneTemp with hs:zoneAirTempSensor and a:a marker tags, and history logged at 15–minute intervals.

Figure 104. History table includes out of range values

An algorithm with a Range Filter Block evaluates whether the ZoneTemp trend value is greater than the High Limit value or less than the Low Limit value, and filters those records from the result.

Figure 105. Algorithm with a Range Filter

The resulting table shows only the record values that are within the range.

Figure 106. Record values after the Logic Filter removed records