Professional Documents
Culture Documents
Petrel Isatis Link PDF
Petrel Isatis Link PDF
User’s Guide
1
Petrel ‹—› Isatis Link
The Petrel ‹—› Isatis Link consists in a module/plugin in Petrel Petrel 2013, Petrel 2014 and Petrel 2015. The
module is provided for 64-bit versions of Petrel.
To install, use Petrel/Ocean Plugin Manager from Petrel File Menu and select the appropriate .PIP file. After
installation and Petrel restart, new icons (for Petrel 2014+) and Processes are available. The new Icons are
located in the Property Modeling Ribbon. The IsatisLink Processes can be used either interactively or in a
workflow.
This plugin allows the exchange of data from PetrelTM to Isatis and vice versa. Four processes are available:
- A Grid+Wells export from PetrelTM to Isatis. The objects that can be exported by this interface are:
o Petrel grids with optional properties, zone surfaces and contacts.
o Wells from which you may specify:
§ the continuous properties to be exported,
§ the discrete properties to be exported,
§ if you want to export markers
- A Grid import from Isatis to PetrelTM which allows you to get one grid variable back from Isatis to an
existing Petrel pillar grid. A consistency check is performed to verify that the numbers of nodes in all
directions match and then the cell values are copied in the new or existing Petrel grid property.
- A Points import from Isatis to PetrelTM which allows you to import a Points File as a Petrel PointSet.
- A Surface import from Isatis to PetrelTM which allows you to import one surface variable from Isatis to
a new Petrel surface.
- A Surface Export from PetrelTM to Isatis which allows exporting a simple Regular surface to Isatis.
The Petrel-Isatis Link adds a button “About IsatisLink” in the Help menu that gives information about the
configuration. In case of troubleshooting, send the content of the display to Geovariances Technical Support
(support@geovariances.com).
2
Table of contents
3
A. Expor t Grid and Wells to Isatis
This interface allows you to export a Pillar Grid and some of its properties along with Wells with their well
continuous/discrete logs, and/or markers.
- Export Grid Properties. In this mode, you will specify a Pillar Grid and its properties. It will be
exported flattened (equivalent to the SimBox visualization mode). You can export either all Zones at
Once or only some Zones, export some Horizons, compute Volumes between Contacts and specify some
Grid Properties to export. When exporting only some zones, you’ll get as many Isatis Grid as you
specified zones.
4
- Export Well Logs only. In this mode, you will specify some Input Wells along with Continuous or
Discrete Logs plus some optional Well Markers. Those will be exported as an Isatis Lines files in real
space.
- Export Grid Properties and Flattened Well Logs. This mode combines the two previous ones except
the Well Logs will be exported Flattened (each log sample is located in the SimBox Grid and exported
with SimBox coordinates). You will get as many Lines files as you specified Grid Zones to export.
- Export Grid Properties and Upscaled Logs as Isatis Pseudo-Wells. This mode is equivalent to the
first one but adds a list of Upscaled Logs to export as Isatis Pseudo-Well Logs. You will get as many
Lines files as you selected Grid Zones and those Lines files will contain only vertical Pseudo-Well, each
well corresponding to a particular (I,J) column.
- Pillar Grid. Select a grid (model) in PetrelTM main interface then press the arrow to drop the grid name
in the export interface.
- All Zones at Once. When checked, all zones will be sent at once. You’ll get one Isatis Grid file, one
Well Lines file, one Surface Grid file… When unchecked, you need to select a list of Zones of interest and
the Export will create as many files of each kind as you have selected zones.
5
- Zones. When not exporting all Zones at once, you can here select Zones from the Grid Zone Filter list.
When selecting a Zone that does contain sub-zones, sub-zones are selected instead.
- Export Surfaces. If activated, this option will export the Top and Bottom surfaces of all the selected
Zones of the Pillar Grid. The Bottom and Top surfaces will be exported as variables in an Isatis 2D Grid.
When exporting All Zones at once, all the surfaces will appear in the same Grid file. Otherwise, you’ll
have as many Grid Files as you selected Zones, each file containing the Top and Bottom Surfaces
variable. The surfaces are adjusted in order to ignore dead cells (no-volume cells) in the zone.
- Compute Volume between Contacts. Check this option if you need to get the Volume of each cell
stored as a new variable in the Isatis 3D Grid file. Indeed, an expansion factor between the flattened
grid cell volume and the real Petrel cell volume is to be stored. You may select a Top and Bottom
Contact between which the volume is computed.
- Pillar Grid Property. If needed, select one or several properties in Petrel TM main interface then press
the arrow to drop the property names in the export interface.
If no parent grid has been previously defined, it will be automatically set in the drop box above.
- Wells. Select one or several Wells in PetrelTM main interface then press the arrow to drop the Wells
names in the export interface. Note that if dropping Well folders, all the Wells inside the Wells folder are
selected instead. You can also use the Drop Plus Arrow that will append to the list instead of replacing
the whole list. When selecting Wells, the list of Well Logs and Well Discrete Logs are automatically
updated.
- Upscaled Logs to export as Pseudo-Wells. Select one or several Upscaled Logs in PetrelTM main
interface then press the arrow to drop the Upscaled Logs names in the export interface. Upscaled Logs
must belong to the already selected Pillar Grid. Upscaled Logs can be either Discrete or Continuous.
- Optional Well Index. Select one Well Index variable in PetrelTM main interface then press the arrow to
drop the Well Index property name in the export interface. The Well Index property must be a Discrete
one and its associated names will be used to name the Vertical Pseudo Wells created during the export.
To create the Well Index property if you don’t have one in the Pillar Grid, please use Property Modeling -
> Geometrical Modeling from PetrelTM processes window.
6
o Check the option Export All Continuous Logs if you want to export all Well Continuous Logs in
one go. This feature is particularly useful when the process is run from a workflow. Leave this
option clear if you wish to select the properties to be exported from the list.
o Check the option Export All Discrete Logs if you want to export all Well Discrete Logs in one go.
This feature is particularly useful when the process is run from a Workflow. Leave this option clear if
you wish to select the properties to be exported from the list.
o Check the option Export Well Markers to export the markers associated to the selected Wells into
a separate Isatis point file with the same name as the Well Marker.
§ The Drop Arrow allows you to select Marker Collections. If left empty, all the Marker
Collections will be used, possibly allowing several points to be exported for the same
well/marker name combination.
You now have to choose the destination study, directory and files in Isatis. You also have to indicate how to
connect to the Isatis database (the default option should work in most cases).
- Advanced. Click this button to specify the advanced Isatis database connection parameters. The
default is to run locally a new database server.
- Connect. After setting the advanced parameters, click this button to connect to the database server.
7
- Existing Study. Once connected, select the Isatis Study where the data will be exported.
- (New) Directory Name. Enter the name of the directory where the output files will be stored. This
directory name can be a non-existing one in which case it will be created.
- (New) Grid File Name. Enter the name of the grid file where the imported data will be saved. This file
name can be a non-existing one in which case it will be created.
- Grid Definition. Enter the grid mesh for the created grid. It allows you to get a flattened grid with
better coordinates (You may enter a new origin (X0, Y0, Z0), a new mesh (DX, DY, DZ) and a rotation
angle around Z).
o Approximate from Pillar Grid. Automatically sets the Grid Origin, Mesh and Rotation to get the
Isatis grid use almost the same coordinates as the Petrel Pillar Grid (can be useful in cases where
the Grid is almost regular). The “Revert I Axis” and “Revert J Axis” are also set by this action.
o Revert I Axis, Revert J Axis: Export the cells with higher I (respectively J) index to Isatis Cells
with the lowest IX (respectively IY) rank and vice-versa. This option allows to mirror the grid
horizontally or vertically.
-
- (New) Lines File Name. Enter here a name for the Lines File to be created. Two files are created in
Isatis, a Lines File that contains the sample values and an attached Header Points File that contains the
header information (i.e. Well Id) (see Isatis documentation for more info). This character string will be
used for naming the four files (ex: File_Name (Logs), File_Name (Discrete) and their Header
counterparts).
- Two options are then available:
o Check Create Lines File to create new Lines (+ Points) file in the Isatis database. If the file
already exists, it will be first deleted and created again.
o Check Append to Existing Lines File to append data to already existing Lines file if it exits.
A.V. Exporting
- Press OK to export the selected grid and wells and close the interface.
- Press Apply to export the selected grid and wells while leaving the interface open.
Note that Isatis can only support Regular 2D and 3D Grids so when you export the grid, it is exported
flattened (like it appears in the Simbox visualization mode of Petrel). The grid will be flattened and the grid
mesh, origin and rotation will be the ones you indicated in the interface.
If you export the wells alone, they are exported in the real space. If you export Wells and Grid at
the same time, Wells are exported in the system of the flattened grid. This means that all coordinates of
the wells-related files will be either flattened-grid space or real-world coordinates depending on the fact
8
that you export a grid at the same time or not.
If the specified directory does not exist, it will be created.
If the file specified for the 3D grid does not exist, it will be created, otherwise, it will be checked that the
number of nodes is consistent with the number of nodes of the Petrel grid underlying regular grid. The grid
mesh will also be checked for consistency between what you indicated here and in the existing grid. The
same applies for the surfaces 2D Grid file used to store horizons. The name of the file used for the surfaces
is the name of the Grid File entered in the interface suffixed by “ – Surfaces”.
Grid Properties will be stored in the 3D Grid File as well as the Volume Expansion Factor if asked to
compute volume. The Volume Expansion Factor is the factor by which we must multiply the Isatis grid cell
volume to obtain the original volume of the corresponding Petrel cell. The volume is only computed
between the entered Top and Bottom Contact. Please note that the contacts themselves are not exported
but the Expansion Factor can be used in Isatis Volumetrics window to compute Oil or Gas volumes.
9
B. Impor t Isatis Grid Variable into a Pillar Grid
This interface allows you to import one Isatis grid variable inside an existing Petrel Grid. The Isatis grid and
the Petrel underlying regular grid must have the same number of cells in all directions.
You have first to specify the Isatis study, directory, file and variables that you want to import from Isatis.
You also have to indicate how to connect to the Isatis database (the default option should work in most
cases).
- Advanced. Click this button to specify the advanced Isatis database connection parameters. The
default is to run locally a new database server.
- Connect. After setting the advanced parameters, click this button to connect to the database server.
- Existing Study. Once connected, select the Isatis Study from where the data will be read.
- Directory Name. Then select the directory where the grid file to be imported is stored.
- Grid File Name. Select the grid file containing the variable to import.
- Variable Name. Select the variable that you want to import. If this variable is a macro variable, you
may either read the Whole Macro Variable or specify which index to read (Macro Variable Index).
- Import the Whole Macro Variable. When the imported variable is a Macro variable, activating this
option will create as many properties in the Petrel Pillar Grid as the Isatis Macro Variable has indices.
Warning: this may be very long and may clutter the Petrel Data Tree with a lot of unuseful variables.
10
B.II. Petrel Output File
- Pillar Grid. Select the grid (model) in Petrel TM main interface then press the arrow to drop the grid
name in the import interface.
- Two options are then available:
o If you want to make use of an existed property, check the option Use Existing. Then select the
Grid property of your choice in PetrelTM main interface then press the arrow to drop the property
name in the import interface. This Grid property will be overwritten with the variable contents. If no
parent grid has been previously defined, it will be set automatically in the drop box above. This
option is not available if you asked to Import the Whole Macro Variable.
o If you want to create a new property in Petrel, check the option Create New. Then enter the name
of a new property that will be created.
B.III. Importing
- Press OK to import the Isatis grid variable into PetrelTM and close the interface.
- Press Apply to import the Isatis grid variable into PetrelTM while leaving the interface open.
The geometry of the Isatis grid is checked against the one of the Pillar Grid (the grids must have the same
number of nodes). Then the Isatis variable content is transferred to the selected property. If the property
has to be created, it will be attached to the General Template. You will have to modify it afterwards.
When the grid comes from a previous “Export Grid & Wells to Isatis”, some (hidden) information has been
attached at Export time. Complete Grids can come without this information attached but partial grids
(corresponding to one Zone) or mirrored (I or J Axis Reverted) must have this information. This means
that you cannot create the grid corresponding to one Zone only from within Isatis.
11
C. Impor t Isatis Points
This interface allows you to import one Isatis 3D Points file with a selection of float variables as a new
Petrel PointSet. The Isatis file can be of any organization (Points, Grid, Lines) but the complete geometry
will be lost for the two latest ones. Note that importing Isatis 2D points in Petrel is not possible. If you wish
to do so, please convert the points in 3D beforehand using File/Data File Manager/Convert 2D-3D.
You have first to specify the Isatis study, directory, file and variables that you wish to import from Isatis.
You also have to indicate how to connect to the Isatis database (the default option should work in most
cases).
- Advanced. Click this button to specify the advanced Isatis database connection parameters.
- Connect. After setting the advanced parameters, click this button to connect to the database server.
- Existing Study. Once connected, select the Isatis Study from where the data will be read.
- Directory Name. Then select the directory where the 3D point file to be imported is.
- Points File Name. Select the 3D Points file containing the variable to be imported.
- Import All Float Variables. When true, it will list all the float variables contained in the Input Points
File at Import time so that you don’t have to select them in the list. It is particularly useful for
workflows if the list of variables have changed since the last time you imported your file.
- Variable List. Select the float variables that you want to import if you do not ask to import them all.
- New PointSet Name. Enter the name of the PointSet that will be created in PetrelTM.
12
C.III. Importing
- Press OK to import the Isatis Points file + variables into PetrelTM and close the interface.
- Press Apply to import the Isatis Points file + variables into PetrelTM while leaving the interface open.
A new folder named Import from Isatis is created in the Petrel project. If it already exists, the new
pointset will be added to it.
When the variables are imported, properties will be created in PetrelTM and will be attached to the General
Template. You will have to modify it afterwards.
This interface allows you to import one Isatis surface variable, i.e. a 2D grid variable, inside a new Petrel
surface.
You have first to specify the Isatis study, directory, file and variables that you want to import from Isatis.
You also have to indicate how to connect to the Isatis database (the default option should work in most
cases).
- Advanced. Click this button to specify the advanced Isatis database connection parameters. The
default is to run locally a new database server.
- Connect. After setting the advanced parameters, click this button to connect to the database server
- Existing Study. Once connected, select the Isatis Study from where the data will be read.
- Directory Name. Then select the directory where the grid file to be imported is stored.
- Grid File Name. Select the grid file containing the variable to import.
- Variable Name. Select the variable that you want to import. If this variable is a macro variable, you
also have to specify which index to read (Macro Variable Index).
13
D.II. Petrel Output File
- New Surface Name. Enter the name of the surface that will be created in Petrel TM.
D.III. Importing
- Press OK to import the Isatis surface into PetrelTM and close the interface.
- Press Apply to import the Isatis surface into PetrelTM leaving the interface open.
A new folder named Import from Isatis is created in the Petrel project. If it already exists, a new surface
will be added.
Note that if the variable is of Length type in Isatis (please refer to the Isatis documentation for more
information), it will be converted in meters while being imported into Petrel. If it is a standard floating
variable, it will be imported as it is (by default, it will be considered as being in meters).
This interface allows you to export a regular Surface from Petrel to Isatis. It will create a new Grid File with
an Elevation variable. If several surfaces share the same regular grid definition, the same Isatis Grid File
can be used.
14
Depth property.
If no Grid File name or Variable name has previously been defined, they will be automatically set in the
drop boxes below (respectively with the Surface Name and “Elevation”).
You now have to choose the destination study, directory and file in Isatis. You also have to indicate how to
connect to the Isatis database (the default option should work in most cases).
- Advanced. Click this button to specify the advanced Isatis database connection parameters. The
default is to run locally a new database server.
- Connect. After setting the advanced parameters, click this button to connect to the database server.
- Existing Study. Once connected, select the Isatis Study where the data will be exported.
- Directory Name. Enter the name of the directory where the output files will be stored. This directory
name can be a non-existing one in which case it will be created.
- Grid File Name. Enter the name of the grid file where the imported surface will be saved. This file
name can be a non-existing one in which case it will be created. If it does already exist, it must have
the same regular grid definition (at least in terms of number of nodes). It the existing grid file is
incompatible, you’ll have to delete it from the Isatis interface.
- (New) Variable Name. Enter here a new variable name corresponding to the Elevation.
E.III. Exporting
15
F. How to update the Data File Manager in Isatis
If Isatis was running in background while you imported your data From Petrel, you might have to update
Isatis Data File Manager to update the list of files and variables. To do so, go in “File/Data File Manager”
and press the button Refresh. This action will automatically update your project and all the data you
have imported from Petrel will be displayed in Isatis Data File Manager.
This window allows you to choose some advanced parameters for the connection to the Isatis database.
This connection is made by running a special tool called GTXserver which reads and writes in the Isatis
database. The default parameters should work in most cases however under specific installation cases, you
may have to specify some of those parameters.
The first option allows selecting between running a new GTXserver instance or connecting to an existing
one:
16
- Run GTXserver: This option (the default) runs a new GTXserver each time you click the Connect
button in the main Import/Export interface. This is the preferable way to connect to the Isatis database
except for debug purposes or to connect to a remote machine.
o Force GTXserver Path: When this option is left clear, the application tries to locate the Isatis
installation and run the associated GTXserver executable. If you wish to run another executable,
select this option and specify in the next field which executable to be run. Activating this option
should only be useful if the application cannot find the Isatis installation by itself.
§ GTXserver Path: name of the executable to be run instead of the default one.
- Use an already running GTXserver: This option enables the connection to a server which has been
started manually by either double-clicking on the GTXserver executable in the Isatis installation folder
or by starting it from the command line. The GTXserver may have been started either on the local
machine or another machine on the network. The computer running GTXserver may not necessarily run
Windows, it could be a PC/server running Linux.
o Host: name of the machine on which the GTXserver has been started manually. You may use the
reserved word “localhost” to mean the local machine on which Petrel is running or enter the name
of the machine on the network on which GTXserver has been run.
o Port: TCP/IP port on which the GTXserver is being listening. By default, GTXserver listens on port
5500. However, you may override this default setting when manually running GTXserver by
specifying the “-port” option. In this case, the same port must be used when connecting to the
server. Note that if GTXserver is running on a separate machine through a firewall, this port must
have been unblocked in the firewall configuration on the server machine.
o DATA Path: this field should be left blank in most cases. The interface needs to locate Isatis
studies on the target machine. Isatis keeps a list of studies with their physical paths in the user’s
profile. If the same user is running GTXserver and Petrel, this should not be a problem. However, in
a multiple user environment, you may need to specify where the study list is located. On a Windows
user account, this is %APPDATA%\Geovariances\Isatis (e.g.: c:\Documents and
Settings\username\Application Data). Under UNIX/Linux, this is $HOME/.isatis.
H. Troubleshooting
- Installation failed and said that another version of the module is already installed.
You must uninstall the plugin/link if already installed. Use Control Panel -> Add/Remove Programs. Locate
the IsatisLink entry and remove it, then install the new version.
The portion of file should end-up with a text equivalent to the following one:
17
<oceanConfiguration productName="Petrel 2009.1" productFamilyName="Ocean for Petrel">
<moduleTrusts>
<add trustName="PetrelExtension" publicKeyToken="14ef4a483ef6a64b" />
<add trustName="Default" />
</moduleTrusts>
<moduleGroups>
<!-- Add Ocean API based modules here, …" -->
<add trustName="Default">
<modules>
<!--<add moduleType="Slb.Ocean.Petrel.Sandbox.Circle.Module, Slb.Ocean.Petrel.Sandbox" />-->
<!--<add moduleType="Slb.VR.TDxReader.Module, Slb.VR.TDxReader" />-->
<add moduleType="Geovariances.IsatisLink.IsatisLinkModule, IsatisLink" />
</modules>
</add>
- The IsatisLink menu is present, but when I try to open a process, a window opens with only a
quick explanation of what it does instead of the full User Interface.
When this happens, a Message Box appears beforehand to tell you what happened. If so, please send us a
screenshot of the message + a copy of the “Help->About IsatisLink” information (available only in Petrel
2009.1 and higher).
- I received an unexpected exception and have being said that the exception log contains more
information, what should I do?
First try to reproduce the problem and send a message to Geovariances Support explaining what operation
you are trying to do (a screenshot of the Import/Export window may help). Attach to your email the Ocean
Log Files that can be found in the Petrel installation folder. For example, with Petrel 2009.1, the files to be
sent will be C:\Program Files\schlumberger\Petrel 2009.1\OceanPetrel.log and C:\Program
Files\schlumberger\Petrel 2009.1\OceanPetrelException.log.
18