FMS Validation Rules

The CygNet measurement system contains several categories and types of validation rules. Rules are assigned to validation engines, where they comprise a set of checks against the data for a single associated Node. Each rule can be configured to automatically detect potential problems in your data, according to its configured limits and guidelines. The system processes normalized data for validation rules as it applies to the given data type. Data will be validated by device rules first, and then all other applicable rules will follow.

When configuring rule properties, you can name or rename the rule as desired. If you do not assign a rule name, it will retain the default rule name based on the rule type, as listed in the tables below. Multiple rules in a validation engine can have the same name, although you may want to assign unique names upon rule creation to more easily identify them. See Configuring Validation Rules for more information.

Validation Rule Categories

Validation rules are organized into the following categories, based on affected data types. For each category, available rule types are listed in the corresponding tables below.

See Managing Validation Engines for information about defining validation engines and their associated Nodes.

Configuration Data Rules

The following table lists the available validation rule types for a single configuration record, and each rule's configuration options. Configuration data validation is currently supported for gas device Nodes.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Config Change... validation rules: The system will validate the value of a device configuration item to determine if it has changed.

Config Change - Atmospheric Pressure

Atm Pressure

Gas Device

Liquid Device

The system will validate that the corresponding configuration value has not changed.

Records failing validation will generate an exception.

Note: When a Config Change... rule causes an exception, record values are displayed in the Exceptions control as follows: Except for Config Change - Meter ID record values (for which the new and previous values appear in the Exception Description column), the new value appears in the Value column and the previous value appears in the Limit column.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity

Schedule is "Always Active"

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Config Change - Base Pressure

Base Pressure

Gas Device

Liquid Device

Config Change - Base Temperature

Base Temp

Gas Device

Liquid Device

Config Change - Cone Diameter

Cone Diameter

Gas Device

Liquid Device

Config Change - Contract Hour

Contract Hour

Gas Device

Liquid Device

Config Change - Coriolis Calibration Pressure

Calibrate Pressure

Gas Device

Liquid Device

Config Change - Coriolis Pressure Effect

Pressure Effect

Gas Device

Liquid Device

Config Change - Discharge Coefficient

Discharge Coeff

Gas Device

Liquid Device

Config Change - FPV Calc Method

FPV Calc

Gas Device

Config Change - HV Calc Method

HV Calc

Gas Device

Config Change - Heating Value Volume

HV Volume

Gas Device

Config Change - K Factor Mass

K Factor Mass

Gas Device

Liquid Device

Config Change - K Factor Volume

K Factor Volume

Gas Device

Liquid Device

Config Change - Linear Curve Type

Linear Curve Type

Gas Device

Liquid Device

Config Change - Meter Factor

Meter Factor

Gas Device

Liquid Device

Config Change - Meter ID

Meter ID

Gas Device

Liquid Device

Config Change - Meter Type

Meter Type

Gas Device

Liquid Device

Config Change - Orifice Plate Size

Orifice Plate Size

Gas Device

Liquid Device

Config Change - Primary Calc Method

Primary Calc

Gas Device

Liquid Device

Config Change - Relative Density

Rel Density

Gas Device

Liquid Device

Config Change - Viscosity

Viscosity

Gas Device

Liquid Device

High/Low Limits... validation rules: The system will validate the value of a device configuration item, to determine if it is within the high/low range specified; otherwise the value will be considered out of range and will trigger the exception process.

High/Low Limits - Beta Ratio (Absolute)

Beta Ratio Range

Gas Device

Liquid Device

 

The system will validate that the beta ratio value is within the specified range.

For differential meters (orifice or cone), the system will validate the beta ratio (ratio of orifice/cone diameter to pipe diameter) as follows.

Beta ratio calculation is based on consistent principals, using inputs specific to the device type. Valid beta ratio values are greater than zero and less than one.

  • Orifice - ratio of orifice plate opening (diameter) to meter pipe (inside diameter)
  • Cone - ratio of flow area (largest cross-section, converted to cone diameter) to meter pipe (inside diameter)

Records failing validation will generate an exception.

Specify the Severity, and a Low and High value for the tolerance range.

High/Low Limits - Heating Value Volume (Absolute)

Limit HV Volume

Gas Device

The system will validate that data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values, and will generate an exception.

 

 

Specify the Severity, a Low and High value for the limits, and Units to use

 

 

High/Low Limits - Relative Density (Absolute)

Limit Rel Density

Gas Device

Liquid Device

Specify the Severity, and a Low and High value for the tolerance range.

High/Low Limits - Viscosity (Absolute)

Limit Viscosity

Gas Device

Liquid Device

Specify the Severity, a Low and High value for the limits, and Units to use

