Petroleum ASTM D1250-04 SP12

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 e rrors or omissions with respect to the materials provided. The only warranties for the products and services of QuantityWare GmbH are those set forth in t he 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 CHAPT ER 11.1 ........................................................................... 1

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

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

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

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

2. Overview of AST M 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.


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) w ill 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.


5/18

2. Overview of ASTM D 1250-04

Read the “ API Manual of Petroleum Measurem ent 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.


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:

°F

Pressure:

PSI

Density:

kg/m

Thermal expansion factor:

1/°F

3


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:


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.


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


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.


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 BA dI (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.


12/18

Diagram 1.1 – Successful test result


13/18

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.


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


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

Diagram 3.1 – Initial Screen


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.


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:


18/18

Petroleum ASTM D1250-04 SP12

Recommend Documents