Did not find what you were looking for?

Command File

The command file interface allows a sequence of specified commands to be run in order from the command line. The interface is used by supplying the command file as a command line parameter. Once the command file is finished executing, ResInsight will exit.

It is possible to use these commands directly from a Python script. For further details, please see the ResInsight Python API.

Command List

Case Control Commands

Export Commands

Other Commands

Syntax

The command file is comprised of a set of commands to be executed in order. Each command must begin on a separate line, i.e. there cannot be two commands on the same line.

The line starts with the command name, followed by parenthesis. Within the parenthesis, parameters can be supplied. Each parameter must be named, followed by an equals sign and its value.

As an example; openProject(path="/path/to/ResInsightProject.rsp") will execute the command openProject with the parameter path. path is a string, see Types for a list of all types a parameter can have.

Not all parameters are required, in which case they can be omitted and their value will be defaulted. The order of parameters does not matter.

Command file examples are displayed in sections like this.

Types

There are different types of parameters that can be supplied.

Type Input Example
Integer Number 5
Double Decimal number 3.14
String Sequence of characters contained in quotes ("")1 “/path/to/file”
Enum Choice of a set of given options ALL
Boolean true or false true
List Multiple choices of another type, written within square brackets ([]) separated by a comma (,) [1, 2, 3]

1 The backslash (\) character is used as an escape character within strings, so to use a quote within a string, use "escape \" with \"". To input a literal backslash character, use "\\".

Case Control Commands

openProject

Opens a ResInsight project file.

Parameter Description Type Required
path File path to the project file String ✔ 
openProject(path="/home/user/ResInsightProject.rsp")

closeProject

Closes the current open project.

closeProject()

setStartDir

Set startup directory.

Parameter Description Type Required
path Path to directory to use as startup directory String ✔ 
setStartDir(path="/home/user")

loadCase

Import Eclipse case from file.

Parameter Description Type Required
path File path to the case to load String ✔ 
loadCase(path="/home/user/reservoir.EGRID")

createGridCaseGroup

Create a Grid Case Group from a list of files.

Parameter Description Type Required
casePaths List of Paths to Case Files String ✔

createStatisticsCase

Create a Statistics Case in a Grid Case Group.

Parameter Description Type Required
caseGroupId ID to the Case Group Integer ✔ 
createGridCaseGroup(path=["/home/user/reservoir.EGRID", "/home/user/other_reservoir.EGRID"])
createStatisticsCase(caseGroupId=0)

replaceCase

Replaces a case in the current project with the specified new case.

openProject must be called before this command to set which project file is to be used when replacing cases. This command re-opens the project with the new case replaced. To replace more than one case at the same time, use replaceSourceCases.

Parameter Description Type Required
newGridFile File path to the new grid file to replace with String ✔
caseId ID of the case to replace. Defaults to first case Integer 
replaceCase(newGridFile="/home/user/otherReservoir.EGRID", caseId=4)

replaceSourceCases

Replaces multiple source cases in the current project.

openProject must be called before this command to set which project file is to be used when replacing cases. This command re-opens tje project with the cases replaced.

Parameter Description Type Required
gridListFile File path to file containing list of cases to replace with String ✔
caseGroupId ID of group to replace cases in. Defaults to first group Integer 
replaceSourceCases(gridListFile="C:/resinsight/replacement_files.txt")

Export Commands

exportMultiCaseSnapshots

Replaces the first case in the current project with each case in the given file and saves snapshots of all views.

openProject must be called before this command to set which project file is to be used when replacing cases.

Folder to output snapshots should be set using setExportFolder with SNAPSHOTS type.

Parameter Description Type Required
gridListFile File path to file containing list of cases to create snapshots of String ✔ 
exportMultiCaseSnapshots(gridListFile="C:\\resinsight\\replacement_files.txt")

exportSnapshots

Export snapshots of specified type.

Folder to output snapshots should be set using setExportFolder with SNAPSHOTS type.

Parameter Description Type Required
type Type of snapshots to export. Choices: ALL, VIEWS, PLOTS. Defaults to ALL Enum
prefix Exported file name prefix. Defaults to no prefix String
caseId ID of case for export, defaults to -1 meaning all cases Integer 
exportSnapshots(type=PLOTS)

exportProperty

Exports property values for all cells in the grid to file in Eclipse format.

Parameter Description Type Required
caseId ID of case for export Integer ✔
timeStep The time step index for export Integer ✔
property Name of property to export String ✔
eclipseKeyword Eclipse keyword used as text in export header. Defaults to the value of property parameter String
undefinedValue Value to use for undefined values. Defaults to 0.0 Double
exportFile Filename for export. Defaults to the value of property parameter String 
exportProperty(caseId=1, timeStep=4, property="SOIL")

