OpenSpirit Adapter for Petrel Installation Guide · PDF filePetrel 2013.x • OpenSpirit ... 3. Click on the Install plug-in button. ... OpenSpirit Adapter for Petrel Installation

TIBCO OpenSpirit® Adapter for Petrel Installation Guide

Software Release 22.0.0

July 2013

Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENTIS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.

TIBCO, The Power of Now, TIBCO OpenSpirit Adapter for Petrel are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.

All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE RELEASE NOTES FOR THE AVAILABILITY OF THIS SOFTWARE VERSIONON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright©2000-2013 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

Table of Contents | 3

OpenSpirit Adapter for Petrel Installation Guide

Table of Contents Installation Steps ............................................................................................................. 5

Ocean Plug-in Manager Installation Method ................................................................ 5

Windows Installer Installation Method .......................................................................... 7

Uninstalling .................................................................................................................... 12

Ocean Plug-in Manager Uninstall ............................................................................... 12

Windows Installer Uninstall ........................................................................................ 13

Installation Files............................................................................................................. 15

Glossary ........................................................................................................................ 16

4 | Installation Prerequisites


Installation Prerequisites The TIBCO OpenSpirit Adapter for Petrel requires the following software be installed prior to installation:

• Petrel 2013.x • OpenSpirit runtime v4.0.3 (or newer)

The supported Windows versions are those that Petrel supports. Refer to the Petrel application documentation for operating system and hardware requirements. The TIBCO OpenSpirit Adapter for Petrel requires an Ocean plug-in license feature named "OCEAN_TIB_OPENSPIRITADAPTER" to be available and it requires a Petrel Geoscience Core license. The public key token for the TIBCO OpenSpirit Adapter for Petrel is 6fff63412f6928a6. ECCN: US origin, EAR99

Installation Steps | 5


Installation Steps The TIBCO OpenSpirit Adapter for Petrel can be installed using the Ocean Plug-in Manager or it can be installed using a Windows Installer (.msi file). Both methods of installation are described below.

Ocean Plug-in Manager Installation Method 1. Download the Plug-in Installer Package (.pip) file for the OpenSpirit Adapter and

start Petrel. 2. Select the Ocean Plug-in Manager option in the Petrel Help menu.

6 | Installation Steps


This will open the Ocean Plug-in Manager window.

3. Click on the Install plug-in button. This will open a file selector window. Select the OpenSpirit Adapter .pip file.

An installation confirmation message will appear after the plug-in has been installed. The message confirms the plug-in has been installed, but requires Petrel to be restarted in order to see and use the plug-in.



4. Close the Ocean Plug-in Manager window and restart Petrel.

The plug-in can be installed in a directory outside of the Petrel installation, by modifying the "DefaultDirectory" entry in Petrel's %APPDATA%\Schlumberger\Petrel\2013\PluginManagerSettings.xml. This is a Petrel feature.

Windows Installer Installation Method 1. Download the plug-in installer .msi file.

2. Make sure the Petrel application is not running. Start the installer by double clicking on the .msi file in Windows File Explorer.



3. Follow the installation wizard and click the "Next>" Button when prompted



4. A progress bar appears while the plug-in files are installing.



5. Click on the Close button when the installation is complete.



6. After a successful installation the OpenSpirit tool bar should appear in Petrel the next time it is launched.

12 | Uninstalling


Uninstalling The procedure for uninstalling the OpenSpirit Adapter depends on the method used to install the adapter.

Ocean Plug-in Manager Uninstall An OpenSpirit Adapter that was installed using the Ocean Plug-in Manager is uninstalled using the Ocean Plug-in Manager. Open the Ocean Plug-in Manager from the Petrel Help menu and click on the OpenSpirit Adapter entry.

This will expand the OpenSpirit Adapter entry exposing an Uninstall button. Click on the Uninstall button to uninstall the plug-in.

Uninstalling | 13


A progress window will appear while the plug-in is uninstalling. Click on the Close button when the uninstall is complete. The plug-in will still appear in the installed plug-ins list. You will need to restart Petrel for the plug-in to be removed from the list and from the Petrel tool bar.

Windows Installer Uninstall An OpenSpirit Adapter that was installed using a Windows installer (.msi file) is uninstalled using the Windows Control Panel's Program and Features list as shown in the following image.

