Skip to main content

 

  • About
  • News & Media
  • Careers
  • Events

Breadcrumb

STOMP User Guide

  • STOMP Website
  • Introduction
    • Operational Mode Specific Input Guides
    • Availability and Licensing
    • Installation
  • Fundamentals of STOMP
    • Code Design
    • Numerical Solutions
    • Description of Variables
    • List of Variable Names
    • Accepted Units
    • Glossary of Symbols
  • Using STOMP
    • Pre-Processing
    • Input File Structure
    • Generated Output Files
    • Post-Processing
  • Example Short Course Problems
  • Additional User Documentation

Breadcrumb

  1. STOMP User Guide
  2. STOMP Input
STOMP input data type legend

Solution Control Card Syntax

~Solution Control Cardkeyword icon

choose one icon Choose One Execution Mode Option

Normal
Normalinteger icon,
Restart (expects filename to be "restart")
Restartkeyword icon,
Restart with specified restart filename
Restart Filekeyword icon,Restart Filenamekeyword icon
choose one icon Choose One Operational Mode Option

Isothermal Mode
STOMP-CO2integer icon + Modifiersinteger icon(Optional),
choose one icon One or More Operational Mode modifiers may be specifed after the Operational Mode keyword
Isobrinekeyword icon,
Invariant Fluid Density and Viscositykeyword icon,

If this option is specified, the following must be provided on the line following the Gas Diffusion Option:

Aqueous Densityreal icon,unitscharacter icon(kg/m^3),Aqueous Viscosityreal icon,unitscharacter icon(Pa s),Gas Densityreal icon,unitscharacter icon(kg/m^3),Gas Viscosityreal icon,unitscharacter icon(Pa s),

Fractional CO2 Solubilitykeyword icon,

If this option is specified, the following must be provided on the line following the Gas Diffusion Option, and after the density and viscosity values if the Invariant Fluid Density modifier is specified

Fractional CO2 Solubility Factorreal icon

ECKEChemkeyword icon,
Additional Reactive Transport Modifiers (Optional)

Transportkeyword icon,
Patankarkeyword icon,
First-Order Upwindkeyword icon,
Leonard-TVD Schemekeyword icon,
Roe Superbeekeyword icon,
Courantkeyword icon,
Vadose Courantkeyword icon,
Equilibrium Reducedkeyword icon,
Minimum Concentrationkeyword icon,
Logkeyword icon,
Guesskeyword icon,
Porosity Alteration with Precipitationkeyword icon,
Effective Reaction Areakeyword icon,
Constant Surface Areakeyword icon,
tip iconECKEChem Modifiers

Note that Patankar is the default option for reactive transport, and does not need to be specified, but can be

Non-Isothermal Mode
STOMP-CO2Einteger icon + Modifiersinteger icon(Optional),
choose one icon One or More Operational Mode modifiers may be specifed after the Operational Mode keyword
Isothermalkeyword icon,
Isobrinekeyword icon,
Invariant Fluid Density and Viscositykeyword icon,

If this option is specified, the following must be provided on the line following the Gas Diffusion Option:

Aqueous Densityreal icon,unitscharacter icon(kg/m^3),Aqueous Viscosityreal icon,unitscharacter icon(Pa s),Gas Densityreal icon,unitscharacter icon(kg/m^3),Gas Viscosityreal icon,unitscharacter icon(Pa s),

Fractional CO2 Solubilitykeyword icon,

If this option is specified, the following must be provided on the line following the Gas Diffusion Option, and after the density and viscosity values if the Invariant Fluid Density modifier is specified

Fractional CO2 Solubility Factorreal icon

ECKEChemkeyword icon,
Additional Reactive Transport Modifiers (Optional)

Transportkeyword icon,
Patankarkeyword icon,
First-Order Upwindkeyword icon,
Leonard-TVD Schemekeyword icon,
Roe Superbeekeyword icon,
Courantkeyword icon,
Vadose Courantkeyword icon,
Equilibrium Reducedkeyword icon,
Minimum Concentrationkeyword icon,
Logkeyword icon,
Guesskeyword icon,
Porosity Alteration with Precipitationkeyword icon,
Effective Reaction Areakeyword icon,
Constant Surface Areakeyword icon,
tip iconECKEChem Modifiers

Note that Patankar is the default option for reactive transport, and does not need to be specified, but can be

Number of Execution Time Periodskeyword icon,

