Alarm Calculation Types

There are several default calculation types which are associated with point types. Other calculation types are available by special configuration.

The configuration of each calculation type is generally done on a point-by-point basis.

The alarm calculation types are assigned to configurable alarm status bits in the domain-wide CVS Metadata file (CvsMetadata.xml), an XML file that defines the configuration for a Point Scheme, colors, alarm priority categories, point state definitions, status bits and definitions, point state instances and definitions, and history value count, for a CygNet domain. This file must reside in the ARS directory and must not be modified without assistance from CygNet Software. See Understanding the CVS Metadata File for more information about the elements and attributes that define a CygNet Point Scheme.

Default Alarm Calculation Types

The following alarm calculation types are available by default in CygNet Software. For more information on each calculation type and examples, see Default Alarm Calculations.

Alarm Calculation Type Description Applies to Point Type
Analog Digital String Enum

Deviation Value

DEVIATION_VAL

The user provides the maximum engineering units threshold. On each update, the system will calculate the engineering units change from the previous value and set the alarm bit if the engineering units change exceeds the threshold.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See Deviation Value for more information.

Check

     

Digital Value Equal

DIGITAL_EQUAL

The user selects the Y/N state (value) for the alarm. On each update, if the value matches this state (value), then the alarm bit is set, otherwise it is cleared.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See Digital Value Equal for more information.

 

Check

   

Maximum Value

MAX_VALUE

The user provides the maximum value threshold for the alarm limit. On each update, the system will check the value and set the alarm bit if it is more than the allowed threshold. This calculation type is used for High Alarm and High Warning.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See Maximum Value for more information.

Check

     

Minimum Value

MIN_VALUE

The user provides the minimum value threshold for the alarm limit. On each update, the system will check the value and set the alarm bit if it is less than the allowed minimum. This calculation type is used for Low Warning and Low Alarm.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See Minimum Value for more information.

Check

     

String Filter (case-insensitive)

STRING_VAL_CI

The user provides a string to compare against. This supports wildcards. On each update, if the new value matches the comparison string without regards to case, the alarm bit is set, otherwise it is cleared.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See String Filter for more information.

   

Check

Check

String Filter (case-sensitive)

STRING_VAL_CS

The user provides a string to compare against. This supports wildcards. On each update, if the new value matches the comparison string with regards to case, the alarm bit is set, otherwise it is cleared.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See String Filter for more information.

   

Check

Check

Value Range

VALUE_RANGE

The user provides the maximum engineering units threshold and the minimum engineering units threshold. On each update, the system will check the value and set the alarm bit if it is outside the allowed range. This will allow a single bit for out-of-range checks.

The system will store a maximum of 60 entries for these calculation types. If more than 60 values come in within the specified time interval, the alarm will never be triggered. The number of historized calculation type values stored in the CVS for a CygNet Standard Point Scheme is fixed at 60 entries and cannot be edited.

See Value Range for more information.

Check

     

Other Alarm Calculation Types

The following alarm calculation types are available by special configuration for a Point Scheme other than the CygNet Standard Point Scheme (0). Contact CygNet Support for more information about enhanced Point Schemes. Also see Point Scheme.

Alarm Calculation Type Description Applies to Point Type
Analog Digital String Enum

Change Rate

CHANGE_RATE

The user provides the maximum allowed number of changes and the time interval in seconds. On each update, if the point value changes more than the maximum allowed times for a given interval, the system will set the alarm bit.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme. This will be used for Digital Chattering alarms, for one example.

See Change Rate Alarm Calculation for more information.

Check

Check

Check

Check

Change Value

CHANGE_VAL

On each update, the system will set the alarm bit if the point’s value is changed. It is cleared every time a point is updated with the same value.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Change Value Alarm Calculations for more information.

Check

Check

Check

Check

Change Value Percent

CHANGE_VAL_PCT

The user provides the maximum percentage threshold and the time interval in seconds. On each update, the system will calculate the percentage change between the new value and the newest value older than the time interval, divided by the time interval in seconds, and set the alarm bit if the absolute value of the percentage change exceeds the threshold.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Change Value Alarm Calculations for more information.

Check

     

Change Value Positive Percent

CHANGE_VAL_POS_PCT

The user provides the maximum percentage threshold and the time interval in seconds. On each update, the system will calculate the percentage change between the new value and the newest value older than the time interval, divided by the time interval in seconds, and set the alarm bit if the percentage change is positive and exceeds the threshold.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Change Value Alarm Calculations for more information.

Check

     

Change Value Negative Percent

CHANGE_VAL_NEG_PCT

The user provides the maximum percentage threshold and the time interval in seconds. On each update, the system will calculate the percentage change between the new value and the newest value older than the time interval, divided by the time interval in seconds, and set the alarm bit if the percentage change is negative and exceeds the threshold. Note that the threshold must still be represented as a positive percentage.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Change Value Alarm Calculations for more information.

Check

     

Creep Average

