Ubuntu Manpage: flow - Eclipse compatible parallel reservoir simulator

Provided by: libopm-simulators-bin_2022.10+ds-1build2_amd64

NAME

       flow - Eclipse compatible parallel reservoir simulator

SYNOPSIS

       flow [OPTIONS] [ECL_DECK_FILENAME]

DESCRIPTION

Flow, an advanced reservoir simulator for ECL-decks provided by the Open Porous Media
project.

Recognized options:
-h,--help
Print this help message and exit

--help-all
Print all parameters, including obsolete, hidden and deprecated ones.

--accelerator-mode=STRING
Use GPU (cusparseSolver or openclSolver) or FPGA (fpgaSolver) as the linear solver,
usage: '--accelerator-mode=[none|cusparse|opencl|fpga|amgcl]'. Default: "none"

--allow-distributed-wells=BOOLEAN
Allow the perforations of a well to be distributed to interior of multiple
processes. Default: false

--alternative-well-rate-init=BOOLEAN
Use alternative well rate initialization procedure. Default: true

--bda-device-id=INTEGER
Choose device ID for cusparseSolver or openclSolver, use 'nvidia-smi' or 'clinfo'
to determine valid IDs. Default: 0

--continue-on-convergence-error=BOOLEAN
Continue with a non-converged solution instead of giving up if we encounter a time
step size smaller than the minimum time step size. Default: false

--cpr-max-ell-iter=INTEGER
MaxIterations of the elliptic pressure part of the cpr solver. Default: 20

--cpr-reuse-interval=INTEGER
Reuse preconditioner interval. Used when CprReuseSetup is set to 4, then the
preconditioner will be fully recreated instead of reused every N linear solve,
where N is this parameter. Default: 10

--cpr-reuse-setup=INTEGER
Reuse preconditioner setup. Valid options are 0: recreate the preconditioner for
every linear solve, 1: recreate once every timestep, 2: recreate if last linear
solve took more than 10 iterations, 3: never recreate, 4: recreated every
CprReuseInterval. Default: 3

--dbhp-max-rel=SCALAR
Maximum relative change of the bottom-hole pressure in a single iteration. Default:
1

--dp-max-rel=SCALAR
Maximum relative change of pressure in a single iteration. Default: 0.3

--ds-max=SCALAR
Maximum absolute change of any saturation in a single iteration. Default: 0.2

--dwell-fraction-max=SCALAR
Maximum absolute change of a well's volume fraction in a single iteration. Default:
0.2

--ecl-deck-file-name=STRING
The name of the file which contains the ECL deck to be simulated. Default: ""

--ecl-enable-drift-compensation=BOOLEAN
Enable partial compensation of systematic mass losses via the source term of the
next time step. Default: true

--ecl-output-double-precision=BOOLEAN
Tell the output writer to use double precision. Useful for 'perfect' restarts.
Default: false

--ecl-output-interval=INTEGER
The number of report steps that ought to be skipped between two writes of ECL
results. Default: -1

--ecl-strict-parsing=BOOLEAN
Use strict mode for parsing - all errors are collected before the applicaton
exists. Default: false

--edge-weights-method=INTEGER
Choose edge-weighing strategy: 0=uniform, 1=trans, 2=log(trans). Default: 1

--enable-adaptive-time-stepping=BOOLEAN
Use adaptive time stepping between report steps. Default: true

--enable-async-ecl-output=BOOLEAN
Write the ECL-formated results in a non-blocking way (i.e., using a separate
thread). Default: true

--enable-async-vtk-output=BOOLEAN
Dispatch a separate thread to write the VTK output. Default: true

--enable-dry-run=STRING
Specify if the simulation ought to be actually run, or just pretended to be.
Default: "auto"

--enable-ecl-output=BOOLEAN
Write binary output which is compatible with the commercial Eclipse simulator.
Default: true

--enable-esmry=BOOLEAN
Write ESMRY file for fast loading of summary data. Default: false

--enable-logging-fallout-warning=BOOLEAN
Developer option to see whether logging was on non-root processors. In that case it
will be appended to the *.DBG or *.PRT files. Default: false