repeat icon Repeat for Each Execution Time Period

choose one icon Choose One Time-step Reduction Option

Four Successive Time Step Reductions before Execution Stop
Initial Timereal icon ,Unit(s)char icon,Final Timereal icon ,Unit(s)char icon ,Initial Time Stepreal icon ,Unitschar icon ,Maximum Time Stepreal icon ,Unitschar icon ,Time Step Acceleration Factorreal icon ,Maximum number of Newton-Raphson iterations per time stepinteger icon ,Convergence Criterionreal icon
Time Step Reductions to Minimum Time Step before Execution Stop
Initial Timereal icon ,Unit(s)char icon,Final Timereal icon ,Unit(s)char icon ,Initial Time Stepreal icon ,Unitschar icon ,Maximum Time Stepreal icon ,Unitschar icon ,Time Step Acceleration Factorreal icon ,Maximum number of Newton-Raphson iterations per time stepinteger icon ,Convergence Criterionreal icon Minimum Time Stepreal icon ,Unitschar icon ,Time Step Reduction Factorreal icon ,

Maximum Number of Time Stepskeyword icon,

choose one icon Choose One Aqueous Diffusion Option

Variable Aqueous Diffusionkeyword icon,
Constant Aqueous Diffusionkeyword icon,CO2 Diffusion Coefficientreal icon,Unit(s)char icon,Salt Diffusion Coefficientreal icon,Unit(s)char icon,
Zero Aqueous Diffusionkeyword icon,
choose one icon Choose One Gas Diffusion Option

Variable Gas Diffusionkeyword icon,
Constant Gas Diffusionkeyword icon,Gas Diffusion Coefficientreal icon,
Enhanced Gas Diffusionkeyword icon,Clay Mass Fractionreal icon,
Zero Gas Diffusionkeyword icon,

Number of Interfacial Averaging Variableskeyword icon,

choose one icon Interfacial Averaging Schemes

While STOMP allows the user to specify alternative interfacial averaging schemes, it is strongly suggested that novice users in particular specify "0" for the Number of Interfacial Averaging Variables and use the default schemes, as not all schemes are appropriate for all field variables.

For details see

Solution Control Card Options

repeat icon Repeat for Number of Interfacial Averaging Variables

Surface Variable Optionkeyword icon,Interfacial Averaging Schemekeyword icon,

choose one icon Execution Time Periods

Execution periods refer to a period of simulation time. STOMP allows the user to specify a single or multiple execution periods. For each execution period, the user can control the initial time step, maximum time step, time step acceleration factor, maximum number of Newton-Raphson iterations, and convergence criterion independently.

If no initial time record is read for a restart simulation, the initial time record is obtained from the restart file.

Two additional solution controls can be specified for each Execution Period input line: 1) the minimum time step, and 2) the time-step cut factor. These optional solution controls must be specified together. The minimum-time-step parameter sets the minimum time step for an execution period. Without this control, STOMP quits after four time-step reductions. Cyclic injection well schedules can yield simulations that execute with large time steps during steady injection periods, but require small time steps during the injection startup. The minimum-time-step parameter allows the code to cut the time step to the minimum value before quitting. The time-step cut factor is set to 0.2 by default, which means that time steps are cut to 20% of their value when a convergence failure occurs. Execution performance can be improved for some simulations by altering this factor.

choose one icon Recommended Inputs

Recommended values for the Time Step Acceleration Factor, Maximum Number of Newton-Raphson Iterations, and Convergence Criterion are 1.25, 8, and 1.e-06, respectively. Except under special circumstances, it is not recommended to change the value for the Convergence Criterion from its recommended value. This value has proven through numerous applications to achieve a good balance between accuracy and execution speed.

choose one icon Zero Time Step Simulations

By specifying 0 as the maximum number of time steps, initial conditions can be established for a set of conditions. This can be useful for calculating properties of a fluid that can be then used to determine the pressure gradient to be specified in the initial conditions card.

PNNL

  • Get in Touch
    • Contact
    • Careers
    • Doing Business
    • Security & Privacy
  • Research
    • Scientific Discovery
    • Energy Resiliency
    • National Security
Sign up for our newsletter
Department of Energy Logo Battelle Logo
Pacific Northwest National Laboratory (PNNL) is managed and operated by Battelle for the Department of Energy
  • YouTube
  • Facebook
  • Twitter
  • Instagram
  • LinkedIn