Deadband filter (BDeadbandFilter)

This block removes numeric values that are within a configured range. It is similar to the range filter, which removes values outside the configured range, except that a deadband filter uses inverted logic. The block only supports analytic trend requests. Value requests always return a value with a null status.

Figure 90. Deadband 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 the filtered value.
Trend In	required value slot	Links from the output of other logic blocks or data sources to supply trend data to the current logic block.
Baseline In	required numeric value slot	Links from the output of other logic blocks or data sources to supply a trend. This trend provides a baseline value upon which to apply a deadband.
Deadband In	required numeric value slot	Links from the output of other logic blocks or data sources to supply one or more input values that represent a dead or neutral zone around a baseline.
Deadband Mode	drop-down list	Determines what the engine uses to establish the deadband. `Absolute`, configures a specific value to use as the deadband. `Percent`, configures the deadband as a percentage.
Percent Mode	drop-down list	Determines the form in which the constant appears if Deadband Mode is a percentage. `Percent` treats the value as a percent (0‐100). For example, value of 30% would be represented as 30. `Decimal` treats the value as a decimal number (0‐1). For example, a value of 30% would be represented as .3.

How the framework configures a deadband range

The Baseline In, Deadband In, Deadband Mode and Percent Mode properties on a Deadband Filter Block determine the range of values removed. The Deadband Mode property determines if the Deadband In value is an absolute value or a percentage. The Percent Mode property determines if the percentage value is expressed as a decimal (0-1) or as a percentage (0-100).

The following table provides an example of how all the properties work together to configure a deadband range.

Deadband configuration

Baseline In	Deadband In	Deadband Mode	Percent Mode	Range Min	Range Max	Calculated Range
72	5	Absolute	N/A	Baseline — Deadband	Baseline — Deadband	67–77
72	5	Percent	Percent	Baseline — (Baseline * (Deadband/100))	Baseline — (Baseline * (Deadband/100))	68.4–75.6
72	0.05	Percent	Decimal	Baseline — (Baseline * Deadband)	Baseline — (Baseline * Deadband)	68.4–75.6

Consider three numeric points with numeric interval histories for Zone Temp tagged with hs:zoneAirTempSensor and a:a marker tags, a baseline value of 72 (b:Baseline and a:a marker tags) and a deadband value of 5 (b:Deadband and a:a marker tags). The algorithm looks like this:

Figure 91. Deadband algorithm

A Px with an Analytic Web Chart displays the unfiltered hs:zoneAirTempSensor values compared to the alg:DeadbandFilter, which removes any records where the value is within the calculated 67-77 range.

Figure 92. Chart comparing air temp values compared to the deadband filter