petroleum astm d1250-04 sp12[1]

14.07.2009

BCP 10A

ASTM D 1250-04 -

API MPMS Chapter

11.1

Standard Guide for Use of the

Petroleum Measurement Table

Implementations.

Version 03 (SP12)

ASTM D 1250-04 - API MPMS Chapter 11.1 2/18

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 3/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


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.


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.


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.


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: °F

Pressure: PSI

Density: kg/m3

Thermal expansion factor: 1/°F


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:


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.


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


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.


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.


Diagram 1.1 – Successful test result


2. Examples of the API Standard

The API standard provides 90 examples by which the technical correctness of an installation’s

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.


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


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 standard’s ABAP (BCP 10A) implementation is tested.

Diagram 3.1 – Initial Screen


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.


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:

petroleum astm d1250-04 sp12[1]

Documents