System Consistency... validation rules: The system will validate that the item in the configuration record matches the item in the system.

System Consistency - Meter ID

System Consistency

Gas Device

Liquid Device

The system will validate that the meter ID in the configuration record matches the name of the device in the system.

Records failing validation will generate an exception.

Note: When a System Consistency - Meter ID rule causes an exception, record values are displayed in the Exceptions control as follows: The new and previous values appear in the Exception Description column.

Specify the Severity

Schedule is "Always Active"

Back to top

Gas Quality History Rules

The following table lists the available validation rule types for gas quality data from live history records, and each rule's configuration options. These rules will be validated against live gas history data on Nodes that support gas quality data.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Gas Composition Normalization (Percentage)

Gas Comp Norm

Gas Device

Liquid Device

The system will validate that the gas composition adds up to 100% within the specified tolerance.

Records failing validation will generate an exception.

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Sum Tolerance... validation rules: The system will validate that the sum of the components is within the specified tolerance.

Sum of CO2, N2 (Percentage)

Sum of CO2, N2

Gas Device

The system will validate that the sum of the CO2 and N2 components are within the specified tolerance.

Records failing validation will generate an exception.

Specify the Severity, Data quality, and a Low and High percentage value for the tolerance

Sum of iC5, nC5, C6 (Percentage)

Sum of iC5, nC5, C6

Gas Device

The system will validate that the sum of the iC5, nC5, and C6 components are within the specified tolerance.

Records failing validation will generate an exception.

Specify the Severity, Data quality, and a Low and High percentage value for the tolerance

Back to top

Periodic Metering History Rules

The following table lists the available validation rule types for periodic metering history data, and each rule's configuration options.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Alarm Set State

Alarm Set State

Gas Device

Liquid Device

If the device goes into an alarm state, an exception will be generated.

Note: If an exception is generated when polling the same hourly record for multiple history records, the original exception will be resolved automatically. If records from a new data poll fail validation, new exceptions will be generated.

Specify the Severity, and Data quality

Correction Factor... validation rules: The system will validate that the specified item calculation corrections are correct within the specified tolerance (fraction or percentage - as specified).

Volume Correction Factor (Fraction)

VCF Frac

Gas Device

The system will validate that the volume correction factor (VCF) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

Note: Whether an exception is generated or not, the percentage of the recalculated volume vs. the device volume will be stored in the gas metering record. This value will be stored as VCF (Volume Correction Factor) and is calculated by dividing the recalculated volume by the device volume. Use this VCF value to quickly see how far off the recalculated volume was from the device volume. It is also used for recalculation when user edit are made per API 21.1.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Volume Correction Factor (Percentage)

VCF Pct

Gas Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Combined Correction Factor (CCF) (Fraction)

CCF Frac

Liquid Device

The system will validate that the combined correction factor (CCF) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Combined Correction Factor (CCF) (Percentage)

CCF Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Density Correction Factor (DCF) (Fraction)

DCF Frac

Liquid Device

The system will validate that the density correction factor (DCF) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Density Correction Factor (DCF) (Percentage)

DCF Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Pressure Correction Factor (CPL) (Fraction)

CPL Frac

Liquid Device

The system will validate that the correction for the effect of pressure on liquid (CPL) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Pressure Correction Factor (CPL) (Percentage)

CPL Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Sediment and Water Correction Factor (CSW) (Fraction)

CSW Frac

Liquid Device

The system will validate that the sediment and water correction factor (CSW or SWCorrectionFactor) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Sediment and Water Correction Factor (CSW) (Percentage)

CSW Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Temperature Correction Factor (CTL) (Fraction)

CTL Frac

Liquid Device

The system will validate that the correction for the effect of temperature on liquid (CTL) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Temperature Correction Factor (CTL) (Percentage)

CTL Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

Temperature and Pressure Correction Factor (CTPL) (Fraction)

CTPL Frac

Liquid Device

The system will validate that the correction for the effect of temperature and pressure on liquid (CTPL) is within the specified tolerance (fraction or percentage - as specified).

Records failing validation will generate an exception.

 

Specify the Severity, Data quality, and a +/- fractional range for the tolerance

Temperature and Pressure Correction Factor (CTPL) (Percentage)

CTPL Pct

Liquid Device

Specify the Severity, Data quality, and a +/- percentage range for the tolerance

High/Low Flow... Cutoff Range validation rules: The system will validate that devices are operating within the high/low flow range specified; otherwise the value will be considered out of range and will trigger the exception process.

High/Low Flow Cutoff Range - Diff Pressure (Absolute)

Cutoff Flow DP

Gas Device

The system will validate that the flow rate is within the specified range.

Records failing validation are considered "high flow" or "low flow" values, outside the cutoff range, and will generate an exception.