--enable-opm-rst-file=BOOLEAN
Include OPM-specific keywords in the ECL restart file to enable restart of OPM
simulators from these files. Default: false

--enable-storage-cache=BOOLEAN
Store previous storage terms and avoid re-calculating them. Default: true

--enable-terminal-output=BOOLEAN
Print high-level information about the simulation's progress to the terminal.
Default: true

--enable-tuning=BOOLEAN
Honor some aspects of the TUNING keyword. Default: false

--enable-vtk-output=BOOLEAN
Global switch for turning on writing VTK files. Default: false

--enable-well-operability-check=BOOLEAN
Enable the well operability checking. Default: true

--enable-well-operability-check-iter=BOOLEAN
Enable the well operability checking during iterations. Default: false

--enable-write-all-solutions=BOOLEAN
Write all solutions to disk instead of only the ones for the report steps. Default:
false

--force-disable-fluid-in-place-output=BOOLEAN
Do not print fluid-in-place values after each report step even if requested by the
deck. Default: false

--force-disable-resv-fluid-in-place-output=BOOLEAN
Do not print reservoir volumes values after each report step even if requested by
the deck. Default: false

--fpga-bitstream=STRING
Specify the bitstream file for fpgaSolver (including path), usage:
'--fpga-bitstream=<filename>'. Default: ""

--full-time-step-initially=BOOLEAN
Always attempt to finish a report step using a single substep. Default: false

--ignore-keywords=STRING
List of Eclipse keywords which should be ignored. As a ':' separated string.
Default: ""

--ilu-fillin-level=INTEGER
The fill-in level of the linear solver's ILU preconditioner. Default: 0

--ilu-redblack=BOOLEAN
Use red-black partitioning for the ILU preconditioner. Default: false

--ilu-relaxation=SCALAR
The relaxation factor of the linear solver's ILU preconditioner. Default: 0.9

--ilu-reorder-spheres=BOOLEAN
Whether to reorder the entries of the matrix in the red-black ILU preconditioner in
spheres starting at an edge. If false the original ordering is preserved in each
color. Otherwise why try to ensure D4 ordering (in a 2D structured grid, the
diagonal elements are consecutive). Default: false

--initial-time-step-in-days=SCALAR
The size of the initial time step in days. Default: 1

--linear-solver=STRING
Configuration of solver. Valid options are: ilu0 (default), cpr (an alias for
cpr_trueimpes), cpr_quasiimpes, cpr_trueimpes or amg. Alternatively, you can
request a configuration to be read from a JSON file by giving the filename here,
ending with '.json.'. Default: "ilu0"

--linear-solver-ignore-convergence-failure=BOOLEAN
Continue with the simulation like nothing happened after the linear solver did not
converge. Default: false

--linear-solver-max-iter=INTEGER
The maximum number of iterations of the linear solver. Default: 200

--linear-solver-reduction=SCALAR
The minimum reduction of the residual which the linear solver must achieve.
Default: 0.01

--linear-solver-restart=INTEGER
The number of iterations after which GMRES is restarted. Default: 40

--linear-solver-verbosity=INTEGER
The verbosity level of the linear solver (0: off, 2: all). Default: 0

--matrix-add-well-contributions=BOOLEAN
Explicitly specify the influences of wells between cells in the Jacobian and
preconditioner matrices. Default: false

--max-inner-iter-ms-wells=INTEGER
Maximum number of inner iterations for multi-segment wells. Default: 100

--max-inner-iter-wells=INTEGER
Maximum number of inner iterations for standard wells. Default: 50

--max-newton-iterations-with-inner-well-iterations=INTEGER
Maximum newton iterations with inner well iterations. Default: 8

--max-pressure-change-ms-wells=SCALAR
Maximum relative pressure change for a single iteration of the multi-segment well
model. Default: 1e+06

--max-residual-allowed=SCALAR
Absolute maximum tolerated for residuals without cutting the time step size.
Default: 1e+07

--max-single-precision-days=SCALAR
Maximum time step size where single precision floating point arithmetic can be used
solving for the linear systems of equations. Default: 20

--max-temperature-change=SCALAR
Maximum absolute change of temperature in a single iteration. Default: 5

--max-welleq-iter=INTEGER
Maximum number of iterations to determine solution the well equations. Default: 30

