Energy Metering blocks > Flow Metering (AGA_SI) function block

AGA_SI function block parameters

The following table lists the system parameters for the AGA function block:

Table: AGA  block parameters

Parameter

Units

Description

AGA8_OPT

N/A

Determines whether the AGA8 parameters are entered manually or calculated using the detail method. AGA8 parameters include DEN_FLW, DEN_BASE, ZF, ZB, F_PV, and REL_DEN. AGA8_OPT can be either: 

  • Calculate AGA-8 parameters using Detail Method - Select this option if the fluid is a natural gas.

  • Manually enter the AGA-8 parameters - Select this option for other single-phase, Newtonian fluids under turbulent flow. Manually enter DEN_FLW, DEN_BASE, VISCOSITY, and HTG_VAL (if applicable). Change HTG_VAL, ZF, ZB, F_PV, and REL_DEN to 0.0 when not applicable.

BASE_PRES

kPa (kilo Pascals absolute)

Base pressure. The reference pressure for base density and base volumetric flow.

BASE_TEMP

°C

Base temperature. The reference temperature for base density and base volumetric flow.

BETA_RATIO

N/A

Calculated ratio of orifice bore to pipe inside diameter after temperature correction. Has meaning when METER_TYPE is Differential Pressure.

COMP_SUM

None

The sum of the mole percents in GAS_COMP. If not between 99.995 and 100.005, results in a run-time ERROR_STATE of Gas composition sum not 100% if AGA8_Opt is Calculate AGA-8 parameters using Detail Method.

CURR_ENERGY

GJ (gigajoules)

The currently active accumulation of energy flow.

CURR_HRS_ON

Hours

The currently active accumulation of time with flow through the pipe (IN > LOW_CUT (differential pressure) or VOL_FLW_F > 0.0 (turbine)).

CURR_VOLUME

m3 (cubic meters)

The currently active accumulation of volumetric flow at base conditions.

DEN_BASE

kg/m3 (kilograms per cubic meter)

Mass density at base conditions. When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains its previous value or the value as entered.

DEN_FLW

kg/m3 (kilograms per cubic meter)

Mass density at flowing conditions. When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains its previous value or the value as entered.

ENGY_FLW

GJ/hr (gigajoules per hour)

Instantaneous energy flow.

ERROR_ACT

N/A

Indicates that an error condition is active (0 = no error, 1 = an error condition is active). The error is defined as text in ERROR_STATE.

ERROR_STATE

N/A

The error state of the block. When other than Clear indicates the validity of the calculations is questionable:

  • Gas Composition Sum Not 100% — The sum of the mole percents in GAS_COMP does not equal 100.0 and AGA8_OPT is Calculate AGA-8 parameters using Detail Method. Results in Bad status on output parameters.

  • Invalid Pipe or Orifice Size — Actual beta ratio is less than 0.1 or greater than 0.75, or orifice ID is less than 11.43mm, or pipe ID is less than 48.26mm. Applicable when METER_TYPE is Differential Pressure.

  • Reynolds Number Out of Range — Calculated pipe Reynolds number is less than 4000. Applicable when METER_TYPE is Differential Pressure.

  • AGA-8 Algo Not Convergent — The required iterations exceeded ITERATE_LIM8; thus, the AGA8 algorithm did not converge. Applicable when AGA8_OPT is Calculate AGA-8 parameters using Detail Method.

  • AGA-3 Algo Not Convergent — The required iterations exceeded ITERATE_LIM3; thus, the AGA3 algorithm did not converge. 

F_PV

N/A

Supercompressibility factor. The square root of the ratio of the compressibility factors (base to flowing). When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains its previous value or the value as entered.

GAS_COMP

Mole fractions as percents

An array containing the mole fractions of 21 gas components.  

  1. Methane

  2. Nitrogen

  3. Carbon Dioxide

  4. Ethane

  5. Propane

  6. Water

  7. Hydrogen Sulfide

  8. Hydrogen

  9. Carbon Monoxide

  10. Oxygen

  11. i-Butane

  12. n-Butane

  13. i-Pentane

  14. n-Pentane

  15. n-Hexane

  16. n-Heptane

  17. n-Octane

  18. n-Nonane

  19. n-Decane

  20. Helium

  21. Argon

HTG_VAL

MJ/m3 (megajoules per cubic meter)

Volumetric heating value. Calculated per ISO6976 from the mole fractions in GAS_COMP, the superior calorific values of the components, and compressibility factors of the components (15/15 data).

IN