CREEP_AVG

The user provides the maximum engineering units threshold and the time interval in seconds. On each update, the system will calculate the average from the newest value older than the time interval to (and including) the previous value. The system compares the difference between the average and the update value, and sets the alarm bit if the difference is more than the threshold value.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Creep Alarm Calculations for more information.

Check

     

Creep Value

CREEP_VAL

The user provides the maximum engineering units threshold and the time interval in seconds. On each update, the system will calculate the engineering units change from the newest value older than the time interval, and set the alarm bit if the absolute value of the difference is more than the threshold value specified.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Creep Alarm Calculations for more information.

Check

     

Creep Value Positive

CREEP_VAL_POS

The user provides the maximum engineering units threshold and the time interval in seconds. On each update, the system will calculate the engineering units change from the newest value older than the time interval, and set the alarm bit if the difference is more than the threshold value specified.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Creep Alarm Calculations for more information.

Check

 

 

 

Creep Value Negative

CREEP_VAL_NEG

The user provides the maximum engineering units threshold and the time interval in seconds. On each update, the system will calculate the engineering units change from the newest value older than the time interval, and set the alarm bit if the difference is less than the threshold value specified treated as a negative number.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Creep Alarm Calculations for more information.

Check

 

 

 

Delta Value Over Time

DELTA_OVER_TIME

The following parameters are configurable on a point-by-point basis: the delta and the time interval in seconds. Together these define the rate-of-change. On each update, the CVS will find the first value that is older than the time interval specified, and then:

  • the system calculates the value and time deltas between those two values and then gets the rate from those two values
  • if the rate exceeds the configured rate, the alarm is set, otherwise it is reset.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Delta Over Time Alarm Calculations for more information.

Check

 

 

 

Delta Over Time Positive

DELTA_OVER_TIME_POS

The following parameters are configurable on a point-by-point basis: the delta and the time interval in seconds. Together these define the rate-of-change. On each update, the CVS will find the first value that is older than the time interval specified, and then:

  • the system calculates the value and time deltas between those two values and then gets the rate from those two values
  • if the rate exceeds the configured rate, the alarm is set, otherwise it is reset.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Delta Over Time Alarm Calculations for more information.

Check

     

Delta Over Time Negative

DELTA_OVER_TIME_NEG

The following parameters are configurable on a point-by-point basis: the delta and the time interval in seconds. Together these define the rate-of-change. On each update, the CVS will find the first value that is older than the time interval specified, and then:

  • the system calculates the value and time deltas between those two values and then gets the rate from those two values
  • if the rate is less than the configured rate, the alarm is set, otherwise it is reset.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Delta Over Time Alarm Calculations for more information.

Check

     

Deviation Percent For Time

DEVIATION_PCT_FOR_TIME

The user provides the allowed percent value change and the time interval in seconds. On each update, the system finds both the maximum and minimum values that have been stored over the previous time interval, regardless of when in that time interval they occurred. Then, the percent changes are calculated based on the current value and both the maximum and minimum values. The greater of the absolute value of the two percent deviations is determined. If this percent deviation exceeds the maximum percent deviation, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Percent For Time for more information.

Check

 

 

 

Deviation Percent Positive For Time

DEVIATION_PCT_POS_FOR_TIME

The user provides the allowed percent value change and the time interval in seconds. On each update, the system finds the minimum value that has been stored over the previous time interval, regardless of when in that time interval it occurred. Then, the percent deviation is calculated based on the current value and the minimum value. If the percent deviation exceeds the maximum percent deviation, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Percent Positive For Time for more information.

Check

 

 

 

Deviation Percent Negative For Time

DEVIATION_PCT_NEG_FOR_TIME

The user provides the allowed percent value change and the time interval in seconds. On each update, the system finds the minimum value that has been stored over the previous time interval, regardless of when in that time interval it occurred. Then, the percent deviation is calculated based on the current value and the minimum value. If the percent deviation exceeds the maximum percent deviation, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Percent Negative For Time for more information.

Check

 

 

 

Deviation Value For Time

DEVIATION_VAL_FOR_TIME

The user provides the allowed value change and the time interval in seconds. On each update, the system finds both the maximum and minimum values that have been stored over the previous time interval, regardless of when in that time interval they occurred. Then, the current value is compared to each maximum and minimum value, the numeric differences (deviations) are calculated, and the greater of the two deviations in absolute value is determined. If the absolute value of this deviation exceeds the maximum deviation value, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Value For Time for more information.

Check

 

 

 

Deviation Value Positive For Time

DEVIATION_VAL_POS_FOR_TIME

The user provides the allowed value change and the time interval in seconds. On each update, the system finds the minimum value that has been stored over the previous time interval, regardless of when in that time interval it occurred. Then, the current value is compared to the minimum value and the numeric difference (deviation) is calculated. If the value of this deviation exceeds the maximum deviation value, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Value Positive For Time for more information.

Check

 

 

 

Deviation Value Negative For Time

