BCP 10A

ASTM D 1250-04 API MPMS Chapter

11.1
Standard Guide for Use of the
Petroleum Measurement Table
Implementations.
Version 03 (SP12)

14.07.2009

Notes:
Copyright 2009 QuantityWare GmbH. All rights reserved.

SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services
mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in
Germany and in several other countries all over the world. All other product and service names mentioned
are the trademarks of their respective companies.
Microsoft, Windows, SQL-Server, Powerpoint and Outlook are registered trademarks of Microsoft
Corporation.
These materials and the information therein are subject to change without notice. These materials are
provided by the company QuantityWare GmbH for informational purposes only. There is no implied
representation or warranty of any kind, and QuantityWare GmbH shall not be liable for errors or omissions
with respect to the materials provided. The only warranties for the products and services of QuantityWare
GmbH are those set forth in the express warranty statements accompanying such products and services, if
any. No statement within this document should be construed as constituting an additional warranty.

ASTM D 1250-04 - API MPMS Chapter 11.1

2/18

Contents
BCP 10A ........................................................................................................................................ 1

ASTM D 1250-04 - API MPMS CHAPTER 11.1 ........................................................................... 1

Notes: ............................................................................................................................... 2

Contents ........................................................................................................................... 3

Introduction ....................................................................................................................... 4

1. Installation..................................................................................................................... 5

2. Overview of ASTM D 1250-04 ...................................................................................... 6

3. Calculation of thermal expansion coefficients .............................................................. 8

4. Test Report ................................................................................................................. 10

Main Functions .................................................................................................. 10
Report Details: ................................................................................................... 11
1. Installation Test.............................................................................................. 12
2. Examples of the API Standard ...................................................................... 14
3. Examples based on conversion groups (via the SAP QCI). .......................... 16

5. Integration into SAP - QCI desktop calculator ............................................................ 18

ASTM D 1250-04 API MPMS Chapter 11.1

3/18

Introduction
This is a short description of a major standard within the BCP 10A suite - the Standard API
Chapter 11.1 - Physical Properties Data, adjunct to: ASTM D 1250-04 and IP 200/04.

The solution runs only in an SAP ABAP environment in which SAP Oil & Gas has been
implemented.

This solution can be accessed by the SAP Quantity Conversion Interface (QCI) or the
QuantityWare MQCI (Model based QCI) and is controlled by the provided conversion groups.

ASTM D 1250-04 - API MPMS Chapter 11.1

4/18

1. Installation
The technical implementation is provided as a part of a CSP package.

Please follow the standard SAP instructions for importing service packages into your system via
transaction SPAM.

SAP Oil and Gas must be installed

QuantityWare BCP 10A must be installed.

Customizing settings, which are needed in every client in which this standard will be used, are
included in the delivery package.
On releases based upon SAP 4.72 and below, the related customizing transport must be
imported into all necessary clients, or distributed to them from client 000.
On releases based upon SAP ERP 2005 (ECC 6.00) or newer, BC Set /QTYW/BCP_10A must
be activated in the relevant clients.

Please refer to the QuantityWare BCP 10A Installation Guide for more information.

WARNING: If you import the customizing template into a pre-existing client, any
pre-existing entries listed within the template (transport or BC-Set) will be
OVERWRITTEN!

Changes within the SAP Oil&Gas QCI are delivered by SAP with notes 954553 and 958296.
You have to ensure that the enhancements within these notes are applied to your system
before testing of BCP 1.0A can be performed, as a basis for later use in production of BCP
1.0A.

ASTM D 1250-04 API MPMS Chapter 11.1

5/18

2. Overview of ASTM D 1250-04

Read the API Manual of Petroleum Measurement Standards (MPMS) Chapter 11.1 manual
carefully.
This standards implementation requires a 64-bit based floating point arithmetic system. SAP
has implemented 64-bit floating point Arithmetic since at least the R/3 3.1H Kernels.
Instead of the formerly known tables, six main procedures have been defined representing the
calculation types responsible for the table values calculation.

Based on 60 degree Fahrenheit we have to use the following procedures:

11.1.6.1 type 1, Base to Alternate conditions

11.1.6.2 type 2, Observed to Base conditions
11.1.6.3 type 3, Observed to Alternate Conditions (uses 11.1.6.2 and 11.1.6.1)

Based on a metric base (15 C or 20 C) we have to use:

11.1.7.1 type 1M, Base to Alternate conditions

11.1.7.2 type 2M, Observed to Base conditions
11.1.7.3 type 3M, Observed to Alternate Conditions

Since all calculations are internally based on 60 F, the metric based procedures always result
in a Type 3 calculation at 60 F.

We have defined new conversion groups based on the existing groups, which in turn are based
on the old API tables; this is important to note as the SAP QCI as well as the QuantityWare
Model based QCI (MQCI) is controlled by conversion groups.

ASTM D 1250-04 - API MPMS Chapter 11.1

6/18

There are several notable changes within the ASTM D1250-04 standard such as:

Density of water at 60 F
Temperature scale of 1990
Rounding and precision
Glass Hydrometer corrections
Pressure correction (0 PSI -> no pressure correction)

The final calculation is always based on:

Temperature:

Pressure:

PSI

Density:

kg/m

Thermal expansion factor:

1/F

ASTM D 1250-04 API MPMS Chapter 11.1

7/18

3. Calculation of thermal expansion coefficients

The API MPMS Chapter 11.1 also provides an implementation instruction for the calculation of a
products specific thermal expansion coefficient (required if you utilize the special applications
C tables). With CSP12 for BCP 10A, QuantityWare delivers a complete implementation of this
calculation type, which is accessible from the Petroleum Measurement Cockpit:

Choose Thermal expansion factors and select F8 (Execute) to access the calculation tool:

ASTM D 1250-04 - API MPMS Chapter 11.1

8/18

Using different activities, you can create/copy material data for which you can enter laboratory
measurement results (densities at various temperatures) and then calculate the thermal
expansion factor.

ASTM D 1250-04 API MPMS Chapter 11.1

9/18

4. Test Report
The ASTM D1250-04 test report can be easily accessed via the Petroleum Measurement
Cockpit:

Main Functions
1. Installation Test.
This is the default function when the report is called.
No further input is necessary.
All necessary functions will be checked, see (2), (3) and (4).
The report tests all calculation logic as defined by the standard and in addition, quantity

ASTM D 1250-04 - API MPMS Chapter 11.1

10/18

conversions that are controlled by conversion groups.

2. Test of 90 examples provided by the standard ASTM D 1250-04.

3. Test of the provided conversion groups via the SAP QCI.

The test covers :
All 16 conversion groups provided for standard use
The API 1980 tables simulation
The1980 API C codes (if available at customer site and configured for SAP usage)
The 2004 API C++ code (if available at customer site and configured for SAP usage)

4. List the differences of all implementations results mentioned under (3).

Gives an overview as to the expected differences when switching between two standards /
solutions.

Report Details:
Selection Screen: Run installation test

No data input is necessary in order to run this report.

Upon execution, Run installation test is the function selected by default.
This test can be run at any time within a client in which the QuantityWare BC (for your CSP
maintenance level) set has been activated, to ensure that the installation is correct and
customizing is consistent and complete.
If any of the required configuration or customising is missing or incorrect, an error message will
appear detailing what has to be corrected, so that the test may be continued.

ASTM D 1250-04 API MPMS Chapter 11.1

11/18

Diagram 1 - Initial screen after calling the report:

1. Installation Test
This consists of a series of Modules:
The report first runs through all 90 examples provided by the standard (checking the
calculation results against the results defined in the standard).
A full test via QCI is executed, with the following sub-steps:
All necessary units are checked for consistency along with any related SAP QCI BAdI
(these are not allowed to be active as they could affect the test results). If these checks
fail, a clear error message is returned.
The QCI is checked to ensure that it is working correctly using QuantityWare conversion
groups.
If both tests run successfully, the results are displayed as shown below.

ASTM D 1250-04 - API MPMS Chapter 11.1

12/18

Diagram 1.1 Successful test result

ASTM D 1250-04 API MPMS Chapter 11.1

13/18

2. Examples of the API Standard

The API standard provides 90 examples by which the technical correctness of an installations
calculation can be measured.
It is possible to:
Execute all 90 examples (default),
Select all examples of only one of the six calculation procedures,
Execute one single test case.
If a single test case has been selected, it is possible to change the input data to check any
special case.

Diagram 2.1 - The initial screen.

ASTM D 1250-04 - API MPMS Chapter 11.1

14/18

If the results are correct, the example is marked with O.k., if an error is returned - with Error.
The total number of examples and errors is listed too.
If a protocol line is selected, all input and output data is shown, as well as the expected
results.

Diagram 2.2

ASTM D 1250-04 API MPMS Chapter 11.1

15/18

3. Examples based on conversion groups (via the SAP QCI).

If the UoM definitions are consistent and no BAdI is active, the test via QCI and the provided
conversion groups will be executed based on the selected implementation as shown in the
screen below.
By default, the standards ABAP (BCP 10A) implementation is tested.

Diagram 3.1 Initial Screen

ASTM D 1250-04 - API MPMS Chapter 11.1

16/18

The result is shown in a list (see Diagram 3.2). If any errors occur, all messages will be listed.

Diagram 3.2 All selected procedures have been successfully tested.

ASTM D 1250-04 API MPMS Chapter 11.1

17/18

5. Integration into SAP - QCI desktop calculator

This implementation is fully integrated into the SAP QCI and thus into all logistics processes of
the SAP oil & gas ERP system. The desktop calculator (transaction O3QCITEST, easily
accessible via the Petroleum Measurement Cockpit) can be used to calculate ASTM D1250-04
product quantities for all conversion groups:

ASTM D 1250-04 - API MPMS Chapter 11.1

18/18