kPa (kilo Pascals  [differential pressure],

m3/hr (cubic meters per hour [turbine])

When METER_TYPE is Differential Pressure, IN is the measured differential pressure. When METER_TYPE is Turbine, IN is the volumetric flow from a Pulse Input function block.

IS_EXP

N/A

Isentropic exponent of the natural gas or other fluid. Enter the value at expected flowing conditions. The default value is reasonable for natural gases. For an incompressible fluid enter –1.0. Not used when METER_TYPE is Turbine.

ITERATE_LIM3

N/A

The number of iterations limit for the AGA3 mass flow calculation

ITERATE_LIM8

N/A

The number of iterations limit for the AGA8 density and compressibility factor calculations.

LAST_ENERGY

GJ (gigajoules)

The total accumulation of energy flow at the time of the last reset (using TIMER_ACCUM).

LAST_HRS_ON

Hours

The total accumulation of time with flow through the pipe at the time of the last reset (using TIMER_ACCUM.

LAST_VOLUME

m3 (cubic meters)

The total accumulation of base volumetric flow at the time of the last reset (using TIMER_ACCUM).

LOW_CUT

kPa (kilo Pascals gage)

Value of IN (differential pressure) below which flow is assumed to be zero. Not applicable when METER_TYPE is Turbine.

MASS_FLW

kg/hr (kilograms per hour)

Instantaneous mass flow.

METER_TYPE

N/A

Meter type for flow measurement. The value can be Differential Pressure or Turbine.

ORIF_ID

mm (millimeters)

Orifice plate bore diameter at reference temperature ORIF_TEMP. Not applicable when METER_TYPE is Turbine.

ORIF_MAT

N/A

Orifice plate material. The value can be Stainless Steel, Monel, or Carbon Steel. Not applicable when METER_TYPE is Turbine.

ORIF_TEMP

°C

Reference temperature for the orifice plate. Not applicable when METER_TYPE is Turbine.

PCT_CURR_ENERGY

Percent

The percentage of the total in CURR_ENERGY where ENGY_FLW had Good status when the value was accumulated.

PCT_CURR_HRS_ON

Percent

The percentage of the total time in CURR_HRS_ON where VOL_FLW_F had Good status when the time was accumulated.

PCT_CURR_VOLUME

Percent

The percentage of the total in CURR_VOLUME where VOL_FLW_B had Good status when the value was accumulated.

PCT_VOL_ACCUM

Percent

The percentage of the total in VOL_ACCUM where VOL_FLW_B had Good status when the value was accumulated.

PCT_LAST_ENERGY

Percent

The percentage of the total in LAST_ENERGY where ENGY_FLW had Good status when the value was accumulated.

PCT_LAST_HRS_ON

Percent

The percentage of the total time in LAST_HRS_ON where VOL_FLW_F had Good status when the time was accumulated.

PCT_LAST_VOLUME

Percent

The percentage of the total in LAST_VOLUME where VOL_FLW_B had Good status when the value was accumulated.

PIPE_ID

mm (millimeters)

Pipe internal diameter at reference temperature PIPE_TEMP.

PIPE_MAT

N/A

Pipe material. The value can be Stainless Steel, Monel, or Carbon Steel.

PIPE_TEMP

°C

Reference temperature for the pipe ID measurement.

PRES_CHNG

kPa (kilo Pascals)

The amount PRES_IN must differ from its value at the time of the previous AGA-8 calculation to trigger another AGA-8 calculation.

PRES_IN

kPa (kilo Pascals absolute)

Measured static pressure

PRES_TAP

N/A

Location of the static pressure tap, either Upstream or Downstream of the orifice plate. Not applicable when METER_TYPE is Turbine.

RE_NUM

N/A

Calculated Pipe Reynolds number.

REL_DEN

N/A

Real gas relative density (specific gravity). When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains the previous value or the value entered.

RESET_ACCUM

N/A

Resets VOL_ACCUM when greater than zero. The block then changes RESET_ACCUM back to zero.

TAP_TYPE

N/A

Orifice meter tap type: either Flange Taps, Radius Taps (D-D/2), or Corner Taps.

TEMP_CHNG

°C

How much TEMP_IN must change from the last AGA8 calculation temperature in order to trigger another AGA8 calculation.

TEMP_IN

°C

Measured temperature.

TIMER_ACCUM

N/A

When 0, allows the accumulation of CURR_VOLUME, CURR_ENERGY, and CURR_HRS_ON. When greater than 0, copies the three CURR_ parameters to the three LAST_ parameters and resets the CURR_ parameters. TIMER_ACCUM is typically wired from a Date Time Event function block.

VISCOSITY

kg/m-hr (kilograms per meter per hour)

The absolute viscosity of the natural gas or other fluid. Enter the value at expected flowing conditions based on laboratory analysis or other method.

VOL_ACCUM

m3 (cubic meters)

Accumulation of volumetric flow at base conditions. It is reset using RESET_ACCUM, which is expected to be performed manually at irregular time intervals. Similar to CURR_VOLUME, which is also an accumulation of base volumetric flow, but CURR_VOLUME expected to be reset automatically at regular time intervals (using TIMER_ACCUM).

VOL_FLW_B

m3/hr (cubic meters per hour)

Instantaneous volumetric flow at base conditions.

VOL_FLW_F

m3/hr (cubic meters per hour)

Instantaneous volumetric flow at flowing conditions.

ZB

N/A

Compressibility factor at base conditions. When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains its previous value or the value as entered.

ZF

N/A

Compressibility factor at flowing conditions. When AGA8_OPT is Calculate AGA-8 parameters using Detail Method, the value is calculated. Otherwise retains its previous value or the value as entered.

Note

Default values and data type information for the parameters are available by expanding the Parameter View window.