Interfaces with External Conversion Routines

External conversion routines are needed for the quantity conversion of liquid and gaseous hydrocarbon products.The conversion routines serve as a unified basis for standardized calculations of measured oil liquids or natural gas quantities, irrespective of their origin, specific location or commonly-used or legally-required units of measure.

Conversion Routines for Liquid Hydrocarbon Products

These conversion routines are needed for the oil quantity conversion to calculate volume correction factors.

They were originally based on API/ASTM tables. The “table concept” comes from the fact that historically, the dependencies used in density correction factors and volume correction factors came from the temperature in tables (API/ASTM tables). International and national standards now exist that are based on implementation rules for computer programs.

The API/ASTM standards and the implementation rules are issued by the American Petroleum Institute (API), the American Society for Testing and Materials (ASTM) and the Institute of Petroleum (IP).

The implementation rule describes which calculation rules must be used for which calculation and in which sequence to calculate volume correction factors according to the standard, irrespective of the programming language selected.This implementation rule is called a primary standard.

Implementations in a programming language such as C, ABAP, or JAVA that contain this primary standard are called a secondary standard.

For crude oil and its products, the relevant implementation rule for calculating volume correction factors is described in the following standard:

Manual of Petroleum Measurement Standards, Chapter 11 – Physical Properties Data – Section 1 : Temperature and Pressure Volume Correction Factors for Generalized Crude Oils, Refined Products and Lubricating Oils – Adjunct to: ASTM D 1250-04 and IP 200/04 (MPMS 2004).

The conversion routines for liquid hydrocarbon products based on this implementation rule are used to determine the density at standard temperature (= 15°C, 20°C or 60°F), which is called the base density. Using the base density you can read the volume correction factor for a certain material temperature. Multiplied with the volume quantity, the volume correction factor corrects the volume value to material volumes at a standard temperature (15°C, 20 °C or 60°F).

Note Note

The standard MPMS 2004 replaces all versions of earlier standards.

The API recommends using it when installing new software.

End of the note.
Conversion Routines in Programming Language C

Licenses for conversion routines in programming language C are given by the American Petroleum Institute (API). SAP has no influence on the license conditions.For more information, see the Internet address www.api.org .

Conversion Routines for Gaseous Hydrocarbon Products

These conversion routines are needed for the natural gas quantity conversion to calculate compression factors.

Conversion Routines in Programming Language C

Licenses for conversion routines in programming language C are given by the American Gas Association (AGA). SAP has no influence on the license conditions.For more information, see the Internet address www.aga.org .

Interface for Individual Conversion Routines

You can replace liquid product conversion routines of this provider with a conversion routine of your own by using a predefined interface. That way, your own conversion routines can be completely integrated into the corresponding areas in the ERPsystem.