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 |
Related Wizard options and custom properties
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.