Note: Differential Pressure or Pulse values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, a Low and High value for the cutoff range, and Units to use

High/Low Flow Cutoff Range - Flow Rate (Absolute)

Cutoff Flow Rate

Gas Device

Liquid Device

The system will validate that the flow rate is within the specified range.

Records failing validation are considered "high flow" or "low flow" values, outside the cutoff range, and will generate an exception.

Note: Differential Pressure or Pulse values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, a Low and High value for the cutoff range, and Units to use

High/Low Flow Cutoff Range - Pulses (Absolute)

Cutoff Flow Pulses

Gas Device

Liquid Device

The system will validate that the pulse count is within the specified range.

Records failing validation are considered "high flow" or "low flow" values, outside the cutoff range, and will generate an exception.

Note: Differential Pressure or Pulse values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, and a Low and High value for the cutoff range

High/Low Operational Limit... validation rules: The system will validate that devices are operating within the high/low operational limits specified; otherwise the value will be considered out of range and will trigger the exception process.

High/Low Operational Limits - Diff Pressure (Absolute)

Op Limit DP

Gas Device

The system will validate that gas data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values, outside the operational limits, and will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

 

 

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

 

 

High/Low Operational Limits - Static Pressure (Absolute)

Op Limit SP

Gas Device

High/Low Operational Limits - Temperature (Absolute)

Op Limit Temp

Gas Device

High/Low Operational Limits - Density Pressure (Absolute)

Op Limit Dense Prss

Liquid Device

The system will validate that liquid data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values, outside the operational limits, and will generate an exception.

Note: Density Pressure or Meter Pressure values of null or zero (0) will not trigger exceptions.

 

 

 

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

 

 

 

High/Low Operational Limits - Density Temperature (Absolute)

Op Limit Dense Temp

Liquid Device

High/Low Operational Limits - Meter Pressure (Absolute)

Op Limit Meter Prss

Liquid Device

High/Low Operational Limits - Meter Temperature (Absolute)

Op Limit Meter Temp

Liquid Device

High/Low Reasonability... validation rules: The system will validate that devices are operating within the high/low reasonability limits specified; otherwise the value will be considered out of range and will trigger the exception process.

High/Low Reasonability - Diff Pressure (Absolute)

Reas DP

Gas Device

The system will validate that differential pressure (DP) data values are within the specified range.

Records failing validation are considered "high" or "low" values, outside the reasonability limits, and will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

High/Low Reasonability - Flow Time (Absolute)

Reas Flow Time Abs

Gas Device

Liquid Device

The system will validate that flow time data values are within the specified range.

Records failing validation are considered "high" or "low" values, outside the reasonability limits, and will generate an exception.

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

High/Low Reasonability - Flow Time (Percentage)

Reas Flow Time Pct

Gas Device

Liquid Device

The system will validate that flow time data values are within the specified range by percentage.

Records failing validation are considered "high" or "low" values, outside the reasonability limits, and will generate an exception.

Specify the Severity, Data quality, and a Low and High value for the limits

High/Low Reasonability - Static Pressure (Absolute)

Reas SP

Gas Device

The system will validate that static pressure (SP) data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values, outside the reasonability limits, and will generate an exception.

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

High/Low Reasonability - Temperature (Absolute)

Reas Temp

Gas Device

The system will validate that temperature data values are within the specified range.

Records failing validation are considered "high" or "low" values, outside the reasonability limits, and will generate an exception.

Specify the Severity, Data quality, a Low and High value for the limits, and Units to use

Low Flow... Cutoff Limit validation rules: The system will validate that devices are operating above the low flow limit specified; otherwise the value will be considered out of range and will trigger the exception process.

Low Flow Cutoff Limit - Diff Pressure (Absolute)

Cutoff Low Flow DP

Gas Device

The system will validate that the differential pressure is above the specified limit.

Records failing validation are considered "low flow" values, below the cutoff limit, and will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, a Cutoff value for the cutoff limit, and Units to use

Report Calculation Warning

Rpt Calc Warning

Gas Device

If warnings occur when the system performs a calculation, an exception will be generated.

Specify the Severity, and Data quality

Report Recalculation Failure

Rpt Recalc Failure

Gas Device

If errors occur when the system performs a recalculation, an exception will be generated.

Specify the Severity, and Data quality

Back to top

Historical Data Rules

The following table lists the available validation rule types for previously retrieved (historical) multiple gas quality or periodic metering data records, and each rule's configuration options.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Average... validation rules (gas devices): The system will validate that the reported data does not deviate outside historical averages for the specified number of previous records.

Average - Diff Pressure (Absolute)

Avg DP Abs

Gas Device

The system will validate that the reported data does not go outside a defined range of historical averages for the specified number of previous records.

