ERT TUI User Manual

From Ert

Jump to: navigation, search

This user manual describes the different options available in the ERT TUI (Text User Interface). For a guide to setting up a project and getting started see the tutorial.

When you have successfully started the ERT application you will see the following page

    _________________________________
   /                                 \
   |   ______   ______   _______     |
   |  |  ____| |  __  \ |__   __|    |
   |  | |__    | |__) |    | |       |
   |  |  __|   |  _  /     | |       |
   |  | |____  | | \ \     | |       |
   |  |______| |_|  \_\    |_|       |
   |                                 |
   |  Ensemble based Reservoir Tool  |
   \_________________________________/



svn version : 3466
compile time: Thu Jun  9 14:57:32 MDT 2011
site config : /project/res/etc/ERT/site-config

Activity will be logged to ..............: enkf_config.log
Debug information of summary observations written to:obs_debug.txt
Have loaded observations from: observations

/------------------------------------\
|             Main menu              |
|------------------------------------|
| c: Manage cases                    |
| r: Run or restart experiment       |
| p: Plot results                    |
| a: Rank results                    |
| e: Export data to other formats    |
| t: Table of results                |
| m: Miscellanous                    |
| ---------------------------------- |
| q: Quit                            |
\------------------------------------/

==>  

Svn version and compile time tells you which version you are using and when it was compiled. Then the log file and debug file names are listed and the observation file is stated.

Contents

Main menu

The main menu is text operated and if you enter one of the letters listed you will get to the different sub-menus.

Manage cases

/----------------------------------------------------------\
|           Manage cases - current: enkfcase               |
|----------------------------------------------------------|
| l: List available cases                                  |
| c: Create and select new case                            |
| s: Select case                                           |
| -------------------------------------------------------- |
| i: Initialize case from scratch                          |
| a: Initialize case from existing case                    |
| p: Initialize case FOR PREDICTIONS from existing case    |
| -------------------------------------------------------- |
| e: Copy full ensemble to another case                    |
| o: Copy ensemble of parameters to another case           |
| -------------------------------------------------------- |
| b: Back                                                  |
\----------------------------------------------------------/

This menu is used to initiate, create and switch between cases.

l: List available cases

Will show a list of the available cases.

c: Create and select new case

Will ask for
Name of new case ==================================>
and a new case will be created with the name you enter.

s: Select case

Will ask for
Name of case ============================>
Enter the name of the case you want to use. The case has to exist or ERT will show the message
** Can not find case: "case"
A blank entry will return to the manage cases menu.

i: Initialize case from scratch

Will give you the option to initialize members and parameters from scratch with the following configurations.

/---------------------------------------------\
|           Initialize from scratch           |
|---------------------------------------------|
| 1: Initialize all members/all parameters    |
| 2: Initialize all members/one  parameter    |
| 3: Initialize one member/all parameters     |
| 4: Initialize one member/one parameter      |
| ------------------------------------------- |
| b: Back                                     |
\---------------------------------------------/

For the choices with one member you have to enter the member you want to initialize.

Initialize ensemble member [0:99] ===> 

For the choices with one parameter you will be asked to enter the keyword for the parameter.

Keyword ============================>

a: Initialize case from existing case

Will ask for the name of the case from which you want to initialize, the report step you want to initialize from and if you want to initialize from the forecast or the analayzed ensemble.

Initialize from case ==============================> anothercase
Source report step [0:62] =========================> 12
Source analyzed/forecast [A|F] ====================> a

A blank entry on the first query will return to the Manage cases menu.

p: Initialize case FOR PREDICTIONS from existing case

This option is only available if you have set up a schedule file for predictions. Ert will ask for

Source case ========================>

e: Copy full ensemble to another case

Use this option to copy a full ensemble to another case. The source case is the current case. Ert will ask for the following:

Source report step [0:62] ==========> 10
Source analyzed/forecast [A|F] =====> a
Target case ========================> targetcasename
Target report step [0:62] ==========> 0
Target analyzed/forecast [A|F] =====> f

If the target case does not exist ERT will create the case.

Creating new case: targetcasename

Caution: ERT will crash if the source report step does not exist.

