IHS™ Kingdom® 2016

IHS Kingdom Gateway

IHS Kingdom Gateway plug-in for Petrel* software provides direct connectivity between IHS
Kingdom and Petrel software. Designed for the interpreter, Kingdom Gateway streamlines the
interpretation to modeling work flow providing immediate data access. Easily move single
objects, folders or customized lists between the two applications. If duplicate objects exist,
you can skip, update or add the duplicate object using the conflict resolution feature.

Note: Kingdom Gateway does not require any additional middleware or licenses.

Note: * is a mark of Schlumberger.

Related topics
Requirements and Supported Objects
The Workspace
Transferring Objects from Kingdom
Transferring Objects from Petrel
Conflict Resolution
Requirements and Supported Objects

Requirements and Supported Objects

Software Requirements
The following table displays the Kingdom <> Petrel version requirements:

Kingdom 8.8 SP1 Petrel 2121.x, 2013.x

Kingdom 2015 Petrel 2013.x, 2014.x, 2015.x

Kingdom 2016 Petrel 2015

Transfer Requirements
• Both Kingdom and Petrel projects must be open
• Projects must have same:
- Coordinate Reference System (CRS)
- Depth Units (ft/m)
- Surface Units (ft/m)
- SRD (Seismic Reference Datum)

Supported Objects
The following table defines the data types that Kingdom Gateway supports for transfer
between Kingdom and Petrel.

Objects Kingdom to Petrel Petrel to Kingdom

Wells  **

Deviation surveys  **

Time Depth Tables  **

Digital Log Curves  **

Formation Tops  

Interpreted Grids  

Faults 

Survey Geometry 

Horizons 

** Available in Kingdom Gateway 2016 - Petrel 2015 only.

16 IHS Kingdom® 2016.1

 The Workspace

The Workspace
The Kingdom Gateway workspace is determined by the direction that objects are being
transferred; Kingdom to Petrel or Petrel to Kingdom. The default direction is Kingdom to
Petrel. To change the view, click the Direction drop down.

Related Topics
Kingdom to Petrel
Petrel to Kingdom

IHS Kingdom® 2016.1 17

The Workspace

Kingdom to Petrel
There are two options when transferring objects from Kingdom to Petrel:
• Transfer Now—Default mode used to transfer objects immediately when dropped onto
the workspace.
• Add to List—This mode provides controls and filters that allow you to select and modify
object attributes or set thresholds before they are transferred.
Transfer objects from Kingdom to Petrel by dragging and dropping object(s) from the
Kingdom Project Tree anywhere onto the Kingdom Gateway Workspace.

Transfer Now
Using this method accepts all of an objects attributes and assigns Petrel’s default templates.

1 Direction Determines direction of data transfer; Kingdom to Petrel or Petrel

to Kingdom

2 Method Selects method of transfer; Transfer Now or Add to List

3 Source Project Selects open Kingdom project to transfer data from

4 Target Project Selects open Petrel project to receive data

5 Status Indicator • Indicates number of objects transferred during last operation.

• Displays status messages when clicked.
• Background color:
• Grey = Ready
• Green = All objects transferred successfully
• Red = Issues found during last operation

6 Help Opens Help file

18 IHS Kingdom® 2016.1

 The Workspace

Add to List
The Add to List option provides additional controls to filter and select associated data
preferences. In addition, additional Petrel templates can be selected.

1 Selected Drop down list to select object types displayed in the List Pane(s).
Kingdom objects You can add multiple types of objects when building a list but only
display one type at a time in the List Pane(s).

2 List Pane(s) Dynamic list that provides parameters and filters of selected object
types attributes.

3 Clear List Clears all Kingdom objects currently in list.

4 Messages Hides or Shows last operation status messages.

5 Transfer Transfers all Kingdom objects in list to Petrel.

IHS Kingdom® 2016.1 19

The Workspace

Petrel to Kingdom
All data objects available for transfer are shown in the Petrel Input Tree panel and can be
selected by either double-clicking or selecting objects and using the move buttons.

1 Direction Determines direction of data transfer: 

Petrel to Kingdom or Kingdom to Petrel

2 Source Project Selects the open Petrel project to transfer data from

3 Target Project Selects the open Kingdom project to receive data

20 IHS Kingdom® 2016.1

 The Workspace

4 Status Indicator
Indicates the number of objects transferred during the last
operation and displays status messages when clicked.
Background color indicates the status:
• Grey = Ready
• Green = All objects transferred successfully
• Red = Issues found during last operation

5 Help Opens Help file

6 Petrel Input Tree Available objects (see supported data types) for transfer

7 Selected Petrel Items Selected objects for transfer

8 Move Buttons Moves selected objects to appropriate pane

9 Refresh Refreshes Petrel Input Tree pane

10 Transfer Transfers selected Petrel objects to Kingdom

11 Messages Hides or Shows last operation status messages

IHS Kingdom® 2016.1 21

Transferring Objects from Kingdom

Transferring Objects from Kingdom

There are two options when transferring objects from Kingdom to Petrel:
• Transfer Now—Default mode used to transfer objects immediately when they are
dropped onto the workspace.
• Add to List—This mode provides controls and filters that allow you to select and modify
object attributes or set thresholds before they are transferred.
When a folder is selected for transfer, all data under that folder will be sent. When Wells are
transferred, all attributes belonging to the well (Digital Logs and Formation Top Picks) will be
included.
Kingdom objects will initially be placed in Received Kingdom (type) directory.

