Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Situational Awareness Library

Pen_RangeOperatingAutoScale custom property

  • Last UpdatedAug 09, 2024
  • 2 minute read

When Pen_RangeOperatingAutoScale is True, a symbol uses the value of the Pen_RangeOperatingPercent custom property to set percentage boundaries above and below a setpoint value to establish a normal operating range. When a measured value is outside of the normal operating range around the setpoint, the symbol goes into full range mode and displays full range flags.

The reference value of Pen_RangeOperatingPercent is used to internally calculate updated Pen_RangeOperatingMin and Pen_RangeOperatingMax custom property values using the following formulas:

  • Pen_RangeOperatingMin = Setpoint - (Pen_RangeOperatingPercent/100 x Setpoint)

  • Pen_RangeOperatingMax = Setpoint + (Pen_RangeOperatingPercent/100 x Setpoint)

    Note: Make sure the object attribute references to both custom properties are writeable during run time.

During run time, the symbol uses the percentage range around the setpoint as the symbol's graphic scale with the setpoint always at the midpoint between the minimum and maximum limits. When a measured value moves outside of the percentage range around the setpoint, the symbol's graphic scale changes to use the limits set by the Pen_RangeFullScaleMin and Pen_RangeFullScaleMax custom properties. The symbol shows Full scale flags at the ends of its graphic scale to indicate that it is in full range mode.

If Pen_RangeOperatingAutoScale is set to False during run time, new values need to be set for the Pen_RangeOperatingMin and Pen_RangeOperatingMax custom properties. Otherwise, they remain according to the last calculation.

Assign values to the PVRangeOperatingAutoScale custom property

Application Type

Data Type

Custom Property Type

Default Value

Example Custom Property Values

ArchestrA Automation Objects

Boolean

Input

True

Reference to an attribute or a static Boolean value

Pen_RangeOperatingAutoScale=True

InTouch Tags

Discrete

Input

True

Reference to an InTouch tag or a static Boolean value

Pen_RangeOperatingAutoScale=True

The following Wizard options must be set to their listed values to show the Pen_RangeOperatingAutoScale custom property.

  • YAxisRangeType: ClipOutOfRangeValue

  • SymbolMode: Advanced

  • Setpoint: True

  • FullRangeIndicator: True

The Pen_RangeOperatingPercent custom property must be set to an integer percentage to work with the Pen_RangeOperatingAutoScale custom property.

In This Topic
TitleResults for “How to create a CRG?”Also Available in