o: Copy ensemble of parameters to another case

Use this option to copy the ensemble of parameters to another case. The source case is the current case. Ert will ask for the following:

Source report step [0:62] ==========> 1
Source analyzed/forecast [A|F] =====> f
Target case ========================> targetcase
Target report step [0:62] ==========> 1
Target analyzed/forecast [A|F] =====> a

If the target case does not exist ERT will create the case.

Creating new case: targetcase

Caution: ERT will crash if the source report step does not exist.

b: Back

This option will return to the main menu.

Run or restart experiment

/----------------------------------------------------\
|            Run menu [case:enkfcase]                |
|----------------------------------------------------|
| x: Ensemble run: history                           |
| p: Ensemble run: predictions                       |
| f: Ensemble run: history + predictions             |
| -------------------------------------------------- |
| s: Start EnKF run from beginning                   |
| r: Restart EnKF run from arbitrary state           |
| -------------------------------------------------- |
| c: Create runpath directories - NO simulation      |
| l: Load results manually                           |
| -------------------------------------------------- |
| a: Analyze one step manually                       |
| i: Analyze interval manually                       |
| n: Analyze selected steps manually                 |
| -------------------------------------------------- |
| d: Set new value for RUNPATH:Simulations/Real%d    |
| -------------------------------------------------- |
| b: Back                                            |
\----------------------------------------------------/

This menu is the main menu for running simulations with ERT.

x: Ensemble run: history

This option will run the ensemble members through the historic period without conditioning to data. Ert will ask for the following:

Which realizations to simulate <default:all> :  =============>

Enter will run all ensemble members. Valid entries can be separated by comma.

Which realizations to simulate <default:all> :  =============> 1,3,5

p: Ensemble run: predictions

This option will run the ensemble members through the prediction period. ERT will ask for the following:

Which realizations to simulate <default:all> :  =============>

Enter will run all ensemble members. Valid entries can be separated by comma.

Which realizations to simulate <default:all> :  =============> 1,3,5

This option is only available if you have set up a schedule file for predictions.

f: Ensemble run: history + predictions

This option will run the ensemble members through the historic and the prediction period without conditioning to data. ERT will ask for the following:

Which realizations to simulate <default:all> :  =============>

Enter will run all ensemble members. Valid entries can be separated by comma.

Which realizations to simulate <default:all> :  =============> 1,3,5

This option is only available if you have set up a schedule file for predictions.

s: Start EnKF run from beginning

This option will start an EnKF run through the historic period.

r: Restart EnKF run from arbitrary state

This option starts the EnKF run from an arbitrary report step. ERT will ask for report step and if you want to use the forecast at that step or the analayzed ensemble (conditioned on data at that step).

Report step [0:62] ==========================================> 61
Analyzed/forecast ===========================================> a

Note that there has to be an exixting ensemble at the report step.

c: Create runpath directories - NO simulation

This option creates runpaths for ensemble members. ERT asks for

Which realizations to create[ensemble size:10] :  ===========>

Will accept comma separated entries.

l: Load results manually

ERT asks for which results to load

Which realizations to load [ensemble size:10] :  ============>

Will accept comma separated entries.

a: Analyze one step manually

To analyze one step manually ERT asks for

Which report step to analyze [0:62] =========================>

i: Analyze interval manually

Use this option to analyze an interval manually. ERT asks for

First report step [0:62] ====================================> 0
Last report step [0:62] =====================================> 10
Stride [default:1] ==========================================>

If the stride is more than 1 observations will be grouped together.

n: Analyze selected steps manually

To use this option a file with the selected steps is required. ERT asks for the file name.

File with selected report steps =============================> 

d: Set new value for RUNPATH:Simulations/Real%d

Use this option to set a new value for the runpath. Remember the integer format specifier '%d' so ERT can make different paths for each ensemble member. Example:

Give runpath format ==> Simulation/OtherReal%d

b: Back

This option will take you back to the Main menu.

Plot results