Records failing validation will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, Data quality, a +/- absolute/percentage range, the last # of records to consider, and Units to use (for absolute rules)

See Notes below.

 

 

 

 

 

 

 

 

 

 

 

Average - Diff Pressure (Percentage)

Avg DP Pct

Gas Device

Average - Energy (Absolute)

Avg Energy Abs

Gas Device

Average - Energy (Percentage)

Avg Energy Pct

Gas Device

Average - Mass (Absolute)

Avg Mass Abs

Gas Device

Average - Mass (Percentage)

Abs Mass Pct

Gas Device

Average Static Pressure (Absolute)

Avg SP Abs

Gas Device

Average - Static Pressure (Percentage)

Avg SP Pct

Gas Device

Average - Temperature (Absolute)

Avg Temp Abs

Gas Device

Average - Temperature (Percentage)

Avg Temp Pct

Gas Device

Average - Volume (Absolute)

Avg Vol Abs

Gas Device

Average - Volume (Percentage)

Avg Vol Pct

Gas Device

Average... validation rules (liquid devices): The system will validate that the device data does not deviate outside historical averages for a specified number of previous records.

Average - Accumulated Energy (Absolute)

Avg Accm Energy Abs

Liquid Device

The system will validate that the reported data does not go outside a defined range of historical averages for the specified number of previous records.

Records failing validation will generate an exception.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, Data quality, a +/- absolute/percentage range, the last # of records to consider, and Units to use (for absolute rules)

See Notes below.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Average - Accumulated Energy (Percentage)

Avg Accm Energy Pct

Liquid Device

Average - Base Density (Absolute)

Avg Base Dens Abs

Liquid Device

Average - Base Density (Percentage)

Avg Base Dens Pct

Liquid Device

Average - Density Pressure (Absolute)

Avg Dens Prss Abs

Liquid Device

Average - Density Pressure (Percentage)

Avg Dens Prss Pct

Liquid Device

Average - Density Temperature (Absolute)

Avg Dens Temp Abs

Liquid Device

Average - Density Temperature (Percentage)

Avg Dens Temp Pct

Liquid Device

Average - Gross Standard Volume (Absolute)

Avg Grs Std Vol Abs

Liquid Device

Average - Gross Standard Volume (Percentage)

Avg Grs Std Vol Pct

Liquid Device

Average - Gross Volume (Absolute)

Avg Gross Vol Abs

Liquid Device

Average - Gross Volume (Percentage)

Avg Gross Vol Pct

Liquid Device

Average - Indicated Volume (Absolute)

Avg Ind Vol Abs

Liquid Device

Average - Indicated Volume (Percentage)

Avg Ind Vol Pct

Liquid Device

Average - Mass (Absolute)

Avg Mass Abs

Liquid Device

Average - Mass (Percentage)

Avg Mass Pct

Liquid Device

Average - Meter Pressure (Absolute)

Avg Meter Prss Abs

Liquid Device

Average - Meter Pressure (Percentage)

Avg Meter Prss Pct

Liquid Device

Average - Meter Temperature (Absolute)

Avg Meter Temp Abs

Liquid Device

Average - Meter Temperature (Percentage)

Avg Meter Temp Pct

Liquid Device

Average - Net Standard Volume (Absolute)

Avg Net Std Vol Abs

Liquid Device

Average - Net Standard Volume (Percentage)

Avg Net Std Vol Pct

Liquid Device

Average - Observed Density (Absolute)

Avg Obs Dens Abs

Liquid Device

Average - Observed Density (Percentage)

Avg Obs Dens Pct

Liquid Device

Average - Sediment and Water Volume (Absolute)

Avg S&W Vol Abs

Liquid Device

Average - Sediment and Water Volume (Percentage)

Avg S&W Vol Pct

Liquid Device

Average - Uncorrected Density (Absolute)

Avg Uncorr Dens Abs

Liquid Device

Average - Uncorrected Density (Percentage)

Avg Uncorr Dens Pct

Liquid Device

Frozen Value... validation rules (gas devices): The system will validate that a device is not incorrectly reporting the same value for a specified number of records. A device repeatedly reporting the same value will be considered frozen.

Frozen Value - Diff Pressure (Absolute)

FrzVal DP Abs

Gas Device

The system will validate that the reported data remains within a defined tolerance range for the specified number of records to be considered frozen.

Records failing validation will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, Data quality, a +/- absolute/percentage tolerance range, the last # of records over which the value needs to remain the same to be considered frozen, and Units to use

See Notes below.

 

 

 

 

 

 

 

 

 

 

 

Frozen Value - Diff Pressure (Percentage)

FrzVal DP Pct

Gas Device

