Spirit flow-x, Function Reference

Page 1: ...Function Reference Certified flow calculations Flow and batch calculations Worksheet functions...

Page 2: ...wholly or in part used or disclosed without the prior consent of Spirit IT B V and then on condition only that this notice is included in any reproduction or disclosure The copyright and the foregoin...

Page 3: ...3 19 fxAGA10_M 3 22 fxAGA10ex_M 3 24 fxAGA3_C 3 27 fxAGA5_C 3 33 fxAGA8_C 3 34 fxAGA8_M 3 36 fxAGA8_Gross 3 38 fxAPI_Dens15C_1952 3 40 fxAPI_Dens15C_1980 3 43 Chapter 4 Flow X General functions 4 49...

Page 4: ...xAPI_Table54_2004 4 156 fxAPI_Table54E 4 158 fxAPI_Table59_2004 4 159 fxAPI_Table59E 4 161 fxAPI_Table60_2004 4 162 fxAPI_Table60E 4 164 fxASTM_D1550_RD60 4 165 fxASTM_D1550_Ctl 4 167 fxASTM_D1555_Den...

Page 5: ...PeriodTotal 4 258 fxPeriodTWA 4 260 fxPeriodWatch 4 261 fxPID 4 262 fxROCAlarm 4 269 fxSarasota_C 4 269 fxSarasota_M 4 271 fxSetOnChange 4 273 fxSetOnCondition 4 273 fxSetOnEvent 4 274 fxSetIndexOnCha...

Page 6: ...319 fxSetFrequencyOutput 5 320 fxDoubleChronometry 5 321 fxPulseInput 5 324 fxResetPulseInputErrors 5 327 fxPulseOutput 5 328 fxSetPulseOutput 5 329 fxPT100Input 5 329 fxRTDInput 5 330 fxPT100Table 5...

Page 7: ...ch new release of a document All software packages and software modules or components will be provided with a version number This number consists of three parts A release number a major revision numbe...

Page 8: ...n that takes all 55 components of the standard Added GERG2004 and GERG2008 functions Revision A 5 Author J C H M van Dal Date February 2015 Minor editorial changes Revision A 6 Author J C H M van Dal...

Page 9: ...units correction of density or correction of volume The 1952 tables that have to do with the conversion of density and volume are 5 6 23 24 53 and 54 Table 5 6 23 and 24 convert density or volume to...

Page 10: ...ensity to cover lower temperatures and higher densities The previous standard used a significant digit format which resulted in 4 or 5 decimal places depending on whether the observed temperature was...

Page 11: ...ASTM Publication Temperature Correction for the volume of Light Hydrocarbons Tables 24E and 23E Superseded by API MPMS Chapter 11 2 4 GPA TP 25 was published in 1998 and replaced the 1952 tables 23 2...

Page 12: ...1 1984 RD 60 F Pe RD T P API_Table53 1980 API 11 1 1980 Tables 53A 53B and 53D API 11 2 1M 1984 Density T P Density 15 C Pe API_Table54 1980 API 11 1 1980 Tables 54A 54B and 54D API 11 2 1M 1984 Dens...

Page 13: ...were obtained from extrapolation and lie within the Extrapolated range It is recommended not to use API 2540 outside the Data and Extrapolated ranges For the lubricating oil tables no difference is ma...

Page 14: ...edure without any rounding and truncating being applied For tables 6A 6B 24A 24B and 54A and 54B the standard makes a distinction between computational and table values for the calculated VCF The tabl...

Page 15: ...8 0 0 Transition area B 1489 0670 0 0 0 00186840 Jet fuels B 330 3010 0 0 0 0 Fuel oils B 103 8720 0 2701 0 0 Lubricating oils D 0 0 0 34878 0 0 API constants in metric units For the tables in metric...

Page 16: ...2 16 Flow X Function Reference Introduction API Petroleum Measurement Tables This page is left blank intentionally...

Page 17: ...nge Default Name Cell A value Input value as percentage of span of cell A Cell A status Input status of cell A 0 Normal 0 Failure Cell B value Input value as percentage of span of cell B Cell B status...

Page 18: ...hen cell A value is above or equal to the switch up percentage of its range and cell B is healthy Select cell B when cell A fails while cell B is healthy When cell B is currently selected Select cell...

Page 19: ...B Cell B status Input status of cell B 0 Normal 0 Failure Cell C value Input value as percentage of span of cell C Cell C status Input status of cell C 0 Normal 0 Failure Range type For a description...

Page 20: ...nd cell A is healthy Select cell A when cell B fails while cell A is healthy Select cell C when cell B and cell A fail and cell C is healthy When cell C is currently selected Select cell B when cell B...

Page 21: ...hen cell A value fails and cell B is healthy Select cell C when cell A and cell B fail and cell C is healthy When cell B is currently selected Select cell A when cell A is healthy and Auto switchback...

Page 22: ...tails on the actual limit values used by this function to set output Range Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag gro...

Page 23: ...ce 3 23 Flow X General functions fxAGA10_M 2 Out of Range One or more inputs outside the Extended Range using the AGA10 calculation is not recommended in this case Calculations Calculations are as doc...

Page 24: ...fxAGA8 function for details on the actual limit values used by this function to set output Range Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag d...

Page 25: ...MASSCV Ideal gas isobaric heat capacity kJ kmol K MOLCP0 Real gas isobaric heat capacity kJ kmol K MOLCP Real gas isochoric heat capacity kJ kmol K MOLCV Ratio of specific heats CPCV Isentropic expon...

Page 26: ...3 26 Flow X Function Reference Flow X General functions fxAGA10ex_M calculation is not recommended in this case Calculations Calculations are as documented in the standard...

Page 27: ...e of the fluid at metering conditions F 400 200 0 0 Density Down or upstream density of the fluid at metering conditions lbm ft3 0 200 0 Dynamic Viscosity Dynamic viscosity of the fluid lbm ft s DYNVI...

Page 28: ...tapping t2 3 Recovered pressure Input Temperature represents the downstream temperature at a location Where the pressure has fully recovered t3 Since temperature measurement is usually downstream of t...

Page 29: ...ils refer to section function ISO5167 Orifice Density correction DENSE XP 0 Fluid The type of fluid being measured 1 Gas 2 Liquid For liquid the expansion factor is set to 1 i e the fluid is considere...

Page 30: ...Density at upstream tapping 1 lbm ft3 DENSUP 0 Density at downstream tapping Pressure at downstream tapping 2 lbm ft3 DENSDN 0 Downstream density Fully recovered downstream density 3 lbm ft3 DENSREV...

Page 31: ...tapping psia p3 Fully recovered downstream pressure psia p Differential pressure inH20 60 F pLOSS Pressure loss over the meter psi C Discharge coefficient as calculated by the standard Flow coefficien...

Page 32: ...pping psia p3 Fully recovered downstream pressure psia Isentropic exponent KTE Temperature exponent Density correction When input Density exponent 0 then the following isentropic corrections are appli...

Page 33: ...on monoxide O2 Oxygen He Helium Sum of these fractions may not exceed 1 molar fraction COMP 0 1 0 Specific Gravity Molar Mass Ratio i e ratio of the molar mass of the gas and of the molar mass of air...

Page 34: ...the AGA 8 calculation for gas mixtures that lie outside the Expanded range is not recommended Input value Normal Range Expanded Range EU Pressure 0 20000 0 20000 psia Temperature 200 400 200 400 F Mo...

Page 35: ...outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No convergence 4 Mole fractions do not add up to 1 0 0 0001 STS FIOOR CALCERR NOCONV COMPER...

Page 36: ...e AGA 8 calculation for gas mixtures that lie outside the Expanded range is not recommended Input value Normal Range Expanded Range EU Pressure 0 1379 0 1379 bar a Temperature 129 204 129 204 C Mole f...

Page 37: ...on outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No convergence 4 Mole fractions do not add up to 1 0 0 0001 STS FIOOR CALCERR NOCONV COMP...

Page 38: ...the Detailed Characterization Method Input value Normal Range EU Temperature 32 130 F Pressure 0 1200 psia Gross heating value 475 1210 Btu ft3 Relative density 0 554 0 87 Carbon dioxide 0 00 0 30 mol...

Page 39: ...rmal 1 Input argument out of range 2 Calculation error 3 No convergence STS FIOOR CALCERR NOCONV Compressibility factor 1 Molar mass lb lbmo l 0 Density Density at observed pressure and temperature lb...

Page 40: ...ement Tables Metric Edition Metric Units of Measurement 1952 API MPMS 11 2 1M Compressibility Factors for Hydrocarbons 638 1074 Kilograms per Cubic Meter Range First Edition August 1984 Function input...

