You are on page 1of 12

BCP 1.

0A Standard Implementation: Density and VCF correction

01.08.2007

Notes:
Copyright 2007 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.

Contents
BCP 1.0A ....................................................................................................................................... 1

STANDARD IMPLEMENTATION: DENSITY AND VCF CORRECTION..................................... 1

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

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

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

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

2. Components of the Installation ..................................................................................... 6 Conversion Groups: ............................................................................................. 6 Reading Groups: .................................................................................................. 7

3. Formula and requirements ........................................................................................... 9 Implemented formula ........................................................................................... 9 Ranges and Rounding ......................................................................................... 9

4. Installation Test .......................................................................................................... 11

Introduction

This solution is an implementation of a formula for the linear correction of density or volume correction factor. It is part of the product Bulk Calculations Petroleum Version 1.0A (BCP 10A).

The density of products such as Biodiesel and certain chemicals can be corrected to a base temperature by using a linear correction formula: Density(base temperature) = Density(observed temperature) + <factor> * delta-temperature

It is also possible to correct the volume by calculating a Volume Correction Factor (VCF) in a similar way, which actually is the inversion of the formula above: VCF = 1 - <factor> * delta-temperature

The factor is a material-specific constant which can also be dependent on the standard used by the customer; however the formula will remain structurally identical. QuantityWare has implemented a generic formula which can be utilized as a standard formula. The observed, base and alternate conditions as well as VCF and Base Density are fully supported as in all other standards implementations from QuantityWare.

The factor can be included into the appropriate reading group and will appear on the related input screen. A default can be defined in the reading group which may be used as defined, or overwritten by the user.

This solution can be accessed via the SAP Quantity Conversion Interface (QCI) and is controlled by the conversion group provided.

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 & Gas must be installed QuantityWares BCP 10A must be installed.

Customizing settings are included in this package; they are needed in every client in which this standard is to be used. On ERP releases 4.72 and below, the related customizing transport must be imported into all necessary clients, or distributed to them from client 000. On releases 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.

2. Components of the Installation


The main part of the installation is

Function:

/QTYW/DENSITY_CORRECTION Determine Base Density and VCF based on a density corr. Factor /QTYW/VOLUME_CORRECTION Determine Base Density and VCF based on a VCF formula

Which are a part of the Function Group: /QTYW/STANDARDS Standard Procedures of Oil and Gas

The functions can be called via the Export/Import interface or from within the application via the QCI, using the conversion groups provided. Conversion Groups: To allow usage of the Density and VCF correction: Q000 - DENSITY CORRECTION, DENSITY, 15C Q001 - DENSITY CORRECTION, REL. DENSITY, 15C Q002 - DENSITY CORRECTION, API GRAVITY, 15C Q003 - DENSITY CORRECTION, DENSITY, 20C Q004 - DENSITY CORRECTION, REL. DENSITY, 20C Q005 - DENSITY CORRECTION, API GRAVITY, 20C Q006 - DENSITY CORRECTION, DENSITY, 60F Q007 - DENSITY CORRECTION, REL. DENSITY, 60F Q008 - DENSITY CORRECTION, API GRAVITY, 60F

Q010 - VOLUME CORRECTION, DENSITY, 15C Q011 - VOLUME CORRECTION, REL. DENSITY, 15C Q012 - VOLUME CORRECTION, API GRAVITY, 15C Q013 - VOLUME CORRECTION, DENSITY, 20C Q014 - VOLUME CORRECTION, REL. DENSITY, 20C Q015 - VOLUME CORRECTION, API GRAVITY, 20C Q016 - VOLUME CORRECTION, DENSITY, 60F 6

Q017 - VOLUME CORRECTION, REL. DENSITY, 60F Q018 - VOLUME CORRECTION, API GRAVITY, 60F Reading Groups: Q000 - DENSITY CORRECTION, DENSITY, 15C Q001 - DENSITY CORRECTION, REL. DENSITY, 15C Q002 - DENSITY CORRECTION, API GRAVITY, 15C Q003 - DENSITY CORRECTION, DENSITY, 20C Q004 - DENSITY CORRECTION, REL. DENSITY, 20C Q005 - DENSITY CORRECTION, API GRAVITY, 20C Q006 - DENSITY CORRECTION, DENSITY, 60F Q007 - DENSITY CORRECTION, REL. DENSITY, 60F Q008 - DENSITY CORRECTION, API GRAVITY, 60F

