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

Situational Awareness Library

Pen_RangeOperatingPercent custom property

  • Last UpdatedAug 06, 2024
  • 2 minute read

The value of Pen_RangeOperatingPercent sets 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. Operators can glance at a set of symbols and quickly identify which measured value is in an abnormal state

In order to set a percent operating range around a setpoint during run time, the PVRangeOperatingAutoScale custom property must be set to True. When Pen_RangeOperatingAutoScale is True, the symbol internally calculates updated Pen_RangeOperatingMin and Pen_RangeOperatingMax custom property values using the following formulas:

  • PVRangeOperatingMin = Setpoint - (PVRangeOperatingPercent/100 x Setpoint)

  • PVRangeOperatingMax = Setpoint + (PVRangeOperatingPercent/100 x Setpoint)

    Note: Make sure the object attribute references to both custom properties are writable 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 Pen_RangeOperatingPercent custom property

Application Type

Data Type

Custom Property Type

Default Value

Example Custom Property Values

ArchestrA Automation Objects

Integer

Input

50

Reference to an ArchestrA Boolean object attribute or a static integer value

Pen_RangeOperatingPercent=40

InTouch Tags

Integer

Input

50

Reference to an InTouch Boolean tag or a static integer value

Pen_RangeOperatingPercent=OptRangePercent

Pen_RangeOperatingPercent=30

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

  • YAxisRangeType: ClipOutOfRangeValue

  • SymbolMode: Advanced

  • Setpoint: True

  • FullRangeIndicator: True

The Pen_RangeOperatingAutoScale custom property must be set to True to work with the Pen_RangeOperatingPercent custom property. Also, the Setpoint custom property must be assigned a value to calculate the expected operating range set by the Pen_RangeOperatingPrecent custom property.

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