/--------------------------------------------------\
|         Plot results [case:enkfcase]             |
|--------------------------------------------------|
| e: Ensemble plot                                 |
| a: Ensemble plot of ALL summary variables        |
| g: Ensemble plot of GEN_KW parameter             |
| G: Ensemble plot of ALL ALL GEN_KW parameters    |
| o: Observation plot                              |
| t: Plot RFT and simulated pressure vs. TVD       |
| m: Plot RFT and simulated pressure vs. MD        |
| s: Sensitivity plot                              |
| h: Histogram                                     |
| ------------------------------------------------ |
| l: Use logarithmic Y-axis                        |
| ------------------------------------------------ |
| b: Back                                          |
\--------------------------------------------------/

This menu is used for plotting results.

e: Ensemble plot

This option lets you plot the ensemble of dynamic data over time with observations (if present). ERT asks for a combination of KEY and INDEX. This has to correspond to values specified in the observation file. You also have to specify which report steps and which realizations to plot. See example.

What do you want to plot (KEY:INDEX) ========================> WWCT:OP_1
Report steps (0 - 62) =======================================> 0 - 4
Realizations members to plot(0 - 9) =========================> 0 - 9

a: Ensemble plot of ALL summary variables

This option will plot all summary variables. ERT will ask for start and stop report step an which realizations to plot. ENTER on all choices will plot everything.

Starting plotting at report step [default: 0] ===============>
Stop plotting at report step [default: everything] ==========>
Realizations members to plot(0 - 9) [default: all] ==========>

g: Ensemble plot of GEN_KW parameter

Use this option to plot GEN_KW parameters if you have specified these in the observation file. See example

Which GEN_KW parameter do you want to plot ==================> GRID_PARAMS
Report steps (0 - 62) =======================================> 0 - 62
Realizations members to plot(0 - 9) =========================> 0 - 9

G: Ensemble plot of ALL ALL GEN_KW parameters

This option will plot all GEN_KW parameters. ERT will ask for report steps and ensemble members.

Report steps (0 - 62) =======================================> 0 - 62
Realizations members to plot(0 - 9) =========================> 0 - 9

o: Observation plot

Use this option to plot the value of one observation against ensemble members at a given report step. See example.

What do you want to plot (KEY:INDEX) ========================> WWCT:OP_1
Report step [0:62] ==========================================> 38

t: Plot RFT and simulated pressure vs. TVD

This option requires a rft_config file.

m: Plot RFT and simulated pressure vs. MD

This option requires a rft_config file.

s: Sensitivity plot

Use this option to plot parameters against each other. ERT will ask for which parameter for the x-axis, result on the y-axis and which report step to plot. See example.

Parameter on the x-axis (blank for iens):  ==================>
Result on the y-axis:  ======================================> WWCT:OP_1
Report step:  [0:62] ========================================> 12

h: Histogram

Use this option to make a histogram of simulated results for parameters.

What do you want to plot (KEY:INDEX) ========================> WWCT:OP_1
Report step:  [0:62] ========================================> 12
Plot Forecast/Analyzed: [F|A] ===============================> f

l: Use logarithmic Y-axis

Changes the the Y-axis to logarithmic scale. Press l again to revert.

b: Back

This option will take you back to the Main menu.

Rank results

/----------------------------------\
|        Ranking of results        |
|----------------------------------|
| c: Create/update misfit table    |
| -------------------------------- |
| n: New ranking                   |
| d: Display ranking               |
| -------------------------------- |
| b: Back                          |
\----------------------------------/

This menu is used to rank the ensemble member results against the observation.

c: Create/update misfit table

This option creates/updates the misfit table.

n: New ranking

This option is used to get rankings for different observations based on the misfits. A file with the ranked results will also be written. ERT asks for an observation and an report step interval to base the rankings on. You will also be asked to give a name to store the ranking under (internally in ERT) and a file name which will be written with the results. Observations to use for rankings has to correspond to values specified in the observation file. ERT asks for a combination of KEY and INDEX, see example. Note that one can use *-notation (ex. WWCT*).

Observations to use for ranking ===================> WWCT:OP_1
Report steps (0 - 62) =============================> 0-61
Name to store ranking under =======================> wwctop1
Name of file to store ranking =====================> misfits

ERT will display the misfit table

  #    Realization    Total misfit