Frozen Value - Energy (Absolute)

FrzVal Energy Abs

Gas Device

Frozen Value - Energy (Percentage)

FrzVal Energy Pct

Gas Device

Frozen Value - Mass (Absolute)

FrzVal Mass Abs

Gas Device

Frozen Value - Mass (Percentage)

FrzVal Mass Pct

Gas Device

Frozen Value - Static Pressure (Absolute)

FrzVal SP Abs

Gas Device

Frozen Value - Static Pressure (Percentage)

FrzVal SP Pct

Gas Device

Frozen Value - Temperature (Absolute)

FrzVal Temp Abs

Gas Device

Frozen Value - Temperature (Percentage)

FrzVal Temp Pct

Gas Device

Frozen Value - Volume (Absolute)

FrzVal Vol Abs

Gas Device

Frozen Value - Volume (Percentage)

FrzVal Vol Pct

Gas Device

Frozen Value... validation rules (liquid devices): The system will validate that a device is not incorrectly reporting the same value for a specified number of records. A device repeatedly reporting the same value will be considered frozen.

Frozen Value - Accumulated Energy (Absolute)

FrzVal Acc En Abs

Liquid Device

The system will validate that the reported data remains within a defined tolerance range for the specified number of records to be considered frozen.

Records failing validation will generate an exception.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, Data quality, a +/- absolute/percentage tolerance range, the last # of records over which the value needs to remain the same to be considered frozen, and Units to use

See Notes below.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Frozen Value - Accumulated Energy (Percentage)

FrzVal Acc En Pct

Liquid Device

Frozen Value - Base Density (Absolute)

FrzVal Base Dns Abs

Liquid Device

Frozen Value - Base Density (Percentage)

FrzVal Base Dns Pct

Liquid Device

Frozen Value - Density Pressure (Absolute)

FrzVal Dns Prss Abs

Liquid Device

Frozen Value - Density Pressure (Percentage)

FrzVal Dns Prss Pct

Liquid Device

Frozen Value - Density Temperature (Absolute)

FrzVal Dns Temp Abs

Liquid Device

Frozen Value - Density Temperature (Percentage)

FrzVal Dns Temp Pct

Liquid Device

Frozen Value - Gross Standard Volume (Absolute)

FrzVal Gr St Vol Abs

Liquid Device

Frozen Value - Gross Standard Volume (Percentage)

FrzVal Gr St Vol Pct

Liquid Device

Frozen Value - Gross Volume (Absolute)

FrzVal Grs Vol Abs

Liquid Device

Frozen Value - Gross Volume (Percentage)

FrzVal Grs Vol Pct

Liquid Device

Frozen Value - Indicated Volume (Absolute)

FrzVal Ind Vol Abs

Liquid Device

Frozen Value - Indicated Volume (Percentage)

FrzVal Ind Vol Pct

Liquid Device

Frozen Value - Mass (Absolute)

FrzVal Mass Abs

Liquid Device

Frozen Value - Mass (Percentage)

FrzVal Mass Pct

Liquid Device

Frozen Value - Meter Pressure (Absolute)

FrzVal Mtr Prss Abs

Liquid Device

Frozen Value - Meter Pressure (Percentage)

FrzVal Mtr Prss Pct

Liquid Device

Frozen Value - Meter Temperature (Absolute)

FrzVal Mtr Temp Abs

Liquid Device

Frozen Value - Meter Temperature (Percentage)

FrzVal Mtr Temp Pct

Liquid Device

Frozen Value - Net Standard Volume (Absolute)

FrzVal Nt St Vol Abs

Liquid Device

Frozen Value - Net Standard Volume (Percentage)

FrzVal Nt St Vol Pct

Liquid Device

Frozen Value - Observed Density (Absolute)

FrzVal Obs Dens Abs

Liquid Device

Frozen Value - Observed Density (Percentage)

FrzVal Obs Dens Pct

Liquid Device

Frozen Value - Sediment and Water Volume (Absolute)

FrzVal S&W Vol Abs

Liquid Device

Frozen Value - Sediment and Water Volume (Percentage)

FrzVal S&W Vol Pct

Liquid Device

Frozen Value - (Absolute)

FrzVal Uncr Dns Abs

Liquid Device

Frozen Value - (Percentage)

FrzVal Uncr Dns Pct

Liquid Device

Minimum Average - Diff Pressure (Absolute)

Min DP Avg

Gas Device

For a gas device, the system will validate that the differential pressure historical average for the specified number of previous records does not go below a minimum threshold value.

Records failing validation will generate an exception.

Note: Differential Pressure values of null or zero (0) will not trigger exceptions.

Specify the Severity, Data quality, a Minimum threshold value, the last # of records to consider, and Units to use

