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

Situational Awareness Library

oPVOperatingPercent custom property

  • Last UpdatedAug 06, 2024
  • 2 minute read

The SA_OperatingRange symbol includes the oPVOperatingPercent custom property.

The value of oPVRangeOperatingPercent 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 SA_OperatingRange 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 oPVRangeOperatingAutoScale custom property must be set to True. When oPVRangeOperatingAutoScale is True, the symbol internally calculates updated oPVRangeOperatingMin and oPVRangeOperatingMax custom property values using the following formulas:

  • oPVRangeOperatingMin = Setpoint - (oPVRangeOperatingPercent/100 x Setpoint)

  • oPVRangeOperatingMax = Setpoint + (oPVRangeOperatingPercent/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 oPVRangeFullScaleMin and oPVRangeFullScaleMax custom properties. The SA_Operating Range symbol shows full range flags to indicate that it is in full range mode.

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

Assign values to the oPVRangeOperatingPercent custom property

Application Type

Data Type

Custom Property Type

Default Value

Example Custom Property Values

ArchestrA Automation Objects

Integer

Input

0

Reference to an attribute or a static value.

oPVRangeOperatingPercent=40

InTouch Tags

Integer

Input

0

Reference to an InTouch tag or a static value.

oPVRangeOperatingPercent=OptRangePercent

oPVRangeOperatingPercent=30

Associated Wizard options

  • OperatingAutoScaleEnabled: True

Associated custom properties

  • oPVRangeOperatingAutoScale: True

  • oPVRangeOperatingMax

  • oPVRangeOperatingMin

  • oSP

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