--maximum-number-of-well-switches=INTEGER
Maximum number of times a well can switch to the same control. Default: 3

--milu-variant=STRING
Specify which variant of the modified-ILU preconditioner ought to be used. Possible
variants are: ILU (default, plain ILU), MILU_1 (lump diagonal with dropped row
entries), MILU_2 (lump diagonal with the sum of the absolute values of the dropped
row entries), MILU_3 (if diagonal is positive add sum of dropped row entrires.
Otherwise subtract them), MILU_4 (if diagonal is positive add sum of dropped row
entrires. Otherwise do nothing. Default: "ILU"

--min-strict-cnv-iter=INTEGER
Minimum number of Newton iterations before relaxed tolerances can be used for the
CNV convergence criterion. Default: 0

--min-time-step-based-on-newton-iterations=SCALAR
The minimum time step size (in days for field and metric unit and hours for lab
unit) can be reduced to based on newton iteration counts. Default: 0

--min-time-step-before-shutting-problematic-wells-in-days=SCALAR
The minimum time step size in days for which problematic wells are not shut.
Default: 0.01

--newton-max-iterations=INTEGER
The maximum number of Newton iterations per time step. Default: 20

--newton-max-relax=SCALAR
The maximum relaxation factor of a Newton iteration. Default: 0.5

--newton-min-iterations=INTEGER
The minimum number of Newton iterations per time step. Default: 1

--newton-relaxation-type=STRING
The type of relaxation used by Newton method. Default: "dampen"

--num-jacobi-blocks=INTEGER
Number of blocks to be created for the Block-Jacobi preconditioner. Default: 0

--opencl-ilu-reorder=STRING
Choose the reordering strategy for ILU for openclSolver and fpgaSolver, usage:
'--opencl-ilu-reorder=[level_scheduling|graph_coloring], level_scheduling behaves
like Dune and cusparse, graph_coloring is more aggressive and likely to be faster,
but is random-based and generally increases the number of linear solves and linear
iterations significantly. Default: ""

--opencl-platform-id=INTEGER
Choose platform ID for openclSolver, use 'clinfo' to determine valid platform IDs.
Default: 0

--output-dir=STRING
The directory to which result files are written. Default: ""

--output-interval=INTEGER
Specify the number of report steps between two consecutive writes of restart data.
Default: 1

--output-mode=STRING
Specify which messages are going to be printed. Valid values are: none, log, all
(default). Default: "all"

--owner-cells-first=BOOLEAN
Order cells owned by rank before ghost/overlap cells. Default: true

--parameter-file=STRING
An .ini file which contains a set of run-time parameters. Default: ""

--pri-var-oscilation-threshold=SCALAR
The threshold value for the primary variable switching conditions after its meaning
has switched to hinder oscilations. Default: 1e-05

--print-parameters=INTEGER
Print the values of the run-time parameters at the start of the simulation.
Default: 2

--print-properties=INTEGER
Print the values of the compile time properties at the start of the simulation.
Default: 2

--project-saturations=BOOLEAN
Option for doing saturation projection. Default: false

--regularization-factor-wells=SCALAR
Regularization factor for wells. Default: 100

--relaxed-max-pv-fraction=SCALAR
The fraction of the pore volume of the reservoir where the volumetric error (CNV)
may be voilated during strict Newton iterations. Default: 0.03

--relaxed-pressure-tol-msw=SCALAR
Relaxed tolerance for the MSW pressure solution. Default: 10000

--relaxed-well-flow-tol=SCALAR
Relaxed tolerance for the well flow residual. Default: 0.001

--scale-linear-system=BOOLEAN
Scale linear system according to equation scale and primary variable types.
Default: false

--sched-restart=BOOLEAN
When restarting: should we try to initialize wells and groups from historical
SCHEDULE section. Default: false

--serial-partitioning=BOOLEAN
Perform partitioning for parallel runs on a single process. Default: false

--shut-unsolvable-wells=BOOLEAN
Shut unsolvable wells. Default: true

--solve-welleq-initially=BOOLEAN
Fully solve the well equations before each iteration of the reservoir model.
Default: true

--solver-continue-on-convergence-failure=BOOLEAN
Continue instead of stop when minimum solver time step is reached. Default: false

--solver-growth-factor=SCALAR
The factor time steps are elongated after a successful substep. Default: 2

--solver-max-growth=SCALAR
The maximum factor time steps are elongated after a report step. Default: 3

--solver-max-restarts=INTEGER
The maximum number of breakdowns before a substep is given up and the simulator is
terminated. Default: 10

--solver-max-time-step-in-days=SCALAR
The maximum size of a time step in days. Default: 365

--solver-min-time-step=SCALAR
The minimum size of a time step in days for field and metric and hours for lab. If
a step cannot converge without getting cut below this step size the simulator will
stop. Default: 1e-12

--solver-restart-factor=SCALAR
The factor time steps are elongated after restarts. Default: 0.33

--solver-verbosity=INTEGER
Specify the "chattiness" of the non-linear solver itself. Default: 1

--strict-inner-iter-wells=INTEGER
Number of inner well iterations with strict tolerance. Default: 40

--strict-outer-iter-wells=INTEGER
Number of newton iterations for which wells are checked with strict tolerance.
Default: 6

--temperature-max=SCALAR
Maximum absolute temperature. Default: 1e+09

--temperature-min=SCALAR
Minimum absolute temperature. Default: 0

--threads-per-process=INTEGER
The maximum number of threads to be instantiated per process ('-1' means
'automatic'). Default: -1

--time-step-after-event-in-days=SCALAR
Time step size of the first time step after an event occurs during the simulation
in days. Default: -1

--time-step-control=STRING
The algorithm used to determine time-step sizes. valid options are: 'pid'
(default), 'pid+iteration', 'pid+newtoniteration', 'iterationcount',
'newtoniterationcount' and 'hardcoded'. Default: "pid+newtoniteration"

--time-step-control-decay-damping-factor=SCALAR
The decay rate of the time step decrease when the target iterations is exceeded.
Default: 1

--time-step-control-decay-rate=SCALAR
The decay rate of the time step size of the number of target iterations is
exceeded. Default: 0.75

--time-step-control-file-name=STRING
The name of the file which contains the hardcoded time steps sizes. Default:
"timesteps"

--time-step-control-growth-damping-factor=SCALAR
The growth rate of the time step increase when the target iterations is undercut.
Default: 3.2

--time-step-control-growth-rate=SCALAR
The growth rate of the time step size of the number of target iterations is
undercut. Default: 1.25

--time-step-control-target-iterations=INTEGER
The number of linear iterations which the time step control scheme should aim for
(if applicable). Default: 30

--time-step-control-target-newton-iterations=INTEGER
The number of Newton iterations which the time step control scheme should aim for
(if applicable). Default: 8

--time-step-control-tolerance=SCALAR
The tolerance used by the time step size control algorithm. Default: 0.1

--time-step-verbosity=INTEGER
Specify the "chattiness" during the time integration. Default: 1

--tolerance-cnv=SCALAR
Local convergence tolerance (Maximum of local saturation errors). Default: 0.01

--tolerance-cnv-relaxed=SCALAR
Relaxed local convergence tolerance that applies for iterations after the
iterations with the strict tolerance. Default: 1

--tolerance-mb=SCALAR
Tolerated mass balance error relative to total mass present. Default: 1e-06

--tolerance-pressure-ms-wells=SCALAR
Tolerance for the pressure equations for multi-segment wells. Default: 1000

--tolerance-well-control=SCALAR
Tolerance for the well control equations. Default: 1e-07

--tolerance-wells=SCALAR
Well convergence tolerance. Default: 0.0001

--update-equations-scaling=BOOLEAN
Update scaling factors for mass balance equations during the run. Default: false

--use-gmres=BOOLEAN
Use GMRES as the linear solver. Default: false

--use-multisegment-well=BOOLEAN
Use the well model for multi-segment wells instead of the one for single-segment
wells. Default: true

--use-update-stabilization=BOOLEAN
Try to detect and correct oscillations or stagnation during the Newton method.
Default: true

--zoltan-imbalance-tol=SCALAR
Tolerable imbalance of the loadbalancing provided by Zoltan (default: 1.1).
Default: 1.1