See Notes below.

Notes:

The # of records value means the number of contiguous records prior to the one that currently arrived for validation. If a device supports hourly data, then one hour equals one record. If the PM History span is one hour, and you want to specify an average of one day worth of data, specify "24" and the system will calculate an average of the last 24 records prior to the existing one. This number cannot be "0": a value of zero (0) generates a validation exception for every history record in the date range.

The +/- value defines the absolute or percentage tolerance range. This number cannot be "0": a value of zero (0) generates a validation exception for every history record in the date range. The exception is DP: for Differential Pressure, null or zero (0) tolerance values will not trigger exceptions.

Back to top

Station Rules

The following table lists the available validation rule types for a single gas station record, and each rule's configuration options.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Dynamic Station Run Ratio (Percentage)

StaRun Dyn Ratio

Gas Device

The system will validate that the contributed volume of any single run does not vary from the percentage of the base run, beyond the specified percentage range tolerance.

Records failing validation will generate an exception.

Note: Typically a run is configured with a single meter assigned. Although multiple meters can be assigned to a run, the subsequent meters are used as check devices. Only the first meter is used for purposes of validating the station run ratio.

Specify the Severity, Data quality, and a +/- range for the tolerance, expressed as a percentage value (%)

Default value is 0 %

Note: The percentage you specify is relative to the volume of the base run.

Linked Station Comparison... validation rules: The system will validate that volume, energy, or mass values do not differ between linked stations within the specified tolerance range.

Note: The station to which any Linked Station validation rule applies must be configured with a linked station. This is true for any Node to which the rule is assigned.

Linked Station Comparison - Energy (Absolute)

LStaComp Energy Abs

Gas Device

The system will validate that the data values do not differ between linked stations within the specified absolute/percentage tolerance range.

Records failing validation will generate an exception.

 

 

 

 

 

Specify the Severity, Data quality, a +/- range for the tolerance, and Units to use

 

 

 

 

 

Linked Station Comparison - Energy (Percentage)

LStaComp Energy Pct

Gas Device

Linked Station Comparison - Mass (Absolute)

LStaComp Mass Abs

Gas Device

Linked Station Comparison - Mass (Percentage)

LStaComp Mass Pct

Gas Device

Linked Station Comparison - Volume (Absolute)

LStaComp Vol Abs

Gas Device

Linked Station Comparison - Volume (Percentage)

LStaComp Vol Pct

Gas Device

Station Run Comparison... validation rules: The system will validate that pressure or temperature values for devices in a station do not differ within the specified tolerance range.

Station Run Comparison - Static Pressure (Absolute)

StaRun Comp Press

Gas Device

The system will validate that the pressure for devices in a station does not differ beyond the specified absolute tolerance.

Records failing validation will generate an exception.

Specify the Severity, Data quality, a Greater than value for the tolerance, and Units to use

Station Run Comparison - Temperature (Absolute)

StaRun Comp Temp

Gas Device

The system will validate that the temperature for devices in a station does not differ beyond the specified absolute tolerance.

Records failing validation will generate an exception.

Specify the Severity, Data quality, a Greater than value for the tolerance, and Units to use

Back to top

Gas Analysis Data Rules

The following table lists the available validation rule types for imported gas analysis data, and each rule's configuration options. These rules will be validated against Nodes that support gas analysis data.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Change Limit... validation rules: The system will validate the value of the HVV to determine if it has changed from the value in the previous gas analysis record and, if so, if the change is within the specified tolerance; otherwise the value will be considered to be an "out of range" value.

Change Limit - HVV (As Delivered) (Fraction)

Limit HVV As Del Frc

Gas Device

The system will validate that a change in Heating Value Volume (As delivered) from the previous gas analysis record is within the specified tolerance.

Specify the Severity, a +/- range for the tolerance, and Units to use (fraction)

Change Limit - HVV (As Delivered) (Percentage)

Limit HVV As Del Pct

Gas Device

Specify the Severity, a +/- range for the tolerance, and Units to use (%)

Change Limit - HVV (Dry) (Fraction)

Limit HVV Dry Frc

Gas Device

The system will validate that a change in Heating Value Volume (Wet) from the previous gas analysis record is within the specified tolerance.

Specify the Severity, a +/- range for the tolerance, and Units to use (fraction)

Change Limit - HVV (Dry) (Percentage)

Limit HVV Dry Pct

Gas Device

Specify the Severity, a +/- range for the tolerance, and Units to use (%)

Change Limit - HVV (Wet) (Fraction)

Limit HVV Wet Frc

Gas Device

The system will validate that a change in Heating Value Volume (Dry) from the previous gas analysis record is within the specified tolerance.