-----------------------------------
  0      2                    6.321
  1      6                    7.518
  2      7                    9.394
  3      3                   10.730
  4      8                   10.763
  5      1                   12.225
  6      0                   12.300
  7      4                   12.665
  8      5                   12.784
  9      9                   22.596
-----------------------------------

d: Display ranking

This option can be used to display previously made rankings. ERT will ask for the name the rankings are stored under. This is the name used when creating the rankings using the option above.

Ranking to display ================================> wwctop1


  #    Realization    Total misfit
-----------------------------------
  0      2                    6.321
  1      6                    7.518
  2      7                    9.394
  3      3                   10.730
  4      8                   10.763
  5      1                   12.225
  6      0                   12.300
  7      4                   12.665
  8      5                   12.784
  9      9                   22.596
-----------------------------------

b: Back

This option will take you back to the Main menu.

Export data to other formats

/--------------------------------------------------------------\
|                 Export data to other formats                 |
|--------------------------------------------------------------|
| x: Export scalar value to CSV file                           |
| ------------------------------------------------------------ |
| r: Export fields to RMS Roff format                          |
| g: Export fields to ECLIPSE grdecl format                    |
| a: Export fields to ECLIPSE restart format (active cells)    |
| l: Export fields to ECLIPSE restart format (all cells)       |
| ------------------------------------------------------------ |
| s: Export P( a =< x < b )                                    |
| ------------------------------------------------------------ |
| y: Export Python module of                                   |
| ------------------------------------------------------------ |
| c: Export cell values to text file(s)                        |
| p: Export line profile of a field to text file(s)            |
| t: Export time development in one cell to text file(s)       |
| ------------------------------------------------------------ |
| d: Export GEN_DATA/GEN_PARAM to file                         |
| ------------------------------------------------------------ |
| m: EclWrite mean and std                                     |
| ------------------------------------------------------------ |
| b: Back                                                      |
\--------------------------------------------------------------/

x: Export scalar value to CSV file

Use this option to export scalar results to cvs. ERT will ask for which scalar to export. It has to correspond to values specified in the observation file. ERT asks for a combination of KEY and INDEX, see example. You will also have to specify a filename.

Scalar to export (KEY:INDEX) ================================> WWCT:OP_1
File to store 'WWCT:OP_1' ===================================> filename

r: Export fields to RMS Roff format

Use this option to export fields to RMS Roff format. ERT will ask for a keyword to plot. This has to correspond to one of the field entries in the config file. You will have to specify for which report step, which realizations and if the forecast or analyzed ensemble should be exported. You will also have to specify a filename with the integer format identifier '%d' in order to generate one file per ensemble member. See example.

Keyword =====================================================> SWAT
Report step:  [0:62] ========================================> 12
Realizations members to export(0 - 9) =======================>
Export Forecast/Analyzed: [F|A] =============================> f
Filename to store files in (with %d) in:  ===================> filename%d

This example will result in the files 'filename0', 'filename1', ..., 'filename9'.

g: Export fields to ECLIPSE grdecl format

Use this option to export fields to ECLIPSE grdecl format. ERT will ask for a keyword to plot. This has to correspond to one of the field entries in the config file. You will have to specify for which report step, which realizations and if the forecast or analyzed ensemble should be exported. You will also have to specify a filename with the integer format identifier '%d' in order to generate one file per ensemble member. See example.

Keyword =====================================================> SWAT
Report step:  [0:62] ========================================> 12
Realizations members to export(0 - 9) =======================>
Export Forecast/Analyzed: [F|A] =============================> f
Filename to store files in (with %d) in:  ===================> filename%d

This example will result in the files 'filename0', 'filename1', ..., 'filename9'.

a: Export fields to ECLIPSE restart format (active cells)

Use this option to export the active cell fields to ECLIPSE restart format. ERT will ask for a keyword to plot. This has to correspond to one of the field entries in the config file. You will have to specify for which report step, which realizations and if the forecast or analyzed ensemble should be exported. You will also have to specify a filename with the integer format identifier '%d' in order to generate one file per ensemble member. See example.

