Instance

class rips.Instance(port: int = 50051, launched: bool = False)

Bases: object

The ResInsight Instance class. Use to launch or find existing ResInsight instances

launched

Tells us whether the application was launched as a new process. If the application was launched we may need to close it when exiting the script.

Type:: bool

commands

Command executor. Set when creating an instance.

Type:: Commands

project

Current project in ResInsight. Set when creating an instance and updated when opening/closing projects.

Type:: Project

Methods Summary

`client_version_string`()	Get a full version string, i.e. 2019.04.01.
`exit`()	Tell ResInsight instance to quit
`find`([start_port, end_port])	Search for an existing Instance of ResInsight by testing ports.
`is_console`()	Returns true if the connected ResInsight instance is a console app
`is_gui`()	Returns true if the connected ResInsight instance is a GUI app
`launch`([resinsight_executable, console, ...])	Launch a new Instance of ResInsight.
`major_version`()	Get an integer with the major version number
`minor_version`()	Get an integer with the minor version number
`patch_version`()	Get an integer with the patch version number
`set_export_folder`(export_type, path[, ...])	Set the export folder used for all export functions
`set_main_window_size`(width, height)	Set the main window size in pixels
`set_plot_window_size`(width, height)	Set the plot window size in pixels
`set_start_dir`(path)	Set current start directory
`version_string`()	Get a full version string, i.e. 2019.04.01.

Methods Documentation

client_version_string() → str: Get a full version string, i.e. 2019.04.01

exit(): Tell ResInsight instance to quit

static find(start_port: int = 50051, end_port: int = 50071) → Instance | None

Search for an existing Instance of ResInsight by testing ports.

By default we search from port 50051 to 50071 or if the environment variable RESINSIGHT_GRPC_PORT is set we search RESINSIGHT_GRPC_PORT to RESINSIGHT_GRPC_PORT+20

Parameters:

start_port (int) -- start searching from this port
end_port (int) -- search up to but not including this port

is_console() → bool: Returns true if the connected ResInsight instance is a console app

is_gui() → bool: Returns true if the connected ResInsight instance is a GUI app

static launch(resinsight_executable: str = '', console: bool = False, launch_port: int = 0, init_timeout: int = 300, command_line_parameters: List[str] = []) → Instance | None

Launch a new Instance of ResInsight. This requires the environment variable RESINSIGHT_EXECUTABLE to be set or the parameter resinsight_executable to be provided. The RESINSIGHT_GRPC_PORT environment variable can be set to an alternative port number.

Parameters:

resinsight_executable (str) -- Path to a valid ResInsight executable. If set will take precedence over what is provided in the RESINSIGHT_EXECUTABLE environment variable.
console (bool) -- If True, launch as console application, without GUI.
launch_port (int) -- If 0, GRPC will find an available port. If -1, use the default port 50051 or RESINSIGHT_GRPC_PORT If anything else, ResInsight will try to launch with the specified portnumber.
init_timeout -- Number of seconds to wait for initialization before timing out.
command_line_parameters (list) -- Additional parameters as string entries in the list.

Returns:

an instance object if it worked. None if not.

Return type:

Instance

major_version() → int: Get an integer with the major version number

minor_version() → int: Get an integer with the minor version number

patch_version() → int: Get an integer with the patch version number

set_export_folder(export_type: str, path: str, create_folder: bool = False)

Set the export folder used for all export functions

Parameters:

Parameter        | Description                                  | Type
---------------- | -------------------------------------------- | -----
export_type      | String specifying what to export             | String
path             | Path to folder                               | String
create_folder    | Create folder if it doesn't exist?           | Boolean

Enum export_type:

Option          | Description
--------------- | ------------
"COMPLETIONS"   |
"SNAPSHOTS"     |
"PROPERTIES"    |
"STATISTICS"    |

set_main_window_size(width: int, height: int)

Set the main window size in pixels

Parameters:

Parameter | Description      | Type
--------- | ---------------- | -----
width     | Width in pixels  | Integer
height    | Height in pixels | Integer

set_plot_window_size(width: int, height: int)

Set the plot window size in pixels

Parameters:

Parameter | Description      | Type
--------- | ---------------- | -----
width     | Width in pixels  | Integer
height    | Height in pixels | Integer

set_start_dir(path: str)

Set current start directory

Parameters:: path (str) -- path to directory

version_string() → str: Get a full version string, i.e. 2019.04.01