OilfieldToolsNet/ResInsight
4
0
Fork 0
mirror of https://github.com/OPM/ResInsight.git synced 2025-02-25 18:55:39 -06:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: Adjustments for PDF

Browse Source
This commit is contained in:
Magne Sjaastad
2013-10-21 14:04:13 +02:00
parent b83a777953
commit d9596e6a53
1 changed files with 71 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

124
Documentation/UsersGuide/OctaveInterfaceReference.md
View File

@@ -15,10 +15,10 @@ The case type (Labeled "CaseType" in the following specification) of a case is r
Case Type | Description
---------------|-----------
ResultCase | The case is visualizing results from a reservoir simulation and is not a member of a Grid Case Group.
InputCase | A case is visualizing ASCII Eclipse input data, and is not a member of a Grid Case Group.
StatisticsCase | The cases in a Grid Case Group visualizing the results of the statistical calculation performed on the source cases of the Grid Case Group.
SourceCase | The case is referring to results from a reservoir simulation, and is one of the source cases in a Grid Case Group.
ResultCase | A binary Eclipse case
InputCase | A case based on ASCII Eclipse input data
StatisticsCase | A statistics case based on many source cases in Grid Case Group
SourceCase | A binary Eclipse case in a Grid Case Group
### Unresolved issues
The issue around having multiple instances of ResInsight is still not addressed, but might affect the function signatures by adding a port number parameter to all of them. We will try to find ways to avoid this, but are still not certain that we will succeed.
@@ -28,12 +28,15 @@ The issue around having multiple instances of ResInsight is still not addressed,
The case information is presented in an octave Structure called CaseInfo, and contains the following fields:
CaseInfo = {
CaseId = int # A project-unique integer used to address this particular case
CaseName = string # The name that has been assigned to the case in ResInsight.
CaseType = string # See the description above
CaseGroupId = int # A project-unique integer identifying the CaseGroup this case is a
# member of. -1 if not in a CaseGroup. Valid only for Statistics-, and
# SourceCases
CaseId = int # A project-unique integer used to address this
# particular case
CaseName = string # The name that has been assigned to the case
# in ResInsight.
CaseType = string # See the description above
CaseGroupId = int # A project-unique integer identifying the
# CaseGroup this case is a member of.
# -1 if not in a CaseGroup. Valid only for
# Statistics-, and SourceCases
}
#### CaseInfo riGetCurrentCase()
@@ -46,8 +49,10 @@ This function returns a CaseInfo Structure for each of the cases selected in Res
This function returns a CaseGroupInfo Structure for each of the case groups in the current ResInsight project.
CaseGroupInfo = {
CaseGroupId = int # A project-unique integer used to address this particular CaseGroup
CaseGroupName = string # The name assigned to the CaseGroup in ResInsight
CaseGroupId = int # A project-unique integer used to address
# this particular CaseGroup
CaseGroupName = string # The name assigned to the CaseGroup
# in ResInsight
}
#### Vector[CaseInfo] riGetCases([CaseGroupId])
@@ -60,90 +65,100 @@ If a CaseGroupId is provided, only the cases in that Case Group will be returned
This function returns a two dimensional matrix containing grid and IJK information about each of the active cells in the requested case. The columns contain the following information:
[GridIdx, I, J, K, ParentGridIdx, PI, PJ, PK, CoarseBoxIdx]
GridIdx: The index of the grid the cell resides in. (Main grid has index 0)
I, J, K: 1-based index address of the cell in the grid.
ParentGridIdx: The index to the grid that this cell's grid is residing in.
PI, PJ, PK: 1-based address of the parent grid cell that this cell is a part of.
CoarseBoxIdx: 1-based coarsening box index, -1 if none. Coarsening box info can be retrieved using **riGetCoarseningInfo()**
If the CaseId is not defined, ResInsight<68>s Current Case is used.
GridIdx # The index of the grid the cell resides in.
# Main grid has index 0
I, J, K # 1-based index address of the cell in the grid.
ParentGridIdx # The index to the grid that this cell's grid
# is residing in.
PI, PJ, PK # 1-based address of the parent grid cell that
# this cell is a part of.
CoarseBoxIdx # 1-based coarsening box index, -1 if none.
# Coarsening box info can be retrieved using
# **riGetCoarseningInfo()**
If the CaseId is not defined, ResInsight's Current Case is used.
#### Matrix[numCoarseGroups][6] riGetCoarseningInfo([CaseId])
This function returns all coarse box definitions used in the grid.
The columns contain the following information:
[I1, I2, J1, J2, K1, K2]: 1-based index addresses of the min and max corners of the coarsening box.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Matrix[numGrids][3] riGetGridDimensions([CaseId])
This function returns a two dimensional matrix: One row for each grid, starting with the main grid.
>NOTE: This means that the "normal" GridIndices where 0 means Main Grid does not work directly with this matrix. You have to add 1.
The columns contain the following information:
[NI, NJ, NK]: I, J, K dimensions of the grid.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Vector[TimeStepDate] riGetTimeStepDates([CaseId])
This function returns the date information for each of the time steps in the case as a Vector of Structures.
The Structure is defined as:
TimeStepDate = {
Year = int # The year eg. 2013
Month = int # The month. Eg. 12
Day = int # The day in the month. Eg. 24
Hour = int # The hour of the day. Eg. 17
Minute = int # The minute in the hour. Eg. 55
Second = int # The second within the minute. Eg. 30
Year = int # The year eg. 2013
Month = int # The month. Eg. 12
Day = int # The day in the month. Eg. 24
Hour = int # The hour of the day. Eg. 17
Minute = int # The minute in the hour. Eg. 55
Second = int # The second within the minute. Eg. 30
}
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Vector[DecimalDay] riGetTimeStepDays([CaseId])
This function returns the time from the simulation start as decimal days for all the time steps as a Vector of doubles.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
## Retrieving Property Data
### Retrieving Property Data
#### Vector[PropertyInfo] riGetPropertyNames([CaseId] ], [PorosityModel = "Matrix"|"Fracture"])
This function returns the name and type of all the properties in the case as a Vector of Structures.
The Structure is defined as:
PropertyInfo {
PropName = string # Name of the property as received from the analysis tool
PropType = string # The type of the property: "StaticNative", "DynamicNative", "Input", "Generated"
PropName = string # Name of the property as received from
# the analysis tool
PropType = string # The type of the property: "StaticNative",
# "DynamicNative", "Input", "Generated"
}
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Matrix[numActiveCells][numTimestepsRequested] riGetActiveCellProperty([CaseId], PropertyName, [RequestedTimeSteps], [PorosityModel = "Matrix"|"Fracture"])
This function returns a two dimensional matrix: [ActiveCells][Num TimestepsRequested] containing the requested property data from the case with CaseId.
If the case contains coarse-cells, the results are expanded onto the active cells.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
The RequestedTimeSteps must contain a list of indices to the requested timesteps. If not defined, all the timesteps are returned.
#### Matrix[numI][numJ][numK][numTimestepsRequested] riGetGridProperty([CaseId], GridIndex , PropertyName, [RequestedTimeSteps], [PorosityModel = "Matrix"|"Fracture"])
This function returns a matrix of the requested property data for all the grid cells in the requested grid for each requested timestep.
Grids are indexed from 0 (main grid) to max number of LGR's
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
The RequestedTimeSteps must contain a list of indices to the requested time steps. If not defined, all the timesteps are returned.
Writing Back to ResInsight
#### riSetActiveCellProperty( Matrix[numActiveCells][numTimeSteps], [CaseId], PropertyName, [TimeStepIndices], [PorosityModel = "Matrix"|"Fracture"])
Interprets the supplied matrix as a property set defined for the active cells in the case, and puts the data into ResInsight as a "Generated" property with the name "PropertyName".
The "TimeStepIndices" argument is used to "label" all the time steps present in the supplied data matrix, and must thus be complete. The time step data will then be put into ResInsight at the time steps requested.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### riSetGridProperty( Matrix[numI][numJ][numK][numTimeSteps], [CaseId], GridIndex, PropertyName, [TimeStepIndices], [PorosityModel = "Matrix"|"Fracture"])
Interprets the supplied matrix as a property set defined for all cells in one of the grids in a case, and puts the data into ResInsight as a "Generated" property with the name "PropertyName".
The "TimeStepIndices" argument is used to "label" all the time steps present in the supplied data matrix, and must thus be complete. The time step data will then be put into ResInsight at the time steps requested.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
## Cell Geometry Functions
### Cell Geometry Functions
#### Matrix[numI][numJ][numK][3] riGetCellCenters([CaseId], GridIndex)
This function returns the UTM coordinates (X, Y, Z) of the center point of all the cells in the grid.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Matrix[ActiveCells][3] riGetActiveCellCenters([CaseId], [PorosityModel = "Matrix"|"Fracture"])
This function returns the UTM coordinates (X, Y, Z) of the center point of each of the active cells.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
Cell Corner Index layout
The corner indices follow the ECLIPSE standard:
@@ -161,41 +176,44 @@ The corner indices follow the ECLIPSE standard:
#### Matrix[numI][numJ][numK][8][3] riGetCellCorners([CaseId], GridIndex)
This function returns the UTM coordinates(X, Y, Z) of the 8 corners of all the cells in the grid.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Matrix[ActiveCells][8][3] riGetActiveCellCorners([CaseId], [PorosityModel = "Matrix"|"Fracture"])
This function returns the UTM coordinates (X, Y, Z) of the 8 corners of each of the active cells.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
## Well Data Functions
### Well Data Functions
#### Vector[WellNames] riGetWellNames([CaseId])
This function returns the names of all the wells in the case as a Vector of strings.
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
Vector[WellCellInfo] riGetWellCells([CaseId], WellName, TimeStep)
This function returns the cells defined in the specified well for the time step requested as a vector of Structures. The Structure is defined as:
WellCellInfo {
I, J, K = int # Index to the cell in the grid
GridIndex = int # the index of the grid. Main grid has index 0.
CellStatus = int # is either 0 or 1, meaning the cell is closed or open respectively
BranchId = int # Branch id of the branch intersecting the cell
SegmentId = int # Branch segment id of the branch intersecting the cell
I, J, K = int # Index to the cell in the grid
GridIndex = int # the index of the grid. Main grid has index 0.
CellStatus = int # is either 0 or 1, meaning the cell is closed
# or open respectively
BranchId = int # Branch id of the branch intersecting the cell
SegmentId = int # Branch segment id of the branch intersecting the cell
}
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
#### Vector[WellStatus] riGetWellStatus ([CaseId], WellName, [RequestedTimeSteps])
This function returns the status information for a specified well for each requested time step as a vector of Structures. The Structure is defined as:
WellStatus {
WellType = string # "Producer", "OilInjector", "WaterInjector", "GasInjector", "NotDefined"
WellStatus = int # is either 0 or 1, meaning the well is shut or open respectively
WellType = string # "Producer", "OilInjector",
# "WaterInjector", "GasInjector", "NotDefined"
WellStatus = int # is either 0 or 1, meaning the well is shut
# or open respectively
}
If the CaseId is not defined, ResInsight<EFBFBD>s Current Case is used.
If the CaseId is not defined, ResInsight's Current Case is used.
## Obsolete Functions
### Obsolete Functions
#### Vector(3)[ICount, JCount, KCount] riGetMainGridDimensions([CaseName/CaseIndex])
Returns a vector of size 3: [ICount, JCount, KCount]