Page 41: ...CTL the combination of input values is 0 In Range 1 Out of Range CTLOOR 0 CPL calc out of range With respect to the standard used for the calculation of CPL the combination of input values is 0 In Ra...

Page 42: ...sity values is 0 0001 Conversion method 2 from standard to observed conditions The function performs straightforward calculations to determine the Density at observed conditions 1 The CTL value is cal...

Page 43: ...lues is implemented such that the example calculations as specified in both standards are exactly reproduced Compliance API MPMS 11 1 Volume X API Standard 2540 Table 53A Generalized Crude Oils Correc...

Page 44: ...n Area 5 B Jet Fuels 6 B Fuel Oil 7 D Lubricating Oil PRDTYP 1 API 2540 rounding 0 Disabled The calculations are performed with full precision and the final CTL value is rounded as specified by input...

Page 45: ...rdance with table 53 Hydrometer correction Only applies for conversion method 1 From observed to standard conditions 0 Disabled 1 Enabled HYDROCOR 0 API 11 2 1M rounding 0 Disabled The calculation of...

Page 46: ...TL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha Thermal expansion factor 1 C ALPHA 0 F Compressibili...

Page 47: ...rounding is enabled then the density and temperature are rounded and the calculations are performed in accordance with the rounding and truncating rules of the standard 10 The CPL value is calculated...

Page 48: ...s rounded to 4 or 5 decimal places or not rounded at all 6 The compressibility factor is calculated according to API MPMS 11 2 1M from the input density and temperature If API 11 2 1M rounding is enab...

Page 49: ...nge Default Name Cell A value Input value as percentage of span of cell A Cell A status Input status of cell A 0 Normal 0 Failure Cell B value Input value as percentage of span of cell B Cell B status...

Page 50: ...hen cell A value is above or equal to the switch up percentage of its range and cell B is healthy Select cell B when cell A fails while cell B is healthy When cell B is currently selected Select cell...

Page 51: ...B Cell B status Input status of cell B 0 Normal 0 Failure Cell C value Input value as percentage of span of cell C Cell C status Input status of cell C 0 Normal 0 Failure Range type For a description...

Page 52: ...nd cell A is healthy Select cell A when cell B fails while cell A is healthy Select cell C when cell B and cell A fail and cell C is healthy When cell C is currently selected Select cell B when cell B...

Page 53: ...hen cell A value fails and cell B is healthy Select cell C when cell A and cell B fail and cell C is healthy When cell B is currently selected Select cell A when cell A is healthy and Auto switchback...

Page 54: ...function for details on the actual limit values used by this function to set output Range Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag descrip...

Page 55: ...eneral functions fxAGA10_M values have higher uncertainty 2 Out of Range One or more inputs outside the Extended Range using the AGA10 calculation is not recommended in this case Calculations Calculat...

Page 56: ...fxAGA8 function for details on the actual limit values used by this function to set output Range Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag d...

Page 57: ...MASSCV Ideal gas isobaric heat capacity kJ kmol K MOLCP0 Real gas isobaric heat capacity kJ kmol K MOLCP Real gas isochoric heat capacity kJ kmol K MOLCV Ratio of specific heats CPCV Isentropic expon...

Page 58: ...4 58 Flow X Function Reference Flow X General functions fxAGA10ex_M calculation is not recommended in this case Calculations Calculations are as documented in the standard...

Page 59: ...e of the fluid at metering conditions F 400 200 0 0 Density Down or upstream density of the fluid at metering conditions lbm ft3 0 200 0 Dynamic Viscosity Dynamic viscosity of the fluid lbm ft s DYNVI...

Page 60: ...tapping t2 3 Recovered pressure Input Temperature represents the downstream temperature at a location Where the pressure has fully recovered t3 Since temperature measurement is usually downstream of t...

Page 61: ...67 Orifice Density correction DENSE XP 0 Fluid The type of fluid being measured 1 Gas 2 Liquid For liquid the expansion factor is set to 1 i e the fluid is considered to be incompressible FLUID 0 Drai...

Page 62: ...ft 3 DENSUP 0 Density at downstream tapping Pressure at downstream tapping 2 lbm ft 3 DENSDN 0 Downstream density Fully recovered downstream density 3 lbm ft 3 DENSREV 0 Reynolds number The pipe Reyno...

Page 63: ...e at downstream tapping psia p3 Fully recovered downstream pressure psia p Differential pressure inH20 60 F pLOSS Pressure loss over the meter psi C Discharge coefficient as calculated by the standard...

Page 64: ...he downstream tapping psia p3 Fully recovered downstream pressure psia Isentropic exponent KTE Temperature exponent Density correction When input Density exponent 0 then the following isentropic corre...

Page 65: ...on monoxide O2 Oxygen He Helium Sum of these fractions may not exceed 1 molar fraction COMP 0 1 0 Specific Gravity Molar Mass Ratio i e ratio of the molar mass of the gas and of the molar mass of air...

Page 66: ...the AGA 8 calculation for gas mixtures that lie outside the Expanded range is not recommended Input value Normal Range Expanded Range EU Pressure 0 20000 0 20000 psia Temperature 200 400 200 400 F Mo...

Page 67: ...outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No convergence 4 Mole fractions do not add up to 1 0 0 0001 STS FIOOR CALCERR NOCONV COMPER...

Page 68: ...e AGA 8 calculation for gas mixtures that lie outside the Expanded range is not recommended Input value Normal Range Expanded Range EU Pressure 0 1379 0 1379 bar a Temperature 129 204 129 204 C Mole f...

Page 69: ...on outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No convergence 4 Mole fractions do not add up to 1 0 0 0001 STS FIOOR CALCERR NOCONV COMP...

Page 70: ...d recommends to use the Detailed Characterization Method Input value Normal Range EU Temperature 32 130 F Pressure 0 1200 psia Gross heating value 475 1210 Btu ft3 Relative density 0 554 0 87 Carbon d...

Page 71: ...allbac k Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No convergence STS FIOOR CALCERR NOCONV Compressibility factor 1 Molar mass lb lbmo l 0 Density Density at observed pressur...

Page 72: ...dition Metric Units of Measurement 1952 API MPMS 11 2 1M Compressibility Factors for Hydrocarbons 638 1074 Kilograms per Cubic Meter Range First Edition August 1984 Function inputs Remark EU SW tag Ra...

Page 73: ...R 0 CPL calc out of range With respect to the standard used for the calculation of CPL the combination of input values is 0 In Range 1 Out of Range CPLOOR 0 Calculations The calculations depend on the...

Page 74: ...ndard to observed conditions The function performs straightforward calculations to determine the Density at observed conditions 5 The CTL value is calculated according to API 1952 Table 54 6 The compr...

Page 75: ...lues is implemented such that the example calculations as specified in both standards are exactly reproduced Compliance API MPMS 11 1 Volume X API Standard 2540 Table 53A Generalized Crude Oils Correc...

Page 76: ...g Oil PRDTYP 1 API 2540 rounding 0 Disabled The calculations are performed with full precision and the final CTL value is rounded as specified by input CTL decimal places 1 Enabled for computational v...

Page 77: ...f the compressibility factor F is performed with full precision 1 Enabled API MPMS 11 2 1M rounding and truncating rules are applied The compressibility factor F is rounded to 3 decimal places as spec...

Page 78: ...dard used for the calculation of CTL the combination of input values is 0 In Range 1 Out of Range CTLOOR 0 CPL calc out of range With respect to the standard used for the calculation of CPL the combin...

Page 79: ...difference between two consecutive density values is either 0 05 or 0 07 for the transition area or 0 000001 depending of API2540 rounding being enabled or not 14 For refined products the entire iter...

Page 80: ..._Dens15C_1980 15 The CPL value is calculated from the compressibility factor and the Observed pressure and Equilibrium pressure input values 16 The density at 15 C equilibrium pressure is calculated b...

Page 81: ...S 11 2 5 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 GPA TP 15 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 also covers GPA TP 15 1988 API...

Page 82: ...ng applied 1 Enabled Rounding as defined in GPA TP15 1988 API MPMS 11 2 2 Addendum 1994 TP15RND 0 P100 Correlation Only used when Equilibrium pressure mode is set to GPA TP 15 0 Disabled The standard...

Page 83: ...unded according to input API 11 2 2M rounding CPL 1 CTPL Combined volume correction factor CTPL CTL CPL CTPL 1 F Compressibility factor The output value will be either rounded or not depending input A...

Page 84: ...quilibrium pressure 1 When API 11 2 4 rounding is enabled the input density and temperature values are rounded in accordance with the standard 2 At the start of the iteration the density at 15 C equil...

