This is the iTOUGH2 command index in logical order. Click on any command for a description of the command syntax, the name of the parent command, the name of subcommands, as well as the purpose and effect of the command along with an illustrative example.
There are three main blocks in the iTOUGH2 input file, identified by one of the following first-level commands:
- > GENERAL
- > DIMENSION
- > PARAMETER
- > OBSERVATION
- > COMPUTATION
The first block (first-level command > PARAMETER) is used to identify the TOUGH2 input parameters that will be subjected to parameter estimation, sensitivity analysis, or uncertainty propagation analysis. The second block (first-level command > OBSERVATION) is used to identify the TOUGH2 output variables that will be compared to observed data for model calibration. The third block (first-level command > COMPUTATION) is used for various program options and computational parameters.
GENERAL COMMANDS AND KEYWORDS
# (Ignore line if # in first column)
/* (Beginning of block to be commented out)
*/ (End of block being commented out)
FILE: input_file_name Copies input file from working to temporary directory (if using Unix script itough2)
OUTPUTFILE: output_file_name Copies output file from temporary to working directory (if using Unix script itough2)
ECHO ON/OFF
INCLUDE FILE: file_name
>> NUMBER OF PARAMETERS: maxn
>> NUMBER OF OBSERVATIONS: maxm
>> NUMBER OF PEST OBSERVATIONS: maxpesto
>> NUMBER OF TIMES: maxtim
>> NUMBER OF DATA SETS: maxo
>> NUMBER OF DATA POINTS: maxpd
>> NUMBER OF RESTARTS: maxbrk
>> NUMBER OF REGULARIZATION TERMS: maxreg
>> MAXEBRK: maxebrk
>> MAXR: maxr
>> ABSOLUTE PERMEABILITY
>> BOTTOMHOLE PRESSURE
>> BOX-COX
>> CAPACITY
>> CAPILLARY PRESSURE FUNCTION
>> COMPRESSIBILITY
>> CONDUCTIVITY (WET/DRY)
>> DIFFUSION
>> DRIFT
>> ENTHALPY
>> EXPANSION
>> FORCHHEIMER
>> GUESS (FILE: file_name)
>> IFS
>> INITIAL (PRESSURE/: ipv)
>> KLINKENBERG
>> LAG
>> LIST
>> MINC
>> PARALLEL PLATE
>> PEST
>> POROSITY
>> PRODUCTIVITY INDEX
>> PUMPING RATIO
>> RATE
>> REGION (SINK/SOURCE, PERMEABILITY, OBSERVATION)
>> REGRESSION
>> REGULARIZATION (FILE: file_name) (BETA: beta)
>> RELATIVE PERMEABILITY FUNCTION
>> SCALE
>> SCALING FACTOR
>> SELEC
>> SHIFT
>> SKIN
>> TIME
>> USER (: anno)
>>> DEFAULT
>>> LIST
>>> MATERIAL: mat_name (mat_name_i...) (+ iplus ([islotb-islote]))
>>> MODEL
>>> NONE
>>> ROCK: mat_name (mat_name_i...) (+ iplus ([islotb-islote]))
>>> SET: iset
>>> SINK: sink_name (sink_name_i ...) (+ iplus ([islotb-islote]))
>>> SOURCE: source_name (source_name_i ...) (+ iplus ([islotb-islote]))
>>>> ANNOTATION: anno
>>>> BOUND (LINEAR): lower upper
>>>> BOX-COX: lambda
>>>> DEVIATION: sigma
>>>> FACTOR
>>>> GAUSSIAN
>>>> GUESS: guess
>>>> INACTIVE
>>>> INDEX: index (index_i...)
>>>> LIST
>>>> LOGARITHM
>>>> LOG(F)
>>>> NORMAL
>>>> PARAMETER: index (index_i...)
>>>> PARENT: parent_ID/parent_annotation
>>>> PERTURB: (-)alpha (%)
>>>> PRIOR: prior_info
>>>> RANGE (LINEAR): lower upper
>>>> RELATED TO: parent_ID/parent_annotation
>>>> STEP: max_step
>>>> TIED TO: parent_ID/parent_annotation
>>>> TRIANGULAR
>>>> UNIFORM
>>>> VALUE
>>>> VARIANCE: sigma^2
>>>> VARIATION: sigma
>>>> WEIGHT: 1/sigma
>> CONCENTRATION (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> CONTENT (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> COVARIANCE (FILE: filename)
>> CUMULATIVE (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> DRAWDOWN (phase_name/PHASE: iphase)
>> ENTHALPY (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> FLOW (phase_name/PHASE: iphase) (component_name/COMPONENT: icomponent) (HEAT) (CHANGE/DELTA)
>> GENERATION (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> HUMIDITY (CHANGE/DELTA)
>> LIST
>> MASS FRACTION (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> MOLE FRACTION (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> MOMENT (FIRST/SECOND) (X/Y/Z) (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> PEST (CHANGE/DELTA)
>> POWER (CHANGE/DELTA)
>> PRESSURE (CAPILLARY) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> PRODUCTION (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> REGULARIZATION (FILE: file_name) (BETA: beta)
>> RESTART TIME : ntime (time_unit) (NEW)
>> SATURATION (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> SECONDARY (phase_name/PHASE: iphase) (: ipar) (CHANGE/DELTA)
>> SUBSIDANCE (CHANGE/DELTA)
>> TEMPERATURE (CHANGE/DELTA)
>> TIME: ntime (EQUAL/LOGARITHMIC) (time_unit)
>> TIME from DATA/OBSERVATIONS
>> TOTAL MASS (comp_name/COMPONENT: icomp) (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> USER (: anno) (CHANGE/DELTA)
>> VOLUME (phase_name/PHASE: iphase) (CHANGE/DELTA)
>> WATERTABLE (CHANGE/DELTA)
>>> CONNECTION: elem1 elem2 (elem_i elem_j ...) (++/+-/-+ iplus ([islotb-islote]))
>>> CONNECTION COORDINATE (BOX/ELLIPSOID/CYLINDER/CUBE/CONE) (ROTATE) (OUTSIDE): X1 Y1 Z1 (X2 Y2 Z2 (R (R2)) / (AZIMUTH DIP PLUNGE))
>>> CONNECTION COORDINATE PRISM (OUTSIDE) AXIS: ijkAXIS POLYGON: NP : Axismax C1,1 C1,2 ... CNP,1 CNP,2
>>> CONNECTION PROFILE/CROSS-SECTION/MAP
>>> ELEMENT: elem (elem_i ...) (+ iplus ([islotb-islote]))
>>> ELEMENT COORDINATE (BOX/ELLIPSOID/CYLINDER/CUBE/CONE) (ROTATE) (OUTSIDE): X1 Y1 Z1 (X2 Y2 Z2 (R (R2)) / (AZIMUTH DIP PLUNGE))
>>> ELEMENT COORDINATE PRISM (OUTSIDE) AXIS: ijkAXIS POLYGON: NP : Axismax C1,1 C1,2 ... CNP,1 CNP,2
>>> ELEMENT PROFILE/CROSS-SECTION/MAP
>>> LIST
>>> MODEL
>>> NONE
>>> SINK: sink_name (sink_name_i ...) (+ iplus ([islotb-islote]))
>>> SOURCE: source_name (source_name_i ...) (+ iplus ([islotb-islote]))
>>>> ABSOLUTE
>>>> ANNOTATION: anno
>>>> ARRIVAL (RAW/ANALYZE) (INCREMENT): threshold
>>>> AUTO
>>>> AVERAGE (VOLUME)
>>>> COLUMN: itime idata (istd_dev)
>>>> COMBINE: isetdwa
>>>> COMPONENT comp_name/: icomp
>>>> CONSTRAINT : lower upper
>>>> CUMULATIVE (ANALYZE/RAW) (SUM)
>>>> DATA (NO DATA/ZERO DATA/FILE: file_name) (time_unit)
>>>> DETREND: timewindow (time_unit) / -npoints
>>>> DEVIATION: sigma (ADD NOISE)
>>>> FACTOR: factor
>>>> FORMAT: format
>>>> HEADER: nskip
>>>> INDEX: index (index_i ...)
>>>> LIST
>>>> LINK: linktoset/setanno (ADD/SUBTRACT/MULTIPLY/DIVIDE)
>>>> LOGARITHM
>>>> MAXIMUM (TIME) (RAW/ANALYZE) (DISCRETE/CONTINUOUS)
>>>> MEAN (VOLUME)
>>>> MINIMUM (TIME) (RAW/ANALYZE) (DISCRETE/CONTINUOUS)
>>>> PARAMETER: index (index_i ...)
>>>> PEAK (TIME) (RAW/ANALYZE) (DISCRETE/CONTINUOUS)
>>>> PENALTY : penaltypar(1) penaltypar(2)
>>>> PHASE: phase_name/: iphase
>>>> PICK: npick
>>>> POLYNOM: idegree (time_unit)
>>>> POTENTIAL
>>>> PREDICTION
>>>> REGRESSION: rho
>>>> RELATIVE: rel_err (%) (+ const_err) (ADD NOISE)
>>>> SET: iset
>>>> SHIFT: shift (TIME (time_unit))
>>>> SKIP: nskip
>>>> SUM
>>>> VARIANCE: sigma^2 (ADD NOISE)
>>>> WEIGHT: 1/sigma (ADD NOISE)
>>>> WINDOW (INDIVIDUAL / : time_A time_B (time_unit))
>> CONVERGE/STOP/TOLERANCE
>>> ABORT (NO)
>>> ADJUST
>>> CONSECUTIVE: max_iter1
>>> DELTFACT: deltfact
>>> DIRECT
>>> FORWARD
>>> GOODNESS-OF-FIT
>>> INCOMPLETE: max_incomplete
>>> INPUT
>>> ITERATION: max_iter
>>> LEVENBERG: lambda
>>> LIST
>>> MARQUARDT: nue
>>> REDUCTION: max_red
>>> SIGNAL
>>> SIMULATION: mtough2
>>> STEP (CURRENT/UNSCALED): max_step
>>> UPHILL: max_uphill
>>> WARNING
>> ERROR
>>> ALPHA: alpha (%)
>>> EMPIRICAL ORTHOGONAL FUNCTIONS (MATRIX: ndim) (iTOUGH2) (CORRELATION)
>>> EOF (MATRIX: ndim) (iTOUGH2) (CORRELATION)
>>> FISHER
>>> FOSM (MATRIX: ndim) (iTOUGH2) (CORRELATION) (DIAGONAL)
>>> HESSIAN
>>> IOD
>>> LINEARITY (: alpha (%))
>>> LIST
>>> MONTE CARLO (SEED: iseed) (GENERATE) (CLASS: nclass)
>>> POSTERIORI
>>> PRIORI
>>> TAU: (-)niter
>> JACOBIAN
>>> CENTERED
>>> FORWARD (: iswitch)
>>> HESSIAN
>>> LIST
>>> PERTURB: (-)perturb (%)
>>> ANNEAL
>>>> ITERATION: max_iter
>>>> LIST
>>>> SCHEDULE: beta
>>>> STEP: max_step
>>>> TEMPERATURE: (-)temp0
>>> CAUCHY
>>> DESIGN
>>> DIRECT
>>> FORWARD
>>> GRID SEARCH (UNSORTED) (: ninval1 (ninval2 (ninval3)) / FILE: filename)
>>> GAUSS-NEWTON
>>> L1-ESTIMATOR
>>> LEAST-SQUARE
>>> LEVENBERG-MARQUARDT (IDENTITY/EIGENVALUE) (SUPER/TRUNCATE (: (-)trunc))
>>> LIST
>>> OBJECTIVE (UNSORTED) (: ninval1 (ninval2 (ninval3)) / FILE: filename)
>>> PEST
>>>> DECPOINT: POINT/NOPOINT
>>>> EXECUTABLE: FILE (BEOFRE/AFTER)
>>>> INSTRUCTION: num-instruction-files
>>>> PRECISION: SINGLE/DOUBLE
>>>> TEMPLATE: num-template-files
>>> PARALLEL: ncores (SLEEP: isleep) (ROOT: root_directory) ((AGGRESSIVE) LEVENBERG (ALL PROCESSORS / PROCESSORS: ncoreslm))
>>> PVM: nhosts (SLEEP: isleep) (FILE: node-file) ((AGGRESSIVE) LEVENBERG (ALL PROCESSORS / PROCESSORS: nprocslm))
>>> QUADRATIC-LINEAR: c
>>> SELECT/SUPER
>>>> CORRELATION: (-)rcorr
>>>> IMMOBILIZATION (: ofredmin)
>>>> ITERATION: niter
>>>> LIST
>>>> SENSITIVITY: (-)rsens
>>>> SEQUENTIAL
>>>> TRUNCATE (:(-)trunc)
>>> SIMPLEX
>>> SENSITIVITY (LOCAL)
>>> SENSITIVITY MORRIS
>>> SENSITIVITY SALTELLI/SOBOL
>>> STEADY-STATE (SAVE) (: (-)time_step)
>>> TORNADO (: n_std_dev / BOUNDS)
>>> data-WORTH analysis (PARAMETER/PREDICTION) (TRACE/DETERMINANT) (SET) (METRIC: imetric) (PERCENT)
>> OUTPUT
>>> BENCHMARK
>>> CHARACTERISTIC
>>> COVARIANCE
>>> DETREND
>>> FORMAT: format (LIST, TAB/CSV/COMMA)
>>> IDENTIFIABILITY
>>> LIST
>>> JACOBIAN
>>> NEW OUTPUT
>>> OBJECTIVE
>>> PERFORMANCE
>>> PLOTFILE: format (LIST)
>>> PLOTTING: niter
>>> PRINTOUT: level
>>> RESOLUTION
>>> SENSITIVITY
>>> time_unit
>>> RESIDUAL
>>> WORTH (PARAMETER/PREDICTION) (TRACE/DETERMINANT) (SET) (METRIC: imetric) (PERCENT)