Message Filter

the message filter forwards a message only when the observed field changes enough to matter use it to reduce message volume by dropping readings that repeat or that move within a tolerance you define how it works the processor reads one field from each incoming message and compares it against a reference value the reference is the last forwarded value by default, or a fixed compare value when you set one if the change passes the rule for the selected mode, the processor forwards the message otherwise it drops it filter modes the mode parameter selects one of three rules rbe (report by exception) forwards a message only when the observed value differs from the previous value deadband forwards a message only when the observed value differs from the reference by more than the delta it blocks small fluctuations inside the band narrowband forwards a message only when the observed value differs from the reference by the delta or less it blocks large outlier jumps outside the band reference value by default, the processor compares each message against the last forwarded value when you set a compare value , it compares against that fixed reference instead the first message is evaluated against the rule rather than forwarded automatically you enter the compare value as text, and the processor converts it to match the type of the observed field, such as a number, a boolean, or a string delta percent when you enable delta percent , the processor treats the delta of tolerance as a percentage of the reference value rather than an absolute amount timer interval when you set a timer interval in milliseconds, the processor republishes the last known value if no new message arrives within that interval enter 0 to disable the timer parameters note in deadband and narrowband modes, the processor falls back to an equality check for non numeric values in rbe and deadband modes a non numeric value passes when it differs from the reference and in narrowband mode it passes when it matches the reference parameters details mode sets the filtering method rbe deadband narrowband map field name the field in the message to observe default is value delta of tolerance the band size used in deadband and narrowband modes ignored in rbe mode delta percent treats the delta of tolerance as a percentage of the reference value compare value a fixed reference value to compare each message against leave empty to compare against the last received value timer interval timer in milliseconds in which to push values enter 0 to disable this timer pass through value joins the input with the output of the processor