Specify the Severity, a +/- range for the tolerance, and Units to use (fraction)

Change Limit - HVV (Wet) (Percentage)

Limit HVV Wet Pct

Gas Device

Specify the Severity, a +/- range for the tolerance, and Units to use (%)

High/Low Limits... validation rules: The system will validate the value of the selected gas analysis data item, to determine if its value is within the high/low range specified; otherwise the value will be considered out of range and will trigger the exception process.

High/Low Limits - Carbon dioxide (Fraction)

Limit CO2 Frc

Gas Device

The system will validate that data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values and will generate an exception.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, a Low and High value for the limits, and Method to use (fraction or %, from the options in the drop-down menu)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

High/Low Limits - Carbon dioxide (Percentage)

Limit CO2 Pct

Gas Device

High/Low Limits - Ethane (Fraction)

Limit Ethane Frc

Gas Device

High/Low Limits - Ethane (Percentage)

Limit Ethane Pct

Gas Device

High/Low Limits - Helium (Fraction)

Limit Helium Frc

Gas Device

High/Low Limits - Helium (Percentage)

Limit Helium Pct

Gas Device

High/Low Limits - Hydrogen Sulfide (Fraction)

Limit H2S Frc

Gas Device

High/Low Limits - Hydrogen Sulfide (Percentage)

Limit H2S Pct

Gas Device

High/Low Limits - Isobutane (Fraction)

Limit Isobutane Frc

Gas Device

High/Low Limits - Isobutane (Percentage)

Limit Isobutane Pct

Gas Device

High/Low Limits - Isopentane (Fraction)

Limit Isopent Frc

Gas Device

High/Low Limits - Isopentane (Percentage)

Limit Isopent Pct

Gas Device

High/Low Limits - Methane (Fraction)

Limit Methane Frc

Gas Device

High/Low Limits - Methane (Percentage)

Limit Methane Pct

Gas Device

High/Low Limits - Nitrogen (Fraction)

Limit Nitrogen Frc

Gas Device

High/Low Limits - Nitrogen (Percentage)

Limit Nitrogen Pct

Gas Device

High/Low Limits - Oxygen (Fraction)

Limit Oxygen Frc

Gas Device

High/Low Limits - Oxygen (Percentage)

Limit Oxygen Pct

Gas Device

High/Low Limits - Propane (Fraction)

Limit Propane Frc

Gas Device

High/Low Limits - Propane (Percentage)

Limit Propane Pct

Gas Device

High/Low Limits - Gas Analysis Relative Density (Absolute)

Limit GA Rel Densit

Gas Device

The system will validate that data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values and will generate an exception.

 

 

 

Specify the Severity, and a Low and High value for the limits (absolute value)

High/Low Limits - Sample Base Pressure (Absolute)

Sample BP

Gas Device

Specify the Severity, and a Low and High value for the limits (absolute value)

High/Low Limits - Sample Base Temperature (Absolute)

Sample BT

Gas Device

Specify the Severity, and a Low and High value for the limits (absolute value)

High/Low Limits - Total Liquid Content (Absolute)

Limit Total Liquid

Gas Device

Specify the Severity, and a Low and High value for the limits (absolute value)

High/Low Limits - n-Butane (Fraction)

Limit n-Butane Frc

Gas Device

The system will validate that data values of the selected type are within the specified range.

Records failing validation are considered "high" or "low" values and will generate an exception.

 

 

 

 

 

 

 

 

 

 

 

 

 

Specify the Severity, a Low and High value for the limits, and Method to use (fraction or %, from the options in the drop-down menu)

 

 

 

 

 

 

 

 

 

 

 

 

 

High/Low Limits - n-Butane (Percentage)

Limit n-Butane Pct

Gas Device

High/Low Limits - n-Decane (Fraction)

Limit n-Decane Frc

Gas Device

High/Low Limits - n-Decane (Percentage)

Limit n-Decane Pct

Gas Device

High/Low Limits - n-Heptane (Fraction)

Limit n-Heptane Frc

Gas Device

High/Low Limits - n-Heptane (Percentage)

Limit n-Heptane Pct

Gas Device

High/Low Limits - n-Hexane (Fraction)

Limit n-Hexane Frc

Gas Device

High/Low Limits - n-Hexane (Percentage)

Limit n-Hexane Pct

Gas Device

High/Low Limits - n-Nonane (Fraction)

Limit n-Nonane Frc

Gas Device

High/Low Limits - n-Nonane (Percentage)

Limit n-Nonane Pct

Gas Device

High/Low Limits - n-Octane (Fraction)

Limit n-Octane Frc

Gas Device

High/Low Limits - n-Octane (Percentage)

Limit n-Octane Pct

Gas Device

High/Low Limits - n-Pentane (Fraction)