Page 85: ...ing is enabled Limit 0 05 kg m3 else if GPA TP 15 rounding is enabled Limit 0 005 kg m3 else Limit 0 00001 kg m3 14 If API 11 2 4 rounding is enabled then the density at 15 C equilibrium pressure is r...

Page 86: ...C API MPMS 11 2 5 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 GPA TP 15 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 also covers GPA TP 15...

Page 87: ...unding 0 Disabled Full precision no rounding and truncating applied 1 Enabled Rounding as defined in GPA TP15 1988 API MPMS 11 2 2 Addendum 1994 TP15RND 0 P100 Correlation 0 Disabled The standard corr...

Page 88: ...correction factor for temperature Value will be rounded according to input API 11 2 4 rounding CTL 1 CPL Volume correction factor for pressure Value will be rounded according to input API 11 2 2M rou...

Page 89: ...3 46 C T 60 C CPLOOR 0 GPA TP 15 out of range Only set when the GPA TP 15 calculation is enabled With respect to the GPA TP 15 standard the combination of input values is 0 In Range 1 Out of Range The...

Page 90: ...sity at 15 C equilibrium pressure For this purpose the relative density at 15 C equilibrium pressure is calculated according to Table 24E from the relative density at 60 F equilibrium pressure and at...

Page 91: ...ose the relative density at 15 C equilibrium pressure is calculated according to Table 24E from the relative density at 60 F equilibrium pressure and at 15 C This relative density value is then conver...

Page 92: ...1 Compressibility Factors for Hydrocarbons 0 90 API Gravity Range First Edition August 1984 Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag descr...

Page 93: ...0 In Range 1 Out of Range CPLOOR 0 Calculations The calculations depend on the conversion method Conversion method 1 from observed to standard conditions The function performs the following iterative...

Page 94: ...rd calculations to determine the API Gravity at observed conditions 2 The CTL value is calculated according to API 1952 Table 6 3 Because API 11 2 1 requires the API gravity value at 60 F the API grav...

Page 95: ...ty to API Gravity at 60 F First Edition August 1980 API MPMS 11 1 Volume XIII Table 5D Generalized Lubricating Oils Correction of Observed API Gravity to API Gravity at 60 F January 1982 API MPMS 11 1...

Page 96: ...pecified in Table 6 meaning that the CTL value has 4 decimal places in all cases 3 Enabled with 5 decimal places API 2540 rounding and truncating rules are applied and in case of conversion method 2 s...

Page 97: ...essure or the observed temperature and pressure API API 0 CTL Volume correction factor for temperature Value will be rounded according to input API2540 rounding CTL 1 CPL Volume correction factor for...

Page 98: ...a factor and the differential temperature observed temperature 60 F If API2540 rounding is enabled then the intermediate results are rounded or truncated as specified API 2540 Table 5 8 Depending on t...

Page 99: ...the input API gravity 4 The Alpha factor is calculated according from the density at 60 F equilibrium pressure and the K0 K1 and K2 factor If API2540 rounding is enabled then the intermediate results...

Page 100: ...ard is the printed table It also includes the Calculation Procedure to obtain the table values based on the rounding and truncating of all input intermediate and output values The function provides th...

Page 101: ...Calculation out of range With respect to the standard the input values are 0 In Range 1 Out of Range OOR 0 Calculations The calculations are in either full or partial compliance with the standards dep...

Page 102: ...y Turbine or Displacement Meters Data Limits API MPMS 11 2 1M defines the following limits on the input values 638 to 1074 kg m3 30 to 90 C 0 to 103 bar g It is advised not to use the standard outside...

Page 103: ...PI 11 2 1M rounding 1 bar F 0 Calculation out of range With respect to the standard the input values are 0 In Range 1 Out of Range OOR 0 Calculations The calculations are in either full or partial com...

Page 104: ...ure Rankin Pseudo Critical Temperature 0 96 With Pseudo Critical Temperature Rankin 621 418 822 686 RD60 1737 86 RD60 2 Observed Temperature Rankin Observed Temperature F 459 7 API Rounding The actual...

Page 105: ...uts Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error STS FIOOR CALCERR 1 CPL Volume correction factor for pressure Value will be rounded according to i...

Page 106: ...the check on the pseudo critical temperature as defined for fxAPI_MPMS_11_2_2 is applied Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Density at...

Page 107: ...output value will be either rounded or not depending input API 11 2 2M rounding 1 bar F 0 Calculation out of range With respect to the standard the input values are 0 In Range 1 Out of Range OOR 0 Ca...

Page 108: ...lculations are performed with full precision A convergence limit of 1e 10 lbm ft3 will be applied for the iterative calculations 1 Enabled The calculations are performed in full compliance with the st...

Page 109: ...pressure psia 0 2000 0 API rounding 0 Disabled The calculations are performed with full precision A convergence limit of 1e 10 lbm ft3 will be applied for the iterative calculations 1 Enabled The calc...

Page 110: ...ure Equilibrium pressure at the observed temperature Also referred to as vapor pressure or saturated pressure psia EQUIPRES 0 Calculation out of range With respect to the standard the input values are...

Page 111: ...xample calculations as specified in both standards are exactly reproduced Compliance API MPMS 11 1 Volume X API Standard 2540 Table 23A Generalized Crude Oils Correction of Observed Relative Density t...

Page 112: ...ces if CTL 1 5 decimal places if CTL 1 2 Enabled for table value API 2540 rounding and truncating rules are applied and in case of conversion method 2 standard to observed the table value for CTL as s...

Page 113: ...han atmospheric pressure in compliance with API MPMS 12 2 par 12 2 5 4 psig EQUIPRES 0 2000 0 Conversion method 1 From observed to standard conditions 2 From standard to observed conditions CONVERSIO...

Page 114: ...sity 3 The hydrometer correction on the observed density is applied provided that this correction is enabled 4 At the start of the iteration the initial value for density and relative density at 60 F...

Page 115: ...000001 depending of API2540 rounding being enabled or not 19 For refined products the entire iteration loop is repeated if the relative density at 60 F equilibrium pressure appears to be in a differe...

Page 116: ...then the input density and temperature are rounded and the calculations are performed in accordance with the rounding and truncating rules of the standard 9 The CPL value is calculated from the compre...

Page 117: ...t Tables American Edition United States Units of Measurement 1952 API MPMS 11 2 1 Compressibility Factors for Hydrocarbons 0 90 API Gravity Range First Edition August 1984 Function inputs Remark EU SW...

Page 118: ...ge With respect to the standard used for the calculation of CPL the combination of input values is 0 In Range 1 Out of Range CPLOOR 0 Calculations The calculations depend on the conversion method Conv...

Page 119: ...Conversion method 2 from standard to observed conditions The function performs straightforward calculations to determine the Specific Gravity at observed conditions 1 The CTL value is calculated acco...

Page 120: ...50 F to 140 F Metering Temperature Second Edition October 1986 API MPMS 11 2 5 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 GPA TP 15 A Simplified Vapor Pressure Correla...

Page 121: ...D 0 P100 Correlation 0 Disabled The standard correlation is commonly used for pure products such as propane butane and natural gasoline It only requires the relative density and the temperature to cal...

Page 122: ...ted by GPA TP 15 Will be set to 0 when equilibrium pressure is below atmospheric pressure psia EQUIPC UR 0 CTL calc out of range With respect to the API 11 2 4 standard the combination of input values...

Page 123: ...essure mode either value of input Equilibrium pressure value is used or the equilibrium pressure vapor pressure is calculated according to GPA TP 15 Whether the GPA TP 15 rounding and truncation rules...

Page 124: ...re 3 Depending on the value of input Equilibrium pressure mode either value of input Equilibrium pressure value is used or the equilibrium pressure vapor pressure is calculated according to GPA TP 15...

Page 125: ...tion and tag group Observed API Observed API gravity API 20 120 0 Observed temperature Temperature at which the API gravity is observed F 100 400 60 Function outputs Remark EU SW tag Alarm Fallback St...

Page 126: ...ction of Observed API Gravity to API Gravity at 60 F First Edition August 1980 API MPMS 11 1 Volume XIII Table 5D Generalized Lubricating Oils Correction of Observed API Gravity to API Gravity at 60 F...

Page 127: ...al value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha Thermal expansion factor 1 F ALPHA 0 Product When input Product is B Auto selec...

Page 128: ...Pressure Volume Correction Factors for Generalized Crude Oils Refined Products and Lubricating Oils May 2004 Function inputs Remark EU SW tag Range Defaul t Name Optional tag name tag description and...

Page 129: ...or CTPL CTL CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation...

Page 130: ...g for an API gravity of 70 the table only specifies values between 0 150 F Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag gro...

Page 131: ...F Against API Gravity at 60 F January 1982 Function inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group API at 60 F API gravity at 60...