exportPropertyInViews

Exports property values for all cells in the grid to file in Eclipse format. Use specified cell result in view to define the export property. One file per view will be exported.

Parameter Description Type Required
caseId ID of case to export property from Integer ✔
viewNames Name of views to export from. If not specified, all views are exported List of String
undefinedValue Value to use for undefined values. Defaults to 0.0 Double 
exportPropertyInViews(caseId=1)

exportPropertyInViews(caseId=1, viewNames=["view A", "view 4"])

exportWellPathCompletions

Export well path completions.

Parameter Description Type Required
caseId ID of case to export well paths for Integer ✔
timeStep The time step to export completions for Integer ✔
wellPathNames Names of well paths to export for. Defaults to all checked wells. If a list of well names are provided, those wells are included even if unchecked List of String
fileSplit How the files are split. Choices: UNIFIED_FILE, SPLIT_ON_WELL, SPLIT_ON_WELL_AND_COMPLETION_TYPE. Defaults to SPLIT_ON_WELL_AND_COMPLETION_TYPE Enum
compdatExport Chose whether transmissibilities are exported. Choices: TRANSMISSIBILITIES, WPIMULT_AND_DEFAULT_CONNECTION_FACTORS. Defaults to TRANSMISSIBILITIES Enum
includePerforations Whether main bore perforations should be included. Defaults to true Boolean
includeFishbones Whether fishbones should be included. Defaults to true Boolean
excludeMainBoreForFishbones Whether main bore completions should be excluded for cells with fishbones. Defaults to false Boolean
combinationMode Combination mode. Choices: INDIVIDUALLY, COMBINED. Defaults to INDIVIDUALLY Enum 
exportWellPathCompletions(caseId=3, timeStep=5, includeFishbones=false)

exportSimWellFractureCompletions

Export fracture completions for simulation wells.

Parameter Description Type Required
caseId ID of case to export simulation well fracture completions for Integer ✔
viewName The name of the view to export simulation well fracture completions for. Since view names are not unique, all views sharing the given name will be used String ✔
timeStep The time step to export completions for Integer ✔
simulationWellNames Names of simulation wells to export for. Defaults to all checked wells. If a list of names are provided, those wells are included even if unchecked List of String
fileSplit How the files are split. Choices: UNIFIED_FILE, SPLIT_ON_WELL, SPLIT_ON_WELL_AND_COMPLETION_TYPE. Defaults to UNIFIED_FILE Enum
compdatExport Chose whether transmissibilities are exported. Choices: TRANSMISSIBILITIES, WPIMULT_AND_DEFAULT_CONNECTION_FACTORS. Defaults to TRANSMISSIBILITIES Enum 
exportSimWellFractureCompletions(caseId=3, viewName="View 2", timeStep=5)

exportMsw

Export multi-segment wells.

Parameter Description Type Required
caseId ID of case to export well paths for Integer ✔
wellPath Name of well path to export well segments for String ✔ 
exportMsw(caseId=1, wellPath="MainWell")

exportWellPaths

Export well paths.

Parameter Description Type Required
wellPathNames Names of well paths to export for. Defaults to all checked wells. If a list of well names are provided, those wells are included even if unchecked List of String
mdStepSize Spacing (measured depth) between each sample along the well path. Default to 5.0 Double 
exportWellPaths(wellPathNames=["B-1H", "B-2H"], mdStepSize=1.5)

exportVisibleCells

Export visible cells

Parameter Description Type Required
caseId ID of case to export cells for Integer ✔
viewName Name of the view associated with the specified case Double ✔
exportKeyword The keyword to export. Choices: FLUXNUM or MULTNUM. Default: FLUXNUM Enum
visibleActiveCellsValue Value to use for visible active cells. Default: 1 Integer
hiddenActiveCellsValue Value to use for hidden active cells. Default: 0 Integer
inactiveCellsValue Value to use for inactive cells. Default: 0 Integer 
exporVisibleCells(caseId=0, viewName="View 1", exportKeyword=MULTNUM)

exportFlowCharacteristics

Export Flow Characteristics data to text file in CSV format

Parameter Description Type Required
caseId ID of case Integer ✔
timeSteps Time step indices List of Integer ✔
injectors Injector names List of Strings
producers Producer names List of Strings
fileName Export file name Integer
minimumCommunication Minimum Communication, defaults to 0.0 Integer
aquiferCellThreshold Aquifer Cell Threshold, defaults to 0.1 Integer 
exportFlowCharacteristics(caseId=0, timeSteps=[1, 5, 6], injectors=["INJA", "INJB"], producers=["PROD_F"], fileName="myData.csv")