Limit n-Pentane Frc

Gas Device

High/Low Limits - n-Pentane (Percentage)

Limit n-Pentane Pct

Gas Device

Source Consistency Check

Source Consistency

Gas Device

The system will validate that the source of the gas analysis sample is consistent with the source configured in the associated Node properties.

Records failing validation will generate an exception.

Specify the Severity

Sum of Gas Composition validation rules: The system will validate the total of the gas composition data items, to determine if the value is within the specified tolerance from 100%; otherwise the value will be considered out of range and will trigger the exception process.

Sum of Gas Composition (Fraction)

Gas Comp Sum Frc

Gas Device

The system will validate that the gas composition total adds up to 100% within the specified tolerance.

Records failing validation will generate an exception.

 

Specify the Severity, a +/- range for the tolerance, and Units to use (fraction)

Sum of Gas Composition (Percentage)

Gas Comp Sum Pct

Gas Device

Specify the Severity, a +/- range for the tolerance, and Units to use (%)

Back to top

Job Rules

The following table lists the available validation rule types for job records, and each rule's configuration options.

Rule Type Default Rule Name Valid Node Categories Description Configuration Options

Calibration Drift Threshold... validation rules: The system will validate the value of the selected job calibration item, over the specified set of contiguous calibration jobs, to determine if the set is within the high/low limit specified; otherwise (if the entire set exceeds the limit) the set of values is considered "out of range" and will trigger the exception process.

Calibration Drift Threshold - Diff Pressure High (Percentage)

Calib Drift DP High

Gas Device

The system will validate that the change in calibration data values is below the defined high drift threshold (by percentage) for the specified number of contiguous calibration jobs.

Records failing validation will generate an exception.

 

 

Specify a High (percentage) drift tolerance, and the # of records to consider

See Notes below.

 

 

Calibration Drift Threshold - Static Pressure High (Percentage)

Calib Drift SP High

Gas Device

Calibration Drift Threshold - Temperature High (Percentage)

Calib Drift T High

Gas Device

Calibration Drift Threshold - Diff Pressure Low (Percentage)

Calib Drift DP Low

Gas Device

The system will validate that the change in calibration data values is above the defined low drift threshold (by percentage) for the specified number of contiguous calibration jobs.

Records failing validation will generate an exception.

 

 

Specify a Low (percentage) drift tolerance, and the # of records to consider

See Notes below.

 

 

Calibration Drift Threshold - Static Pressure Low (Percentage)

Calib Drift SP Low

Gas Device

Calibration Drift Threshold - Temperature Low (Percentage)

Calib Drift T Low

Gas Device

Calibration Drift Range... validation rules: The system will validate the value of the selected job calibration item, over the specified set of contiguous calibration jobs, to determine if the set is within the drift range specified; otherwise (if the entire set is outside the range) the value will be considered "out of range" and will trigger the exception process.

Calibration Drift Range - Diff Pressure (Percentage)

Calib Range DP

Gas Device

The system will validate that the change in calibration data values is within the defined drift range (by percentage) for the specified number of contiguous calibration jobs.

Records failing validation will generate an exception.

 

 

 

Specify a +/- range for the drift tolerance, and the # of records to consider

See Notes below.

 

 

 

Calibration Drift Range - Static Pressure (Percentage)

Calib Range SP

Gas Device

Calibration Drift Range - Temperature (Percentage)

Calib Range T

Gas Device

Number of Calibration Points... validation rules: The system will validate the number of calibration points present for the selected job and data type, to determine if the number in the report matches the value specified; otherwise the value will trigger the exception process.

Number of Calibration Points

- Diff Pressure (Absolute)

# Calib Points DP

Gas Device

The system will validate that the number of calibration points present in the job report matches the specified value.

Records failing validation will generate an exception.

 

 

Specify the Number of points expected to be present

 

 

Number of Calibration Points

- Static Pressure (Absolute)

# Calib Points SP

Gas Device

Number of Calibration Points

- Temperature (Absolute)

# Calib Points Temp

Gas Device

Notes:

The High or Low drift threshold value defines the change tolerance by percentage. If this number is zero (0), the system detects drifts in value (either high or low, as applicable) and generates a validation exception when all (either high or low) records in the set are not of identical value.

The # of records value means the number of contiguous calibration jobs including the one that currently arrived for validation, therefore the value cannot be zero (0). In the event that a calibration test point value standard has been changed within the contiguous record range specified, the values will be ignored (no exceptions generated) until the specified number of calibration report records is generated within the span of the new point value standard.

The +/- value defines the tolerance range by percentage. If this number is zero (0), the system detects any drift in value and generates a validation exception when all records in the set are not of identical value.

Back to top