Top  | Previous | Next

Numeric Properties

 

The numerical properties are available to any tag whose data type is numeric.

 

Property

Binding Name

Description

Scale mode

ScaleMode

If and how the tag value will be scaled between the source, and what is reported for the tag.

Deadband

Deadband

A floating point value used to prevent unnecessary updates for tags whose values "float" by small amounts.

 

Scaling Settings

Property

Binding Name

Description

Raw Lo

RawLow

Start of the "raw" value range

Raw Hi

RawHigh

End of the "raw" value range

Scaled Lo

ScaledLow

Start of "scaled" value range. Raw low will map to Scaled low for the tag.

Scaled Hi

ScaledHigh

End of "scaled" value range. Raw high will map to Scaled high for the tag.

Clamp Mode

ClampMode

How values that fall outside of the ranges will be treated. "Clamped" values will be adjusted to the low/high scaled value as appropriate.

Scale Factor

ScaleFactor

For single parameter modes (currently only Exponential Filter), the factor parameter for the equation.

 

Linear Scaling

The value will be scaled linearly between the low and high values, and clamped as appropriate.

The linear equation is:

ScaledValue = ΔS * (Value-RL)/ΔR + SL

 

Square root Scaling

The equation for square root scaling is:

ScaledValue = √(ΔS * (Value-RL)/ΔR) + SL

 

 

... where ΔS is (ScaledHigh-ScaledLow), ΔR is (RawHigh - RawLow), RL is RawLow, and SL is ScaledLow

 

Exponential Filter

This mode implements a simple linear recursive filter to smooth values. The scale factor corresponds to the weight of the smoothing effect, and is a value between 0.0 and 1.0. The smaller the factor, the greater the degree of smoothing.

The equation for the filter is:

y(t) = (1-f)*y(t-1)+f*x(t)

With:

y(t) = the output at time t.
y(t-1) = the previous output
x(t) = the input value (current value)
f = the scale factor, with 0.0<=f<=1.0

Note: Only "good" quality values are considered for the filter. Bad quality values will be ignored.