Page 132: ...e Value will be rounded according to input API2540 rounding CTL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual va...

Page 133: ...description and tag group API at 60 F API gravity at 60 F and 0 psig API 20 120 0 Observed temperature Temperature at which the API gravity is observed F 100 400 60 Observed pressure Pressure at whic...

Page 134: ...culation K2 0 Alpha Thermal expansion factor 1 F ALPHA 0 F Compressibility factor 1 psi F 0 Product When input Product is B Auto select then the output is set to the actual selected product of table B...

Page 135: ...uts Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Observed specific gravity Specific gravity at the observed temperature 0 1 3 0 Observed temperat...

Page 136: ...taken from a hydrometer as specified in the API 2540 standard Compliance API MPMS 11 1 Volume X API Standard 2540 Table 23A Generalized Crude Oils Correction of Observed Relative Density to Relative...

Page 137: ...constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha Thermal expansion factor 1 F A...

Page 138: ...ume Correction Factors for Generalized Crude Oils Refined Products and Lubricating Oils May 2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Obs...

Page 139: ...input API rounding CPL 1 CTPL Combined volume correction factor CTPL CTL CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculatio...

Page 140: ...e Optional tag name tag description and tag group Observed relative density Relative density at the observed temperature 0 0 75 0 Observed temperature Temperature at which the relative density is obse...

Page 141: ...95 F Function inputs and outputs Function inputs Remark EU SW tag Range Defaul t Name Optional tag name tag description and tag group Specific gravity 60 F Specific gravity at 60 F 0 1 3 0 Observed te...

Page 142: ...against Relative Density at 60 60 F First Edition August 1980 API MPMS 11 1 Volume X API Standard 2540 Table 24B Generalized Products Correction of Volume to 60 F against Relative Density at 60 60 F F...

Page 143: ...ror STS FIOOR CALCERR CTL Volume correction factor for temperature Value will be rounded according to input API2540 rounding CTL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actua...

Page 144: ...ay 2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Relative density at 60 F Relative density at 60 F and 0 psig 0 1 3 0 Observed temperature Te...

Page 145: ...or CTPL CTL CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation...

Page 146: ...Range Default Name Optional tag name tag description and tag group Relative density at 60 F Relative density at 60 F 0 0 75 0 Observed temperature Temperature at which the relative density is observed...

Page 147: ...on inputs Remark EU SW tag Range Defaul t Name Optional tag name tag description and tag group Observed density Density at the observed temperature kg m 3 0 1300 0 Observed temperature C 100 200 15 Fu...

Page 148: ...oducts Correction of Observed Density to Density at 15 C First Edition August 1980 API MPMS 11 1 Volume XIV Table 53D Generalized Lubricating Oils Correction of Observed Density to Density at 15 C Jan...

Page 149: ...tual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha Thermal expansion factor 1 C ALPHA 0 Product When input Product is B Auto sel...

Page 150: ...e Correction Factors for Generalized Crude Oils Refined Products and Lubricating Oils May 2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Obser...

Page 151: ...CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha...

Page 152: ...g group Observed density Density at the observed temperature kg m3 0 750 0 Observed temperature Temperature at which the relative density is observed C 100 150 15 API rounding 0 Disabled The calculati...

Page 153: ...tion inputs and outputs Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Density 15 C Specific gravity at 60 F Kg m3 0 1300 0 Observed temperature C...

Page 154: ...5 C Against Density at 15 C January 1982 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Density at 15 C Density at 15 C and the equilibrium pressur...

Page 155: ...cording to input API2540 rounding CTL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used fo...

Page 156: ...2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Density at 15 C Density at 15 C and 0 bar g kg m3 0 1300 0 Observed temperature Temperature at...

Page 157: ...TPL CTL CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2...

Page 158: ...tag description and tag group Density at 15 C 0 750 0 Observed temperature Temperature at which the relative density is observed C 100 150 15 API rounding 0 Disabled The calculations are performed wit...

Page 159: ...me Correction Factors for Generalized Crude Oils Refined Products and Lubricating Oils May 2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Obse...

Page 160: ...CPL CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha...

Page 161: ...up Observed density Density at the observed temperature kg m3 0 750 0 Observed temperature Temperature at which the relative density is observed C 100 200 20 API rounding 0 Disabled The calculations a...

Page 162: ...2004 Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Density at 20 C Density at 20 C and 0 bar g kg m3 0 1300 0 Observed temperature Temperature at...

Page 163: ...L CTPL 1 K0 Actual value of constant K0 used for CTL calculation K0 0 K1 Actual value of constant K1 used for CTL calculation K1 0 K2 Actual value of constant K2 used for CTL calculation K2 0 Alpha Th...

Page 164: ...description and tag group Density at 20 C 0 750 0 Observed temperature Temperature at which the relative density is observed C 100 150 20 API rounding 0 Disabled The calculations are performed with f...

Page 165: ...tion applies a linear interpolation between table values based on the input values The table specifies relative density at 60 F values that are limited to a low value of 0 621 and a high value of 0 63...

Page 166: ...o 1 2 The relative density corrected for pressure is calculated by dividing the observed relative density by the CPL value 3 The CTL value and the relative density at 60 F equilibrium pressure is calc...

Page 167: ...on and tag group Relative density at 60 F 0 1 0 Observed temperature Temperature at which the relative density is observed F 100 150 20 Function outputs Remark EU SW tag Alarm Fallback Status 0 Normal...

Page 168: ...oundaries The standard defines an upper limit for the temperature of 150 F for p xylene and 140 F for all other products API MPMS 11 2 1 defines the following limits on the input values 0 to 90 API 20...

Page 169: ...temperature and pressure are 0 In Range 1 Out of Range API_OOR 0 Calculations ASTM D1555 contains both formulas and tables for the Ctl called VCF in the standard for the different product Please note...

Page 170: ...viding the observed density by the CTL and CPL values 7 Steps 2 through 6 are repeated until the absolute difference between two consecutive relative density values is less than the convergence limit...

Page 171: ...ription and tag group Observed temperature Temperature at which the relative density is observed F 100 250 20 ASTM D1555 rounding 0 Disabled The calculations are performed with full precision 1 Enable...

Page 172: ...D1555_Ctl Calculations ASTM D1555 contains both formulas and tables for the Ctl called VCF in the standard for the different product Please note the formulas are the standard and not the tables This f...

Page 173: ...ement Flow increment with which the input value is weighed Must refer to the corresponding output from a TotalizerRate or TotalizerDelta function Negative values will be ignored Same as linked cell 0...

Page 174: ...uts and outputs Function inputs Remark EU SW tag Range Default Name Name used for tag prefix and retentive storage First ID Optional Batch identification of the first historical batch for which the va...

Page 175: ...tch output value and the current latch output value is reset to 0 Identification Batch identification Can be any string of maximum 255 characters long ID Note When the latch and reset commands are giv...

Page 176: ...1 Enabled 0 Disabled 1 Enabled EN Reset command Trigger to reset the batch At a batch reset the current average is stored in the previous value and the current value is reset to 0 Identification Batch...

Page 177: ...1 Enabled 0 Disabled 1 Enabled EN Reset command Trigger to reset the batch At a batch reset the current average is stored in the previous value and the current value is reset to 0 Identification Batch...

Page 178: ...any string of maximum 255 characters long If multiple identifications need to be stored for future referral e g the batch number the ship name and the nomination number then the individual strings sh...

Page 179: ...be averaged Same as linked cell 1e11 1e11 Enabled 0 Disabled 1 Enabled EN Reset command Trigger to reset the batch At a batch reset the current latch is stored in the previous value and the current la...

Page 180: ...tch reset the current watched value is stored in the previous value and the current watched value is reset to 0 Identification Batch identification Can be any string of maximum 255 characters long If...

Page 181: ...on inputs Remark EU SW tag Range Default Name Input value The value to be converted Input unit Unit of the value to be converted Use one of the xu_ unit constants Output unit Unit of the output value...

Page 182: ...er the absolute or the relative difference needs to be checked The unit of the deviation limit will be in accordance 1 Absolute 2 Relative DEVTYP 1 Deviation limit The unit depends on the Deviation ty...

Page 183: ...g 0 Disabled The calculations are performed with full precision A convergence limit of 1e 10 kg m3 will be applied for the iterative calculations 1 Enabled The calculations are performed in full compl...

Page 184: ...up to 270 MPa 39160 psi and 104K to 450K 272 350 F for pressures up to 40 MPa 5800 psi Function inputs Remark EU Range Default Name Optional tag name tag description and tag group Temperature F 300 2...