DEVIATION_VAL_NEG_FOR_TIME

The user provides the allowed value change and the time interval in seconds. On each update, the system finds the maximum value that have been stored over the previous time interval, regardless of when in that time interval it occurred. Then, the current value is compared to the maximum value and the numeric difference (deviation) is calculated. If the absolute value of this deviation exceeds the maximum deviation value, the alarm is set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Value Negative For Time for more information.

Check

 

 

 

Deviation Percent

DEVIATION_PCT

The user provides the maximum percentage threshold. On each update, the system will calculate the percent change from the previous value and set the alarm bit if the percent change exceeds the threshold.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Deviation Percent Alarm Calculation for more information.

Check

     

Duration Alarm

TIMED_ALARMSTATE

The user provides the list of CVS configurable alarm bits to monitor and the time interval in seconds. Whenever the time interval is reached, the system will find the first time all of the listed CVS configurable alarm bits were all set. If that time is before the time interval, the alarm bit will be set.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Duration Alarm Calculation for more information.

Check

Check

Check

Check

Frozen Percent

FROZE_PCT

The user provides the minimum percentage threshold and the time interval in seconds. Whenever the time interval is reached, the system will calculate the percentage change from the newest value older than the time interval and set the alarm bit if the percentage change is less than the threshold.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Frozen Alarm Calculations for more information.

Check

     

Frozen Value

FROZE_VAL

The user provides the time interval in seconds. Whenever the time interval is reached, the system will set the alarm bit if the point’s value has not changed in this time period. It is cleared every time a point is updated with a different value. The time interval is relative to the time that the CVS received the point value, not relative to the time of the point value’s timestamp. That is, if the value is posted in the past or in the future, it can still get marked as frozen.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme.

See Frozen Alarm Calculations for more information.

Check

Check

Check

Check

Frozen Value with Delay

FROZE_VAL_DELAY

The user provides the minimum engineering units threshold and the time interval in seconds. Whenever the time interval is reached, the system will calculate the change in engineering units from the newest value older than the time interval and set the alarm bit if the change is less than the threshold.

The number of entries stored for this calculation is specified by the histvaluecount attribute in the CvsMetadata file for a CygNet Enhanced Point Scheme. An engineering unit of 1 and a time interval of 00:01:00 means the value must change by at least 1 engineering unit from the value of 1 hour ago.

See Frozen Alarm Calculations for more information.

Check

     

Out-of-Range Enumeration

OOR_ENUM

The user provides an update option of Update Value, Leave Value, or Retain Old Value. On each update, if the setpoint value is not in the enumeration table, the following updates take place:

  1. If the update option Update Value is selected and a table entry of _OOR_ is found in the enumeration table, the point value is updated to the table entry for _OOR_.
  2. If _OOR_ is not found, or if the update option is Leave Value, then the point value is left unchanged.
  3. If the Update Option is Retain Old Value, the new value will be changed to the old value presently in the CVS. If the calculation type is enabled, the bit will be set if the setpoint value is not in the enumeration table, otherwise, it is cleared.
     

Check

All Bits Set From List

ALL_BITS

The user provides a list of CVS status bits by name in the reference bits for the calculation type. If all of the provided status bits are set in the Base Status or Extended Status bits, the alarm bit is set, otherwise it is cleared. The bits are listed in the CvsMetadata file.

See Bit(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check

Any Bit Set From List

ANY_BIT

The user provides a list of CVS status bits by name in the reference bits for the calculation type. If any of the provided status bits are set in the Base Status or Extended Status bits, the alarm bit is set, otherwise it is cleared. The bits are listed in the CvsMetadata file.

See Bit(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check

Not All Bits Set From List

NOT_ALL_BITS

The user provides a list of CVS status bits by name in the reference bits for the calculation type. If not all of the provided status bits are set in the Base Status or Extended Status bits, the alarm bit is set, otherwise it is cleared. The bits are listed in the CvsMetadata file.

See Bit(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check

All PNT Y/N Fields Set From List

ALL_PNT

The user provides a list of PNT Boolean attributes by name in the reference bits for the calculation type. If all of the provided Boolean attributes are set on the PNT record, the alarm bit is set, otherwise it is cleared.

See PNT Y/N Field(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check

Any PNT Y/N Field Set From List

ANY_PNT

The user provides a list of PNT Boolean attributes by name in the reference bits for the calculation type. If any of the provided Boolean attributes are set on the PNT record, the alarm bit is set, otherwise it is cleared.

See PNT Y/N Field(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check

Not All PNT Y/N Fields Set From List

NOT_ALL_PNT

The user provides a list of PNT Boolean attributes by name in the reference bits for the calculation type. If not all of the provided Boolean attributes are set on the PNT record, the alarm bit is set, otherwise it is cleared.

See PNT Y/N Field(s) Set From List Alarm Calculations for more information.

Check

Check

Check

Check


More:

ArrowDeviation For Time Calculations

Back to top