Edit the API configuration using the Product Group record
- Last UpdatedApr 24, 2025
- 3 minute read
To access the prodgroup Row Edit dialog
-
Open the Advanced Database Editor (ADE).
-
Select View > LMS.
The list of AVEVA Pipeline Operations for Liquids RealTime database (RTDB) tables will appear.
-
From that list, expand Product Group. Double-click on the chosen product group record from the list.
The prodgroup Row Edit dialog will appear.
The following table describes the fields on the prodgroup Row Edit dialog.
|
Items |
Description |
|---|---|
|
Name |
Record name. |
|
Description |
Description. |
|
Commodity |
Description of the commodity that the prodgroup represents. As with Description above, this is information only and has no effect on processing. |
|
Netting Algorithm |
Method used to apply the correction factors in order to correct a volume measurement of fluid of this prodgroup. Selection criteria for the netting algorithm are described in Understand the API Netting Algorithm. |
|
Correction Library |
The correction library used to provide the correction factors to the AVEVA Pipeline Operations for Liquids application.
API 2004 and 1980 provide correction factors for the temperature and pressure, in addition to a corrected density value. In contrast, the REFPROP Mass and REFPROP Volume calculations apply no temperature or pressure calculation and only correct density. In the event that REFPROP Mass is selected, the linepack of a pipe segment will be calculated in pounds rather than the volume unit selected in the assigned unit profile, even though the associated volume units will still appear on the Controller’s windows. This means that when you are configuring the associated pipe_segment record, the values entered there (for example, for Capacity) will need to be entered as they appear in the Unit Profile. The REFPROP Mass library will then convert from volumes to mass. The Temperature Correction Table, Pressure Correction Table, and Density Correction Table entries below are only required for API Calculations. |
|
Temperature Correction Table |
API correction table used to get the temperature correction factor. Selection criteria for the temperature correction is described in Select the proper API table. |
|
Pressure Correction Table |
API correction table used to get the pressure correction factor. Selection criteria for the pressure correction are described in Select the proper API table. |
|
Density Correction Table |
API correction table used to correct the density to standard temperature. Selection criteria for the density correction are described in Select the proper API table. |
|
Volume Units |
Imperial or Metric. This is not edited directly but is automatically set according to the Temperature Correction Table selected. |
The following table describes correction tables to use when configuring the prodgroup record for API1980.
|
Selection criteria |
Conversion tables to use |
||||
|---|---|---|---|---|---|
|
Standard Temperature |
Product Classification |
Density Range |
Temperature |
Pressure |
Density |
|
Imperial - 60⁰F |
Crude |
API Gr. 0 - 90 |
T6A |
11.2.1 |
T5A |
|
API Gr. >90 |
T24A |
11.2.2 |
T23A |
||
|
Refined |
API Gr. 0 - 90 |
T6B |
11.2.1 |
T5B |
|
|
API Gr. >90 |
T24B |
11.2.2 |
T23B |
||
|
Special |
API Gr. 0 – 90 |
T6C |
11.2.1 |
T5A or T5B |
|
|
API Gr. >90 |
T24C |
11.2.2 |
T23A or T23B |
||
|
NGL |
API Gr. >90 |
T24E |
11.2.2 |
T23E |
|
|
Metric - 15⁰C |
Crude |
Kg/m³ 638 - 1074 |
T54A |
11.2.1M |
T53A |
|
Kg/m³ 350 - 637 |
T54A |
11.2.2M |
T53A |
||
|
Refined |
Kg/m³ 653 - 1074 |
T54B |
11.2.1M |
T53B |
|
|
Kg/m³ 350 - 637 |
T54B |
1122M |
T53B |
||
|
Special |
Kg/m³ 638 - 1074 |
T54C |
11.2.1M |
T53A or T53B |
|
|
Kg/m³ 350 - 637 |
T54C |
11.2.2M |
T53B |
||
|
NGL |
Kg/m³ 350 - 637 |
T54E |
11.2.2M |
T53E |
|
|
Metric - 20⁰C |
Refined |
Kg/m³ 638 - 1074 |
T60B |
11.2.1M |
T59B |
|
Kg/m³ 350 - 637 |
T60B |
11.2.2M |
T59B |
||
|
NGL |
Kg/m³ 332 - 684 |
T60E |
11.2.2M |
T59E |
|
The following table describes correction tables to use when configuring the prodgroup record for API2004. Density ranges are extended in API2004 and are no longer a consideration when selecting conversion. Pressure tables 11.2.1 and 11.2.2 are replaced by API 11.1.
|
Selection criteria |
Conversion tables to use |
|||
|---|---|---|---|---|
|
Standard Temperature |
Product Classification |
Temperature |
Pressure |
Density |
|
Imperial 60°F |
Crude |
T6A or T24A |
11.2.1 11.2.1 or 11.2.2 |
T5A T23B |
|
Refined |
T6B or T24B |
11.2.1 11.2.1 or 11.2.2 |
T5B T23B |
|
|
Special |
T6C T5B or T24C or T23B |
11.2.1 11.2.1 or 11.2.2 |
T5A or T23A |
|
|
NGL |
T24E |
11.2.2 |
T23E |
|
|
Metric 15°C |
Crude |
T54A |
11.2.1M |
T53A |
|
Refined |
T54B |
11.2.1M |
T53B |
|
|
Special |
T54C |
11.2.1M |
T53A or T53B |
|
|
NGL |
T54E |
11.2.1M |
T53E |
|
|
Metric 20°C |
Refined |
T60B |
11.2.1M20C |
T59B |
|
NGL |
T60E |
11.2.1M20C |
T59E |
|