Page 185: ...nal tag name tag description and tag group Temperature C 200 200 0 Pressure bar a 3000 0 Function outputs Remark EU Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error 3 No conv...

Page 186: ...200 400 0 Composition Standard composition as defined in section Standard gas composition mol mol 0 1 0 Function outputs Remark EU Fallback Status 0 Normal 1 Input argument out of range 2 Calculation...

Page 187: ...ne n Nonane n Octane n Decane n Octane Helium Nitrogen Argon Nitrogen Neo Pentane Iso Pentane Notes Components Water Hydrogen sulphide and Carbon monoxide are not supported by the publication and will...

Page 188: ...name When left empty the UniqueMethod setting as defined for the report definition is used for the report file name Flow Xpress section Reports Printer Optional printer Must be the name of one of the...

Page 189: ...at conditions outside the Expanded range is not recommended Input value Normal Range Expanded Range EU Pressure 0 35 0 70 MPa a Temperature 90 450 60 700 K Pressure 0 350 0 700 bar a Temperature 183...

Page 190: ...rmal Range All inputs are within the Normal Range 1 In Extended Range One or more inputs within the Extended Range but none of the inputs outside the Extended rang outputs values have higher uncertain...

Page 191: ...50 0 700 bar a Temperature 183 177 213 427 C Mole fraction of Methane 0 00 1 00 0 00 1 00 Mole fraction of Ethane 0 00 1 00 0 00 1 00 Mole fraction of Propane 0 00 1 00 0 00 1 00 Mole fraction of Buta...

Page 192: ...COMPERR Vapor fraction FV 0 Compressibility vapor Compressibility of the vapor fraction of the mixture ZV 0 Compressibility liquid Compressibility of the liquid fraction of the mixture ZL 0 Compressi...

Page 193: ...lation for Commercial NGLs September 2007 GPA Technical Publication TP 15 A Simplified Vapor Pressure Correlation for Commercial NGLs September 2007 ASTM Technical Publication Stock No PETROLTBL TP15...

Page 194: ...sity and the temperature to calculate the vapor pressure 1 Enabled The improved correlation requires the vapor pressure at 100 F 37 8 C This method is better suited for varied NGL mixes Where differen...

Page 195: ...the gas is saturated with water and the composition is normalized to unity GPA 2172 prescribes that the most recent edition of GPA2145 used for the individual component values The function provides th...

Page 196: ...3 VOLGHV_WET 0 Molar Mass Wet lbm lbmol MOLMASS_WET 0 Molar Mass Ratio Wet ISG_WET 0 Relative Density Wet Based on the compressibility of wet air RRD_WET 0 Compressibility Wet Z_DWET 0 Gross Heating V...

Page 197: ...ing the GPA2145 table values However the calculations are performed at full precision so not with intermediate rounding as shown in the examples of the standard Please note that the function uses the...

Page 198: ...on the water fraction value of input Composition is set to the water saturated mole fraction and the composition is normalized to unity GPA 2172 prescribes that the most recent edition of GPA2145 used...

Page 199: ...Wet MJ kg MASGHV_WET 0 Net Heating Value Wet MJ m3 VOLNHV_WET 0 Gross Heating Value Dry MJ m3 VOLGHV_DRY 0 Molar Mass Dry kg kmol MOLMASS_DRY 0 Molar Mass Ratio Dry ISG_DRY 0 Relative Density Dry RRD...

Page 200: ...amples of the standard Please note that the function uses the input composition as is so does not apply normalization to 1 When the water fraction input value is above the water fraction of the satura...

Page 201: ...lified equation that is considered to be adequate for custody transfer applications Therefore compositional properties are calculated for the following gas compositions Wet gas composition the water f...

Page 202: ...ane is larger than zero 1 Add to i Pentane 2 Add to n Pentane 3 Neglect NEOC5_MODE 1 Function outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error...

Page 203: ...aturated Z_SAT 0 Gross Heating Value Saturated Btu lbm MASGHV_SAT 0 Net Heating Value Saturated Btu ft3 VOLNHV_SAT 0 Calculations The calculations are as documented in the GPA 2172 standard using the...

Page 204: ...action of input Composition is taken as the actual water fraction Dry gas composition the water fraction is set to 0 and the composition is normalized to unity Saturated gas composition the water frac...

Page 205: ...ASS_WET 0 Molar Mass Ratio Wet ISG_WET 0 Relative Density Wet Based on the compressibility of wet air RRD_WET 0 Compressibility Wet Z_DWET 0 Gross Heating Value Wet MJ kg MASGHV_WET 0 Net Heating Valu...

Page 206: ...tions are performed at full precision so not with intermediate rounding as shown in the examples of the standard Please note that the function uses the input composition as is so does not apply normal...

Page 207: ...picture below Region 1 Water Region 2 Superheated steam Region 3 Water Region 4 Saturation line saturated steam water Region 5 Superheated steam References Revised Release on the IAPWS Industrial For...

Page 208: ...onvergence Density lbm ft3 0 Enthalpy Energy flow Mass flow Enthalpy btu lbm 0 Region Actual IAPWS IF97 region 0 Combination of t and p is outside the valid range 1 Water 2 Steam 3 Pressurized water 4...

Page 209: ...rom the temperature in pressure For region 3 an iterative calculation is required because the Equation Of State for this region calculates the pressure from a known temperature and density iteration A...

Page 210: ...icture below Region 1 Water Region 2 Superheated steam Region 3 Water Region 4 Saturation line saturated steam water Region 5 Superheated steam References Revised Release on the IAPWS Industrial Formu...

Page 211: ...convergence Density kg m3 0 Enthalpy Energy flow Mass flow Enthalpy MJ kg 0 Region Actual IAPWS IF97 region 0 Combination of t and p is outside the valid range 1 Water 2 Steam 3 Pressurized water 4 A...

Page 212: ...ed directly from the temperature in pressure For region 3 an iterative calculation is required because the Equation Of State for this region calculates the pressure from a known temperature and densit...

Page 213: ...g used for the pressure transmitter This can be achieved by using the fxIndex function for the cell that represents the PT_HISCALE tag In some cases one and the same input signal is used for multiple...

Page 214: ...ue e g flow rate or pulse frequency Reference values Array of reference values assuming the following sequence Point 1 Input value Point 1 Output value Point 2 Input value Point 2 Output value etc The...

Page 215: ...In Out Out In x y Where x Input value y Interpolated value InL Closest input reference value that is smaller than the input value InH Closest input reference value that is larger than the input value...

Page 216: ...uid at metering conditions kg m3 0 Dynamic Viscosity Dynamic viscosity of the fluid Pa s 0 Isentropic Exponent Also referred to as kappa For an ideal gas this coefficient is equal to the ratio of the...

Page 217: ...t 2 Constant Isentropic expansion using input Temperature Exponent as the temperature referral exponent Please note that this value must be 0 3 Joule Thomson Isenthalpic expansion using input Temperat...

Page 218: ...ure at downstream tapping p2 bar a Recovered downstream pressure Fully recovered downstream pressure p3 bar a Upstream temperature Temperature at upstream tapping t1 C Temperature at downstream tappin...

Page 219: ...metering conditions kg m3 0 Dynamic Viscosity Dynamic viscosity of the fluid Pa s 0 Isentropic Exponent Also referred to as kappa For an ideal gas this coefficient is equal to the ratio of the specifi...

Page 220: ...ce versa 1 1 Isentropic expansion using 1 as the temperature referral exponent 2 Constant Isentropic expansion using input Temperature Exponent as the temperature referral exponent Please note that th...

Page 221: ...essure at upstream tapping p1 bar a Pressure at downstream tapping Pressure at downstream tapping p2 bar a Recovered downstream pressure Fully recovered downstream pressure p3 bar a Upstream temperatu...

Page 222: ...Function inputs Remark EU Range Default Name Optional tag name tag description and tag group Differential Pressure Differential pressure over the primary flow device measured at the up and downstream...

Page 223: ...ISO5167 Corner 2 ISO5167 D and D 2 3 ISO5167 Flange 4 ISO15377 Quarter circle 5 ISO15377 Conical entrance The calculation of the discharge and expansion factor are equal for the quarter circle orific...

Page 224: ...sion using input Temperature Exponent as the Joule Thomson coefficient C bar This method is prescribed by ISO5167 1 2003 3 Temperatur e Exponent Refer to input Temperature Correction Unit depends on i...

Page 225: ...nstream tapping t2 C 0 Downstream Temperature Fully recovered downstream temperature t3 C 0 Upstream density Density at upstream tapping 1 kg m3 0 Density at downstream tapping Pressure at downstream...

Page 226: ...5 273 2 3 3 2 TE K p p t t 15 273 15 273 1 3 3 1 TE K p p t t When input Temperature correction is set to 3 then an isenthalpic expansion based on the linear Joule Thomson correction as defined in ISO...