Related Topics
Transfer Now
Add to List

22 IHS Kingdom® 2016.1

 Transferring Objects from Kingdom

Transfer Now
The Transfer Now option allows users to immediately transfer data objects from Kingdom to
Petrel. Simply drag single, multiple or entire folders of objects from Kingdom onto the IHS
Kingdom Gateway workspace.

Kingdom to Petrel Transfer Now

1. Select the direction > Kingdom to Petrel
2. Select the method > Transfer Now
3. Select the open Kingdom source project
4. Select an open Petrel target project
5. Drag objects (single, multiple or entire folders) from the Kingdom project tree and drop
them onto the IHS Kingdom Gateway workspace. Kingdom objects will begin transferring
to Petrel immediately.
a. Wells
- When wells are transferred, the Well Log Definition dialog is displayed showing
the current minimum and maximum values for each type of log.
- Select type of log to display from the drop down list
- Verify or select a template and unit for each log type.
- Click OK to continue.
b. Duplicate Objects
- If a transferred object already exists in Petrel, the Data Issues Found dialog will
be displayed with the option to skip, update or add the duplicate object(s). For
more information see Conflict Resolution.

IHS Kingdom® 2016.1 23

Transferring Objects from Kingdom

Add to List
The Add to List option provides greater control of which and how Kingdom objects are
transferred. Filters and controls allow you to define the attributes and value ranges of an
object being transferred.

Kingdom to Petrel Add to List

1. Select the direction Kingdom to Petrel.
2. Select the method Add to List.
3. Select the open Kingdom source project.
4. Select an open Petrel target project.
5. Build the list by dragging objects from the selected Kingdom project onto the Kingdom
Gateway workspace. Continue building until all objects and types have been added.
6. Edit the list by selecting only the objects and attributes desired.
a. Select object type (Wells, Grids, etc...) from the Selected Kingdom objects drop
down list.
b. Select or clear individual objects not to be transferred from left pane.
c. Select all attributes from right pane controls and check boxes to be included in
transfer. Ranges can also be set using filter controls.
d. Repeat steps 6a through 6c for all object types.
7. Click Transfer.

24 IHS Kingdom® 2016.1

 Transferring Objects from Kingdom

a. Wells
- When wells are transferred, the Well Log Definition dialog is displayed showing
the current minimum and maximum values for each type of log.
- Select type of log to display from the drop down list
- Verify or select a template and unit for each log type.
- Click OK to continue.
a. Duplicate Objects
- If a transferred object already exists in Petrel, the Data Issues Found dialog will
be displayed with the option to skip, update or add the duplicate object(s).

IHS Kingdom® 2016.1 25

Transferring Objects from Petrel

Transferring Objects from Petrel

All data objects available for transfer will be shown in the Petrel Input Tree panel and can be
selected by either double-clicking, or selecting objects and using the move buttons.
The following data objects can be sent from Petrel to Kingdom:

Wells Digital log curves

Deviation surveys Formation top picks

Time-Depth tables Grids

When transferring objects from Petrel to Kingdom:

• Drag and Drop is not supported. Objects can be selected and moved by double-clicking,
or selecting objects and using the move buttons.
• Names of transferred interpretation objects (Picks and Grids) are appended to include
[Petrel] in Kingdom project tree.

26 IHS Kingdom® 2016.1

 Transferring Objects from Petrel

Transfer Petrel Objects

1. Select the direction Petrel to Kingdom.
2. Select an open Petrel source project.
3. Select the open Kingdom target project.
4. Select and move objects (single, multiple or folders) from the Petrel Input Tree pane to
the Selected Petrel Items pane.
5. Click Transfer.

IHS Kingdom® 2016.1 27

Conflict Resolution

Conflict Resolution
A conflict occurs when Kingdom objects being transferred all ready exist in a Petrel project.
When a conflict occurs, the Data Issues Found window displays with a separate tab for each
conflict type and number of conflicts.
There are three possible resolutions for duplicate objects:
• Skip—Duplicate object is ignored and does not transfer
• Update—Updates attributes of the existing object in target project
• Add—Adds duplicate object with appended name in target project

Note: Canceling without selecting a resolution will transfer only the non-conflicting objects.

Resolving Conflicts
Conflict resolution procedures are the same for Kingdom and Petrel transfers. However,
conflicts will never occur the first time an object is transferred back to Kingdom because the
objects name is appended with [Petrel] and thus viewed as a different object. If the same
object is transferred again, it will appear as a duplicate and require a resolution.

Apply to All
1. In the Global Duplicate Option list, select the resolution option.

28 IHS Kingdom® 2016.1

 Conflict Resolution

2. Click Apply to All.

When complete, a green check appears and the next tab becomes active.
3. Repeat for each tab.

Individual Object Resolution

1. Select a resolution for each object in the Duplicate Options column.
2. Click OK. When complete, a green check appears and the next tab becomes active.
3. Repeat for each tab.

IHS Kingdom® 2016.1 29

Conflict Resolution

30 IHS Kingdom® 2016.1