ResInsight/Documentation/UsersGuide/GettingStarted.md

Getting started with ResInsight

Installation

Installation instructions for ResInsight can be found here: Installation and Configuration

User interface overview

The application has a main area and several docking windows. The different docking windows can be managed from the Windows menu or directly using the local menu bar of the docking window.

![ResInsight User Interface] (images/ResInsightUIFullSizeWindows.png)

Docking Windows

• Project Tree - contains all application objects in a tree structure.
• Property Editor - displays all properties for the selected object in the Project Tree
• Process Monitor - displays output from Octave when executing Octave scripts
• Result Info - displays info for the object being hit in the 3D scene when clicking with left mouse button

TIP: A new project tree and property editor can be added from Windows->New Project and Property View.

Toolbars

A selected subset of actions are presented as controls in the toolbar. The different sections in the toolbar can be dragged and positioned anywhere as small floating toolbars. Management of the toolbar is done by right-clicking on the toolbar and then manipulating the displayed menu.

3D Views

In the main area of the application, several 3D views can be open at the same time. One of them will be active and the active view can be either maximized to use the whole main area, or normalized so that you can see all the open 3D views.

TIP: To see views next to each other select the Restore down icon in the application show here for Windows :

Editing the views

Most of the settings and features of ResInsight is accesible through the Project Tree and the Property Editor. Selecting an item in the Project Tree activates the corresponding 3D View, and shows the Items properties in the Property Editor, available for editing.

Toggling a checkbox next to an item in the Project Tree will toggle visibility in the 3D view. Toggling a checkbox for a collection of items will toggle visibility for all items in the collection.

Context menu commands are also available, to do special operations on a selected set of items.

Cases and their types

A Case in ResInsight means a Grid model with a particular set of results or property data. There are
three different Case types:

Result case

This is a Case based on the results of an Eclipse analysis, read from a grid file together with restart data.

Input case

This Case type is based on a *.GRDECL file, or a part of an Eclipse Input file. This Case type supports loading single ascii files defining Eclipse Cell Properies, and also to export miodified property sets to ascii files. Each of the Eclipse properties is listed as separate entities in the Project Tree, and can be renamed and exported.

Statistics case

This is a Case type that belongs to a Grid Case Group and makes statistical calculations based on the source cases in the Grid Case Group.

Grid Case Group

A Grid Case Group is a group of Result Cases whith identical grids, but generally different active cells, initial values and results. These cases are called Source Cases.

The purpose of a Grid Case group is to make it easy to calculate statistics across the source cases. If you have done several Eclipse simulations with different input parameters, you can put all the results into a Grid Case Group and easily calculate the cells mean value, range and max/min values at each timestep.

A Grid Case Group can be created from a selection of binary files, or manually by assigning cases using the user interface of ResInsight.

See also [ Multiple realizations and statistics ] (CaseGroupsAndStatistics.md).

Importing data

Input data support

ResInsight supports the follwing type of Eclipse input data:

• *.GRID and *.EGRID files along with their *.INIT and restart files *.XNNN and *.UNRST.
• Grid and Property data from *.GRDECL files.

Importing Eclipse cases

Eclipse Results

1. Select File->Import->Import Eclipse Case and select an *.EGRID or *.GRID Eclipse file for import.
2. The case is imported, and a view of the case is created

TIP: You can select several grid files in one go.

Eclipse ascii input data

1. Select File->Import->Import Input Eclipse Case and select a *.GRDECL file.
2. The case is imported, and a view of the case is created
3. Right click the Input Properties in the generated Input Case and use the context menu to import additional Eclipse Property data files.

Model navigation

ResInsight comes with two 3D navigation modes. The active mode can be selected in the Preferences dialog (Edit->Preferences).

Abbreviation	Meaning
LMB	Pressing left mouse button
MMB	Pressing Middle mouse button or scroll wheel button
RMB	Pressing Right mouse button

Ceetron navigation mode

Mouse interaction	Action
LMB	Pan model
MMB	Zoom to mouse pointer location
Scroll wheel	Zoom to mouse pointer location
RMB	Rotate model
RMB single click	Context menu
LMB single click	Update status bar and Result Info

CAD navigation mode

Mouse interaction	Action
MMB	Rotate model
MMB + Shift	Pan model
Scroll wheel	Zoom to mouse pointer location
RMB single click	Context menu
LMB single click	Update status bar and Result Info

Project files and related data *.rsp

ResInsight stores which cases you have imported and all the settings for each view etc. in a project file with the extension .rsp. This file only contains references to the real data files, and even references to datafiles generated by ResInsight itself. Statistics calculations, property sets you generate by using Octave and well paths are saved to a folder in the same directory as you save the project file, and is named _cache. So if you need to move your project, make sure you move this folder as well.

TIP: The rsp-file is an XML file, and can be edited by any text editor.

Export

Snapshot images

Image export of current 3D view can be launched from File->Export->Snapshot To File. If a project contains multiple views, all views can be exported using File->Export->Snapshot All Views To File. A snapshot can also be copied to clipboard using Edit->Copy Snapshot To Clipboard. All three commands are also available on the toolbar.

Export of Eclipse Ascii data

Result data can be exported to Eclipse Ascii file by activating the context menu for a Cell Result.

-- Exported from ResInsight
<keyword>
<data for all cells>
/