Page 227: ...ecovered downstream pressure kg m3 p1 Upstream pressure bar a p2 Pressure at the downstream tapping bar a p3 Fully recovered downstream pressure bar a Isentropic exponent KDE Density exponent Note In...

Page 228: ...compressibility calculation e g AGA8 at p2 and t3 in the application and calculating the upstream density Where the value of p2 is provided as an output by the ISO5167 function Subsequently the upstr...

Page 229: ...the fluid at metering conditions kg m3 0 Dynamic Viscosity Dynamic viscosity of the fluid Pa s 0 Isentropic Exponent Also referred to as kappa For an ideal gas this coefficient is equal to the ratio...

Page 230: ...at a location Where the pressure has fully recovered t3 Since temperature measurement is usually downstream of the flow device this is the most common setting 2 Temperature Correction This parameter...

Page 231: ...n mbar The value of input Pressure Loss Value is taken as a value in mbar 2 Percentage of differential pressure The value of input Pressure Loss Value is taken as a percentage from input Differential...

Page 232: ...ping t1 C 0 Temperature at downstream tapping Temperature at downstream tapping t2 C 0 Downstream Temperature Fully recovered downstream temperature t3 C 0 Upstream density Density at upstream tapping...

Page 233: ...or an ideal gas this coefficient is equal to the ratio of the specific heat capacity at constant pressure to the specific heat at constant volume According to the ISO standard this ratio may be used w...

Page 234: ...lly recovered 3 Density Exponent This factor is used when density correction is enabled The formula 1 will be used when the input value is set to 0 else the input value will be used For more details r...

Page 235: ...tapping t1 C 0 Temperature at downstream tapping Temperature at downstream tapping t2 C 0 Downstream Temperature Fully recovered downstream temperature t3 C 0 Upstream density Density at upstream tapp...

Page 236: ...then an isentropic expansion is applied 15 273 15 273 1 1 3 3 1 p p t t Else the value of input Temperature exponent is used 15 273 15 273 1 3 3 1 TE K p p t t Where t1 Upstream temperature C t3 Down...

Page 237: ...ol 0 1 0 Metering reference temperature Temperature used for calculating the compressibility the density and the real relative density values 1 0 C 2 15 C 1 Calorific value reference temperature Tempe...

Page 238: ...589 Function inputs Remark EU Range Default Name Optional tag name tag description and tag group Composition Standard composition as defined in section Standard gas composition mol mol 0 1 0 Reference...

Page 239: ...s of temperature and pressure MJ kg 0 Superior calorific value Real superior calorific value on mole basis at the reference conditions of temperature and pressure MJ kmol 0 Inferior calorific value Re...

Page 240: ...are as follows Methane 0 5 1 0 Nitrogen 0 0 0 3 Ethane 0 0 0 15 Carbon dioxide 0 0 0 15 All others 0 0 0 05 Compliance International standard Natural Gas Calculation of calorific values density relat...

Page 241: ...0 C 5 20 C 20 C 6 25 C 20 C 1 Molar mass table method 1 Calculate Calculates the molar mass from the atomic masses as defined in the note of Table 1 of the standard 2 Table Uses the values from Table...

Page 242: ...is should be the ICV corresponding to the current reference conditions Note the input values have to correspond with the conditions as defined by input Reference conditions This array should be exactl...

Page 243: ...ations Calculations are performed in accordance with the standard with the addition of the user definable components The properties of the user definable components are specified by the corresponding...

Page 244: ...output of the related input function INPSTS Input value Value of the input signal Must be linked to the scaled value output of the related input function INPVAL Fallback type Determines what to do wh...

Page 245: ...0 Failure INPSTS Input values Array if input values INPVAL Fallback type Determines what to do when input fails 1 Use last good value 2 Use fallback value 3 Use keypad value 4 Use measured FBTYP Fallb...

Page 246: ...o latch the input value Input value Value to be latched May be a constant a formula or a reference to another cell or tag Reset trigger Optional Trigger to resets the latched value to the reset value...

Page 247: ...e or false True Warning behavior Determines the warning behavior when the lo and hi limit are violated 1 No warnings just alarms 2 Warn on lo limit 3 Warn on hi limit 4 Warn on lo and hi limit 1 Funct...

Page 248: ...ts Function inputs and outputs Function inputs Remark EU Range Default Name Optional tag name tag description and tag group Pressure Flowing pressure bar a 1 150 1 01325 Temperature Flowing temperatur...

Page 249: ...al water fraction at flowing conditions mole 0 Relative humidity At flow conditions 0 Range 0 All input values are within the Normal Range 1 One or more input values are outside the Normal Range 0 Cal...

Page 250: ...at of air at base conditions so the real specific gravity or real relative density Compliance AGA Par Research Project NX 19 Manual for the Determination of the Supercompressibility Factors for Natura...

Page 251: ...to section Calculations for ist definition 1 Range 0 All input values are within the Normal Range 1 One or more input values are outside the Normal Range 0 Calculations The AGA NX 19 standard specifie...

Page 252: ...t base conditions so the real specific gravity or real relative density Compliance AGA Par Research Project NX 19 Manual for the Determination of the Supercompressibility Factors for Natural Gas 1962...

Page 253: ...correction Determines if the AGA NX 19 mod AGA NX 19 mod BR KORR 3H is used instead of the AGA NX 19 1962 standard calculation 0 Disabled 1 Enabled 1 Function outputs Remark EU Fallback Status 0 Norm...

Page 254: ...to the corresponding output from a TotalizerRate or TotalizerDelta function Negative values will be ignored Same as linked cell Period type Type of period 1 Second 2 Minute 3 Hour 4 Day 5 Week 6 Month...

Page 255: ...TYP Period count Number of periods e g 5 minutes 8 hours CNT 1 1e11 Period start Absolute start date and time of the period This will be used as the reference point to calculate the next period rollov...

Page 256: ...count Number of periods e g 5 minutes 8 hours CNT 1 1e11 Period start Absolute start date and time of the period This will be used as the reference point to calculate the next period rollover from Th...

Page 257: ...ount Number of periods e g 5 minutes 8 hours CNT 1 1e11 Period start Absolute start date and time of the period This will be used as the reference point to calculate the next period rollover from The...

Page 258: ...ame as linked cell 0 1e11 Enabled 0 Disabled 1 Enabled EN Period type Type of period 1 Second 2 Minute 3 Hour 4 Day 5 Week 6 Month 7 Quarter 8 Year TYP Period count Number of periods e g 5 minutes 8 h...

Page 259: ...eriod Same as input Increment CUR 0 Previous total Accumulated total for the previous period Same as input Increment PRV 0 Rollover flag Flag indicating a rollover to 0 0 Off 1 On Note stays On for on...

Page 260: ...abled EN Period type Type of period 1 Second 2 Minute 3 Hour 4 Day 5 Week 6 Month 7 Quarter 8 Year TYP Period count Number of periods e g 5 minutes 8 hours CNT 1 1e11 Period start Absolute start date...

Page 261: ...r of periods e g 5 minutes 8 hours CNT 1 1e11 Period start Absolute start date and time of the period This will be used as the reference point to calculate the next period rollover from The value may...

Page 262: ...between auto and manual mode and vice versa The actual process value is copied into the required setpoint value while manual mode is enabled PV tracking When reverting to auto mode the process will s...

Page 263: ...U s 0 Upwards OP slew rate The control output will not be allowed to increase faster than this limit s 0 Downwards OP slew rate The control output will not be allowed to decrease faster than this limi...

Page 264: ...ds to be connected to output Tracking mode of the secondary Slave PID function This input tells this function that the secondary Slave PID function is not using its Cascade input but its Manual output...

Page 265: ...e PID function is not using the Cascade input but the Manual output or Setpoint value instead This allows the primary PID function to track the secondary process or setpoint value enabling a bumpless...

Page 266: ...control output uMAX high limit for control output t calculation cycle time s KP Proportional gain factor KI Integral gain factor KD Derivation gain factor P Proportional part of current cycle ICUR Int...

Page 267: ...Calculate the Proportional part P KP eCUR Calculate the Integral part ICUR IPRV Ki t eCUR uPRV vPRV High scale value Low scale value 100 Note the latter part is required to avoid anti windup Calculat...

Page 268: ...IF Cascade mode Enabled SPREQ SPCUR Manual output tracking IF Manual mode Disabled Manual output uCUR Tracking mode and value Outputs Tracking mode and Tracking value are set as follows Tracking mode...

Page 269: ...olute difference between two consecutive values divided by the calculation cycle time in seconds is more than the limit fxSarasota_C The function calculates the density from a frequency input signal p...