The adapter can be removed by selecting it from the list and clicking on the Uninstall option. Make sure Petrel is not running before starting the uninstall. A confirmation prompt may appear when the Uninstall option is selected.

14 | Uninstalling


Click on the Yes button to proceed with the uninstall. A progress window will then appear.

The progress window will go away when the uninstall completes. The OpenSpirit Adapter will not appear in Petrel when Petrel is restarted.

Installation Files | 15


Installation Files The following files are created by the installation in a new extensions folder named "%OCEAN2013HOME%\Extensions\TIBCO\OpenSpirit Adapter 22.0.0". These files and the OpenSpirit Adapter folder are removed during uninstall.

GISAttributeSchemaExample.xml GisAttributesSchema.xsd GisExtendedAttributes.dll help.chm Launcher.ico log4net.dll LogNameToLogMnemonic.xml ModuleInstalled.ico OceanUserPluginConfig.config OpenSpirit.App.Ocean.Interfaces.dll OpenSpirit.App.Ocean.Petrel2013.dll OpenSpirit.App.Ocean.PlugIn.dll OpenSpirit.App.Ocean.PlugIn.Plugin_Manifest.xml OpenSpirit.App.Opf.dll OpenSpirit.App.Opf.Impl_31.dll OpenSpirit.dll OpenSpirit.NET.dll OpenSpiritGroupingConfig.config OpenSpiritHorizonTypeAndPetrelTemplate.xml OpenSpiritLogKindToPetrelMnemonic.xml OpenSpiritPlugin.config OpenSpiritPlugin.log4net OpenSpiritStudioFindLoader.dll OpenSpiritTitle.gif OpenSpiritWellSymbolsToWellType.xml Plugin.xml Support.config WellTypesToOpenSpiritWellSymbol.xml ZgyJobs.exe ZgyMonitor.exe ZgyMonitor.exe.config

16 | Glossary


Glossary A

application adapter: A piece of software that allows an application to connect to OpenSpirit in order to read/write data from any data store with an OpenSpirit data connector or to exchange events (messages) with other OpenSpirit enabled applications.

C CRS: A Coordinate Reference System. In Petrel, a project has a CRS which is a map

projection system with a reference geographic system which has an associated datum. In addition, a preferred datum shift to WGS84 is defined.

D data connector: A piece of software that connects a data store to OpenSpirit to allow

applications that connect to OpenSpirit to read/write data from this store. data selection event: A message passed between applications, via OpenSpirit, that

contains datakeys that refer to data in data stores accesible via an OpenSpirit data connector.

datakey: Link that connects a Petrel object (e.g. a well, seismic volume, or horizon) to a data item in an external data store.

datakeys: Links that connect a Petrel object (e.g. a well, seismic volume, or horizon) to a data item in an external data store. Given a datakey OpenSpirit can read or write any updates to/from Petrel.

datum shift: A transformation from one geographic system (and its associated datum) to another. There are different algorithms use to accomplish this transformation including: geocentric translation (3 parameters) Molodensky (5 parameters), Bursa/Wolfe (7 parameters) , and grid based approach such a NADCON or NTv2

G gis event: A message passed between applications, via OpenSpirit, that contains the

geometry. attributes, and CRS of point, polyline, or polygon features that belong to GIS layers. Such messages are normally used to exhange data between applications that is posted as culture data in a basemap.

grid event: A message passed between applications, via OpenSpirit, that contains the grid defintion, grid values, CRS and z units of a grid representing the elevation of a geologic surface or some other attribute defined on a grid. A Petrel surface may be sent as a grid event.

Glossary | 17


L live-link: A 3D seismic virtual attribute cube created when importing a 3D seismic

volume using OpenSpirit. A live-link does not contain seismic data, it points to seismic data that resides in the database it was selected from (e.g. OpenWorks, GeoFrame, etc.). Seismic data is dynamically read from the source database when a Petrel window or process requests data from the live-link. Live-links can be converted into a normal 3D seismic object by realizing the live-link.

M MSL: mean sea level

S SRD: A seismic reference datum (SRD) is the elevation (with respect to MSL) at which

the seismic travel time equals zero.

Documents

OpenSpirit Adapter for Petrel Installation Guide · PDF filePetrel 2013.x • OpenSpirit ... 3. Click on the Install plug-in button. ... OpenSpirit Adapter for Petrel Installation