setExportFolder

Set the folder to export different types of data to. Set this before attempting to export data to ensure it is exported to desired location.

Parameter Description Type Required
type Type of export folder to set. Choices: COMPLETIONS, SNAPSHOTS, PROPERTIES, STATISTICS Enum ✔
path Directory to export the given type to String ✔
createFolder If true, create the folder when required. Default false. Boolean 
setExportFolder(type=SNAPSHOTS, path="/home/user/snapshots")

Other

runOctaveScript

Execute an Octave script.

Parameter Description Type Required
path Path to the octave script to execute Integer ✔
caseIds The cases to run the octave script on. Defaults to running the script without a specified case List of Integer 
runOctaveScript(path="/home/user/octave/something.m", caseIds=[1,2,6])

setMainWindowSize

Resize the main window to the specified size.

Parameter Description Type Required
width The width to set for the main window Integer ✔
height The height to set for the main window Integer ✔ 
setMainWindowSize(width=1920, height=1200)

computeCaseGroupStatistics

Compute statistics for statistics cases.

Parameter Description Type Required
caseIds IDs of statistics cases to compute. Default is all statistics cases List of Integer 
computeCaseGroupStatistics(caseIds=[5])

computeCaseGroupStatistics(caseIds=[2,4,8])

setTimeStep

Set the time step for a given case. The time step is used for all views on the case.

Parameter Description Type Required
caseId ID of case to set time step for Integer ✔
timeStep Index of time step to switch to Integer ✔ 
setTimeStep(caseId=1, timeStep=8)

scaleFractureTemplate

Scale fracture template parameters.

Parameter Description Type Required
id ID of fracture template Integer ✔
halfLength Half Length scale factor Double
height Height scale factor Double
dFactor D-factor scale factor Double
conductivity Conductivity scale factor Double 
scaleFractureTemplate(id=1, width=2, height=1.5)

setFractureContainment

Set fracture template containment parameters.

Parameter Description Type Required
id ID of fracture template Integer ✔
topLayer Top layer containment Integer ✔
baseLayer Base layer containment Integer ✔ 
setFractureContainment(id=1, topLayer=2, baseLayer=7)

createMultipleFractures

Create multiple fractures on one or more well paths.

Parameter Description Type Required
caseId Case ID Integer ✔
templateId Fracture template id Integer ✔
wellPathNames Well path names. Default: All well paths List of Strings
minDistFromWellTd Min distance from well path tip. Default: 100.0 m Double
maxFracturesPerWell Max fractures per well. Default: 100 Integer
topLayer Top K layer. Default: Top layer from current model Integer
baseLayer Base K layer. Default: Bottom layer from current model Integer
spacing Distance between fractures. Default: 300.0 m Double
action How to handle existing fractures. Choices: APPEND_FRACTURES, REPLACE_FRACTURES. The replace option will delete all existing fractures before adding new ones. Default: APPEND_FRACTURES Enum 
createMultipleFractures(caseId=0, templateId=1, wellPathNames=["B-1H", "B-2H"], action=REPLACE_FRACTURES)

createLgrForCompletions

Create temporary LGRs for completions on the selected well paths. The splitType parameter controls which main grid cells to split into LGRs. The LGR_PER_CELL option splits only those main grid cells that intersect with a completion. The LGR_PER_COMPLETION option splits all main grid cells that are located within an IJK bounding box covering all intersected cells for each completion. The LGR_PER_WELL works like the previous option, but the bounding box covers intersected cells for all completions on a well path.

Parameter Description Type Required
caseId ID of case to create LGRs for Integer ✔
timeStep The time step to create LGRs for Integer ✔
wellPathNames Names of well paths to export for. Defaults to all checked wells. If a list of well names are provided, those wells are included even if unchecked List of String
refinementI Size of the LGR along the I axis, in each main grid cell. Integer ✔
refinementJ Size of the LGR along the J axis, in each main grid cell. Integer ✔
refinementK Size of the LGR along the K axis, in each main grid cell. Integer ✔
splitType How to split the LGRs. Options: LGR_PER_CELL, LGR_PER_COMPLETION, LGR_PER_WELL. Default option is LGR_PER_COMPLETION Enum 
createLgrForCompletions(caseId=0, timeStep=0, wellPathNames=["B-1H", "B-2H"], refinementI=2, refinementJ=3, refinementK=4, splitType=LGR_PER_WELL)

createSaturationPressurePlots

Create saturation pressure plots for the specified cases.

Parameter Description Type Required
caseIds IDs of cases to create plots for. Default is all cases List of Integer 
createSaturationPressurePlots(caseIds=[0])