Page 270: ...al 1 Input argument out of range 2 Calculation error STS FIOOR CALC Corrected density Density corrected for temperature and pressure lbm ft3 CORDENS 0 Calculations The corrected density C is calculate...

Page 271: ...tion 0 Disabled 1 Enabled 1 Reference temperature Used when temperature correction is enabled C 0 100 20 Reference pressure Used when pressure correction is enabled bar g 0 100 0 d0 Constant from cali...

Page 272: ...icate s K Obtained from the calibration certificate d0 Obtained from the calibration certificate pCOE F Obtained from the calibration certificate s bar tCOE F Obtained from the calibration certificate...

Page 273: ...ate and time that the most recent change has occurred fxSetOnCondition The fxSetOnCondition function sets a tag or cell to a specific value whenever a condition is true It is a generic function that i...

Page 274: ...condition that needs to be valid while the event occurs If the condition is not valid then teh target will not be set to the value TRUE Function outputs Remark EU SW tag Alarm Fallback Date and time...

Page 275: ...nction inputs Remark EU SW tag Range Default Module Number of the Flow X M module 1 local module 1 8 module 1 through 8 1 8 1 Index The index number of the target tag to be set Value Value to be assig...

Page 276: ...the target tag to be set Value Value to be assigned May be a constant a formula or a reference to another cell or tag Event Boolean expression When the expression outcome changes from FALSE to TRUE or...

Page 277: ...ity factor of 0 1 provided the inputs lie in the following range Pressure 0 1740 psi a Temperature 17 143 F Gross heating value 509 1288 Btu ft3 Relative density 0 55 0 90 Carbon dioxide 0 00 0 30 mol...

Page 278: ...e or more components within the Extended Range but none of the components outside the Extended rang outputs values have higher uncertainty 2 Out of Range One or more components outside the Extended Ra...

Page 279: ...1 provided the inputs lie in the following range Pressure 0 120 bar a Temperature 265 335 K Gross heating value 19 48 MJ m3 Relative density 0 55 0 90 Carbon dioxide 0 00 0 30 mol mol Nitrogen 0 00 0...

Page 280: ...he Extended Range but none of the components outside the Extended rang outputs values have higher uncertainty 2 Out of Range One or more components outside the Extended Range using the AGA8 calculatio...

Page 281: ...in Hz s 0 1e6 0 Line temperature Used when temperature correction is enabled F 459 67 1000 20 Temperature correction 0 Disabled 1 Enabled TEMPCOR 1 VOS correction 0 Disabled 1 Enabled VOSCOR 1 Refere...

Page 282: ...ty corrected for temperature Density corrected for temperature lbm ft3 TCORDENS 0 Uncorrected density Uncorrected indicated density lbm ft3 UNCDENS 0 Calculations Density calculations are performed in...

Page 283: ...om the calibration certificate K4 Obtained from the calibration certificate Kc Calibration gas constant from the calibration certificate G G value Equals either input G value or the ratio of inputs Sp...

Page 284: ...ection is enabled C 273 500 20 Temperature correction 0 Disabled 1 Enabled TEMPCOR 1 VOS correction 0 Disabled 1 Enabled VOSCOR 1 Reference temperature Used when temperature correction is enabled C RE...

Page 285: ...g m3 CORDENS 0 Density corrected for temperature Density corrected for temperature kg m3 TCORDENS 0 Uncorrected density Uncorrected indicated density kg m3 UNCDENS 0 Calculations The uncorrected densi...

Page 286: ...om the calibration certificate K4 Obtained from the calibration certificate Kc Calibration gas constant from the calibration certificate G G value Equals either input G value or the ratio of inputs Sp...

Page 287: ...000 divided by the frequency in Hz s 0 1e6 0 Line temperature Used when temperature correction is enabled F 459 67 100 0 Line pressure Used when pressure correction is enabled psig 0 3000 0 Temperatur...

Page 288: ...Density corrected for temperature and pressure lbm ft3 PTCORDENS 0 Uncorrected density lbm ft3 UNCDENS 0 Calculations Density calculations are performed in g cc and m s while the function inputs and o...

Page 289: ...ssure psig pR The reference pressure psig When VOS Correction is set to Based on Kr and Kj Constants the following correction for velocity of sound is applied 3 j pt r pt VOS K K When VOS Correction i...

Page 290: ...c time In microseconds Equals 1000 divided by the frequency in Hz s 0 1e6 0 Line temperature Used when temperature correction is enabled C 273 15 500 0 Line pressure Used when pressure correction is e...

Page 291: ...n outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation error STS FIOOR CALCERR Corrected density Density corrected for temperature pressure and VOS provi...

Page 292: ...mperature kg m3 K20A Obtained from the calibration certificate K20B Obtained from the calibration certificate K21A Obtained from the calibration certificate K21B Obtained from the calibration certific...

Page 293: ...4 293 Flow X General functions fxSolartron_Liquid_M Where VOS The density corrected for temperature kg m3 Kr Constant obtained from Solartron Kj Constant obtained from Solartron kg m3 VC Calibration...

Page 294: ...tificate K0 10000 0 11 952 K2 Constant from calibration certificate K2 0 1 4 719593e 5 Function outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Input argument out of range 2 Calculation erro...

Page 295: ...fied value is considered at the initial value Unit Defines an engineering unit enumeration date time or a special data type e g xt_bool xu_kg_s or xe_period Write level Applies for writeable tags only...

Page 296: ...y be left empty in which case no maximum check is applied Function outputs Remark EU SW tag Alarm Fallback Value Depends on setting Mode Mode This Cell Cell shows the value or the result of the formul...

Page 297: ...time however will be a multifold of the flow computer cycle time When the limit value does not match an exact number of cycles then the actual limit value will be rounded upwards to match the next nu...

Page 298: ...gnored so the cumulative total will not decrease Defined by Input unit 0 1e11 Enabled Dictates whether the flow accumulation is enabled or not When disabled the cumulative total will not be updated an...

Page 299: ...3 copies were different and the total was reset to 0 0 Off 1 On Note stays On for one cycle only FTOTERR Unit conversion The function will automatically apply the required conversion based on the unit...

Page 300: ...tal will not be updated and the increment will be set to 0 0 Disabled 1 Enabled EN Input unit Unit of input Flow rate Output unit Unit to be used for total and increment Refer to the next section Unit...

Page 301: ...red conversion based on the unit of the flow rate input value Input unit and the selected Output unit for the flow quantity E g when flow rate input is in kg hr the selected unit is tonne then the fol...

Page 302: ...Used when temperature correction is enabled F REFTEMP 0 200 60 Reference pressure Used when pressure correction is enabled psig REFPRES 0 1500 0 K0 Constant K0 from calibration certificate K0 1e9 1e9...

Page 303: ...corrected density t is calculated by R i T i T T R i P i P P i t t t K K K p p K K K 2 3 2 1 2 3 2 1 Where t The density corrected for temperature and pressure lbm ft 3 KP1 Obtained from the calibrati...

Page 304: ...hen temperature correction is enabled C REFTEMP 0 100 20 Reference pressure Used when pressure correction is enabled bar g REFPRES 0 100 0 K0 Constant K0 from calibration certificate K0 1e9 1e9 K1 Con...

Page 305: ...re corrected density t is calculated by R i T i T T R i P i P P i t t t K K K p p K K K 2 3 2 1 2 3 2 1 Where t The density corrected for temperature and pressure kg m3 KP1 Obtained from the calibrati...

Page 306: ...the number of times the flag has been raised Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Empty Value The value that needs to be checked for upd...

Page 307: ...y of the fluid at metering conditions lbm ft3 0 200 0 Dynamic Viscosity Dynamic viscosity of the fluid lbm ft s 0 10 6 9e 6 Isentropic Exponent Also referred to as kappa For an ideal gas this coeffici...

Page 308: ...This parameter specifies if and how the temperature should be corrected from downstream to upstream conditions or vice versa 1 1 Isentropic expansion using 1 as the temperature referral exponent 2 Con...

Page 309: ...pe diameter ratio at upstream temperature Input Cone diameter Input Pipe diameter Cone diameter At the upstream temperature inches Input Cone diameter Pipe diameter At the upstream temperature inches...

Page 310: ...s the expansion factor should not get below 0 84 0 Expansion factor is in valid range 1 Expansion factor is out of valid range 0 Calculations The flow calculation is as specified in the McCrometer ref...

Page 311: ...s C 240 1000 0 Density Down or upstream density of the fluid at metering conditions kg m3 0 2000 0 Dynamic Viscosity Dynamic viscosity of the fluid Pa s 0 1 0 01115 Isentropic Exponent Also referred t...