Q010 - VOLUME CORRECTION, DENSITY, 15C Q011 - VOLUME CORRECTION, REL. DENSITY, 15C Q012 - VOLUME CORRECTION, API GRAVITY, 15C Q013 - VOLUME CORRECTION, DENSITY, 20C Q014 - VOLUME CORRECTION, REL. DENSITY, 20C Q015 - VOLUME CORRECTION, API GRAVITY, 20C Q016 - VOLUME CORRECTION, DENSITY, 60F Q017 - VOLUME CORRECTION, REL. DENSITY, 60F Q018 - VOLUME CORRECTION, API GRAVITY, 60F

The reading groups are assigned to the conversion groups and are delivered with valid default values.

QuantityWare recommend that you copy the needed conversion and reading groups to a customer namespace - allowing customization for special needs, while retaining the integrity of the customising delivered by QuantityWare.

It is possible to copy the same conversion group multiple times with differing target names, allowing a default correction constant to be set per reading group. Such defaults also can be stored in the QCIs default table. The necessary QCI Parameter can be found in the reading groups provided. They are already customized as a QCI parameter in all tables.

Parameters:

/QTYW/DCF

- Density Correction Factor

/QTYW/DCFT - Density Corr. Fact. Temp. Unit /QTYW/VCC - Volume Correction Constant

Test program:

/QTYW/DENSITY_VCF_CORR_TEST

3. Formula and requirements


Implemented formula The implemented formula provides a linear correction. Density Correction: Density (base temperature) = Density (observed temperature) + <factor> * delta-temperature

VCF (Volume Correction Factor) Correction: VCF = 1 - <factor> * delta-temperature Where: delta-temperature = observed temperature base temperature <factor> = material specific constant

The implementation works internally with density in Kg/m3 and the temperature unit of the base temperature. If necessary, input data will be converted. The result will be converted back to the units of the conversion group. Ranges and Rounding Ranges of density and temperature There is no check implemented to verify these ranges, as the standard is intended to be generic.

Rounding Rounding of input and output is NOT implemented, but can be performed by the inclusion of functions (provided by QuantityWare) in the conversion group external calls sequence, before and/or after the calculation function.

The following functions are currently available: /QTYW/ROUND_BAS_DENSITY_1_1 Rounding BASE DENSITY by 1 decimal to nearest 1 /QTYW/ROUND_BAS_DENSITY_1_5 Rounding BAS DENSITY by 1 decimal to nearest 5 /QTYW/ROUND_BAS_DENSITY_4_1 Rounding BAS DENSITY by 4 decimals to nearest 1 /QTYW/ROUND_OBS_DENSITY_1_1 Rounding OBSERVED DENSITY by 1 decimal to nearest 1 (0.1)

/QTYW/ROUND_OBS_DENSITY_1_5 Rounding OBSERVED DENSITY by 1 decimal to nearest 5 (0.5) /QTYW/ROUND_OBS_DENSITY_4_1 Rounding OBSERVED DENSITY by 4 decimals to nearest 1 (0.0001) /QTYW/ROUND_TEST_TEMP_1_1 Rounding TEST TEMPERATURE by 1 decimal to nearest 1 (0.1) /QTYW/ROUND_TEST_TEMP_2_5 Rounding TEST TEMPERATURE by 2 decimals to nearest 5 (0.05) /QTYW/ROUND_MAT_TEMP_2_5 Rounding MATERIAL TEMPERATURE by 2 decimals to nearest 5 (0.05) /QTYW/ROUND_MAT_TEMP_1_1 Rounding MATERIAL TEMPERATURE by 1 decimal to nearest 1 (0.1)

10

4. Installation Test
Along with the standard, QuantityWare provides a test program that can be used to verify the installation and to investigate the standard:

/QTYW/DENSITY_VCF_CORR_TEST There two ways to call and use the function: Call the function via the QCI controlled by the conversion group. A direct call via the Import / Export interface The option Installation Test is the default and runs all implemented examples.

11

Result:

The functionality and handling of all QuantityWare test programs is very similar.

We hope that you enjoy using this standard. We are constantly seeking to improve all QuantityWare products. If you have any suggestions or comments regarding this standard, please send a mail to support@quantityware.com.

Best Regards,

QuantityWare Product Development.

12

You might also like