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 |
Related Wizard options and custom properties
Associated Wizard options
-
OperatingAutoScaleEnabled: True
Associated custom properties
-
oPVRangeOperatingAutoScale: True
-
oPVRangeOperatingMax
-
oPVRangeOperatingMin
-
oSP