Page 312: ...t3 Since temperature measurement is usually downstream of the flow device this is the most common setting 2 Temperature Correction This parameter specifies if and how the temperature should be correct...

Page 313: ...e meter is used The resulting correction curve can be implemented through function fxInterolationCurve Input Discharge coefficient needs to be linked to the corresponding output of this additional fun...

Page 314: ...m3 Input Density Reynolds number 0 Discharge coefficient Same as input value Expansion Factor 0 Velocity Pipeline velocity m s 0 Expansion Factor Range The McCrometer reference document states that fo...

Page 315: ...cycle The average is either the arithmetic mean or the Root of the Mean of the Squares RMS Where the latter is meant for a differential pressure signal of a primary flow device e g an orifice plate Th...

Page 316: ...ilter 15 Slowest filter FILSP 0 Function outputs Remark EU SW tag Alarm Fallback Status 0 Normal 1 Function Input argument out of range STS FIOOR Percentage value The actual and filtered output value...

Page 317: ...through 8 1 1 25 Volts 2 12 Volts Channels 9 through 16 1 3 75 Volts 2 12 Volts THRESHOLD 1 Function outputs Remark SW tag Alarm EU Status 0 Normal 1 Input argument out of range STS FIOOR Signal Stat...

Page 318: ...ctivated The value 0 disables the delay function If the control signal becomes 0 before the time has elapsed then the output signal will not be activated ms DELAY 0 0 Minimum activation time Minimum p...

Page 319: ...Fallback Status 0 Normal 1 Input argument out of range or conflict STS FIOOR 0 fxFrequencyOutput This function provides a programmable output frequency on one of the digital pins The frequency as well...

Page 320: ...Hz Hz 0 01 10000 Duty cycle Duty cycle 0 100 Enabled Enables 0 or disables 0 the output signal Phase shift Phase shift between dual pulse channel A and B expressed as the ratio of the time delay betw...

Page 321: ...ith 2 detectors at one end of the prover A and B and 2 at the other end C and D there are 4 possible detector combinations A C A D B C and B D resulting in four available prover volumes By defining 4...

Page 322: ...ion of the Start digital input sec STRTMINDLY 0 1e9 0 Start maximum delay time After the Reset command has been given the function will wait for no longer than this delay time before the Start digital...

Page 323: ...put argument out of range or conflict STS FIOOR Interpolated pulse count Equals Whole pulse count Time A Time B According to API requirements the interpolated pulse count should be used when less than...

Page 324: ...w computer takes the pulse output from the flow computer that processes the meter on prove to perform prove measurements including double chronometry if required The prover output signal is generated...

Page 325: ...utomatic reset function RSTLIM 0 1e99 0 Bad pulse reset command When the value changes the bad pulse count and alarms are reset Can be used reset the bad pulses manually or automatically e g at a ever...

Page 326: ...increment Number of bad pulses within the last calculation cycle ERRINC Error pulse rate Number of bad pulses within the last calculation cycle divided by the last calculation cycle time in seconds H...

Page 327: ...pulse input of the specified module is configured by function fxPulseInput Function inputs Remark EU SW tag Range Default Name Optional tag name tag description and tag group Empty Module Unused set t...

Page 328: ...of output pulses E g a value of 100 means that 1 pulse is generated whenever 100 increment units have been accumulated SIGFCT 0 1e99 1 Pulse width Time that each output pulse remains active high in m...

Page 329: ...STS FIOOR fxPT100Input Each flow module provides 2 inputs for Pt 100 sensors A Pt 100 sensor is a Platinum Resistance Thermometer PRT element with a resistance of 100 at 0 C Pt is the symbol for plati...

Page 330: ...a resistance value Ohm into a temperature value C according to the Pt 100 conversion tables A Pt 100 sensor is a Platinum Resistance Thermometer PRT element with a resistance of 100 at 0 C Pt is the s...

Page 331: ...Flow X Function Reference 5 331 Flow X IO Functions fxPT100Table...

Page 332: ...the reading is considered to be abnormal Following an abnormal reading there must be 3 consecutive readings within the limit before the time period value is considered normal again When no 3 consecut...

Page 333: ...oot ft2 m2 xu_ft2 9 290304 E 02 Exact Dynamic Viscosity pascal second Pa s xu_Pa s poise poise Pa s xu_poise 1 0 E 01 Exact centipoise cP Pa s xu_cP 1 0 E 03 Exact kilogram force second per square met...

Page 334: ...06 Exact Energy per Mole joules per mole J mol kilojoules per mole kJ mol J mol 1 0 E 03 Exact megajoules per mole MJ mol J mol 1 0 E 06 Exact kilojoules per kilomole kJ kmol J mol 1 Exact megajoules...

Page 335: ...gy per Volume joules per cubic meter J m3 kilojoules per cubic meter kJ m3 J m3 1 0 E 03 Exact megajoules per cubic meter MJ m3 J m3 1 0 E 06 Exact British thermal unit per cubic foot Btu ft3 J m3 1 0...

Page 336: ...3 n 4 1868 E 03 Exact Factor scaling value Decimal percent Decimal 1 0 E 02 Exact parts per million ppm Decimal 1 0 E 06 Exact Force Newton N kilogram force kgf N 9 80665 Exact pound force lbf N 4 448...

Page 337: ...C 1 0 E 02 Exact centimeter per degree Fahrenheit cm F m C 1 8 E 02 Exact millimeter per degree Celsius mm C m C 1 0 E 03 Exact millimeter per degree Fahrenheit mm F m C 1 8 E 03 Exact feet per degre...

Page 338: ...3 Exact pounds mass per pulse lbm puls e kg pulse 4 535924 E 01 Exact Mass per Time kilogram per second kg s kilogram per hour kg hr kg s 1 0 3600 Exact ton metric per hour tonne hr kg s 1 0 3600 E 03...

Page 339: ...SG 60 F kg m3 H2O 60 F 2 Exact 3 Relative Density at 60 degrees Fahrenheit 1 RD 60 F kg m3 H2O 60 F 2 Exact 3 1 This conversion only applies when conversion is to from the Mass per Volume value at 60...

Page 340: ...ted on the periodic chart the pound mol lbmol sometimes lb mol lbm mol or lbm mole is defined lbmol mol 4 5359237 E 01 Exact kilopound mole klbmol mol 4 5359237 E 02 Exact Mole per Mole mole fraction...

Page 341: ...2387 415 Exact millimeter of water convential mmH2O Pa 9 80665 Exact millimeter of water 60 F mmH2O 60 F Pa 248 84 25 4 Approximate inch of mercury convential inHg con Pa 3386 38864 Exact inch of merc...

Page 342: ...ute inH2Oa 60 F Pa a 248 84 Approximate inch of water 68 F absolute inH2Oa 68 F Pa a 248 64107 Approximate Pressure gauge pascal gauge Pa g kilo pascal gauge kPa g Pa g 1 0 E 03 Exact pound force per...

Page 343: ...kg 1 0 E 06 Exact pounds mass avoirdupois per square inch per kilogram psi kg Pa kg 6894 76 Exact bar per per kilogram bar kg Pa kg 1 0 E 05 Exact Pulses per Mass pulses per kilogram pulses k g pulse...

Page 344: ...y D s 8 64 E 04 Exact Velocity meters per second m s kilometers per second km s m s 1 0 E 03 Exact kilometers per hour km hr m s 1 3600 E 03 Exact foot per second ft s m s 3 048 E 01 Exact Volume cubi...

Page 345: ...e fraction vol vol volume percentage vol vol vol 1 0 E 02 Exact Volume per Pulse cubic meters per pulse m3 puls e cubic centimeters per pulse cm3 puls e m3 puls e 1 0 E 06 Exact litres per pulse l pul...

Page 346: ...er per day sm3 d sm3 s 1 86400 Exact kilo standard cubic meter per second ksm3 s sm3 s 1 0 E 03 Exact kilo standard cubic meter per hour ksm3 hr sm3 s 1 3600 E 03 Exact kilo standard cubic meter per d...

Page 347: ...formed at the combustion stays in the gaseous state From ISO6976 Gross Heating Value Inferior Calorific Value Heating value when assuming that water formed at the combustion has totally condensed to...

Page 348: ...76 Used in GPA2172 Used in AGA5 Used in GERG 2008 Used in MR113 Methane Nitrogen Carbon Dioxide Ethane Propane Water 2 3 Hydrogen Sulphide Hydrogen Carbon Monoxide Oxygen i Butane n Butane i Pentane n...

Page 349: ...Flow X Function Reference 6 349 This page is intentionally left blank for user notes...

Page 350: ...6 350 Flow X Function Reference This page is intentionally left blank for user notes...