Keyword =====================================================> SWAT
Report step:  [0:62] ========================================> 12
Realizations members to export(0 - 9) =======================>
Export Forecast/Analyzed: [F|A] =============================> f
Filename to store files in (with %d) in:  ===================> filename%d

This example will result in the files 'filename0', 'filename1', ..., 'filename9'.

l: Export fields to ECLIPSE restart format (all cells)

Use this option to export all cells fields to ECLIPSE restart format. ERT will ask for a keyword to plot. This has to correspond to one of the field entries in the config file. You will have to specify for which report step, which realizations and if the forecast or analyzed ensemble should be exported. You will also have to specify a filename with the integer format identifier '%d' in order to generate one file per ensemble member. See example.

Keyword =====================================================> SWAT
Report step:  [0:62] ========================================> 12
Realizations members to export(0 - 9) =======================>
Export Forecast/Analyzed: [F|A] =============================> f
Filename to store files in (with %d) in:  ===================> filename%d

This example will result in the files 'filename0', 'filename1', ..., 'filename9'.

s: Export P( a =< x < b )

y: Export Python module of

c: Export cell values to text file(s)

p: Export line profile of a field to text file(s)

t: Export time development in one cell to text file(s)

d: Export GEN_DATA/GEN_PARAM to file

m: EclWrite mean and std

b: Back

This option will take you back to the Main menu.

Table of results

/--------------------------------------\
|           Table of results           |
|--------------------------------------|
| e: Ensemble of parameters            |
| g: GEN_KW ensemble                   |
| t: Time development of parameters    |
| ------------------------------------ |
| b: Back                              |
\--------------------------------------/

e: Ensemble of parameters

Use this option to look at the ensemble of parameters. Ert asks for parameters to display, an optional filename if you want to store the result, and which report step the parameters should be from. The result will be displayed to screen and stored to file if filename is supplied.

Table headings: KEY1:INDEX1   KEY2:INDEX2 .... ====> WWCT:OP_1
File to save in (blank for nothing)  ==============> filename
report step [0:62] ================================> 12


Realization|        WWCT:OP_1        |
======================================
Mean       |  0.007382 +/-    0.01485|
--------------------------------------
          0|                        0|
          1|                4.266e-05|
          2|                        0|
          3|                  0.04544|
          4|                        0|
          5|                        0|
          6|                 0.001659|
          7|                        0|
          8|                 0.006054|
          9|                  0.02062|
======================================

g: GEN_KW ensemble

Similar to the above option, but looks at gen_kw.

GEN_KW Parameter ==================================> MULTFLT
File to save in (blank for nothing)  ==============> filename
report step [0:62] ================================> 12


Realization|       MULTFLT:F3        |
======================================
Mean       |    0.6623 +/-     0.4043|
--------------------------------------
          0|                   0.9973|
          1|                0.0001293|
          2|                   0.0133|
          3|                   0.3985|
          4|                   0.5341|
          5|                        1|
          6|                        1|
          7|                   0.7761|
          8|                   0.9067|
          9|                   0.9972|
======================================

t: Time development of parameters

Use this option to inspect the time development of parameters.

Table headings: KEY1:INDEX1   KEY2:INDEX2 .... ====> WWCT:OP_1
File to save in (blank for nothing)  ==============> filename
ensemble member [0:9] =============================> 0


Report-step|        WWCT:OP_1        |
======================================
          1|                0.0005678|
          2|                        0|
          3|                  0.09902|
          4|                   0.1572|
          5|                   0.1556|
          6|                   0.1109|

          .                       .
          .                       .
          .                       . 

         62|                   0.7273|
======================================

b: Back

This option will take you back to the Main menu.

Miscellaneous

/---------------------------------------------\
|             Misceallanous stuff             |
|---------------------------------------------|
| l: List all 'magic' <...> strings           |
| j: List all available forward model jobs    |
| ------------------------------------------- |
| b: Back                                     |
\---------------------------------------------/

l: List all 'magic' <...> strings

This option lists all 'magic' <...> strings.

j: List all available forward model jobs

This option lists all available forward model jobs,

b: Back

This option will take you back to the Main menu.

Quit

This opions ends the program.

Personal tools
Namespaces
Variants
Actions
Navigation
Download code
Support
Toolbox