SMS:RMA2 Model Control Dialog: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
Line 7: Line 7:
'''''Simulation Titles / $T1 Card'''''
'''''Simulation Titles / $T1 Card'''''


The RMA2 .geo file contains three comment lines, which can be set using the Title 1, Title 2, and Title 3 edit fields.
The RMA2 .geo file contains three comment lines, which can be set using the ''Title 1'', ''Title 2'', and ''Title 3'' edit fields.


'''''Machine Type / $M Card'''''
'''''Machine Type / $M Card'''''

Revision as of 16:18, 6 October 2017

This article highlights frequently used RMA2 model control parameters. Please see the RMA2 model documentation for a description of items not discussed or for more information on specific items. Model parameters are set in the RMA2 Model Control dialog access through the RMA2 | Model Control menu command.

RMA2 model parameters are divided into the following groups in the RMA2 Model Control dialog:

General

File:RMA2 MC General.jpg
RMA2 Model Control dialog showing the General tab

Simulation Titles / $T1 Card

The RMA2 .geo file contains three comment lines, which can be set using the Title 1, Title 2, and Title 3 edit fields.

Machine Type / $M Card

Set the machine type the RMA2 simulation will be run on. Options include:

  • Microprocessor (PC) – Default option. Direct access record length is unlimited and is define in terms of bytes.
  • Prime mini-computer – Direct access record length is unlimited and is defined in terms of small words (i.e. 2 bytes).
  • DEC VAX – Direct access record length, limited to 32K bytes and defined in terms of long words (4 bytes).
  • Cray or Cyber-205 – Direct access defined for systems using 64 bit or 8 byte words and where record lengths are defined in bytes.
  • HP or Alpha workstations – Direct access defined using multiple sequential access files that are opened as required.

Water Properties

Set the properties of the water being simulated.

  • Temperature / FT Card – Average initial water temperature.
  • Density / FD Card – Used to supply a fluid density for all nodes or a specified node.
  • Coldstart initial water surface / IC Card – Used to provide initial conditions to start a cold run.
  • 1D node initial conditions
    • Minimum depth / IC Card – Minimum depth used for one-dimensional nodes at startup.
    • Initial velocity / IC Card – Nominal velocity for one-dimensional nodes.

Scale Factors

  • X scale / GS Card – Scale factor for X-coordinates.
  • Y scale / GS Card – Scale factor for Y-coordinates.
  • Z scale / GS Card – Scale factor for Z-coordinates (bottom elevation).

Model Stability

  • Special calculations

Timing

File:RMA2 MC Timing.jpg
RMA2 Model Control dialog showing the Timing tab

Simulation Type

  • Steady state – Boundary conditions do not change with time. A "snapshot" in time.
  • Dynamic – Boundary conditions change with time. Computation Time parameters will need to be specified.

Iterations For Flow Calculations

See the TI Card description in the RMA2 model documentation.

  • Initial solution – Maximum number of iterations to perform for the initial solution.
  • Each time step – Used for dynamic simulation - maximum number of iterations to perform after the first time step.

Computation Time

See the TZ Card description in the RMA2 model documentation.

  • Time step size – DELT Variable
  • Number of time steps – NCYC Variable
  • Maximum time – TMAX Variable
  • First time step – NSTART Variable
  • Perform intermediate restart – MBAND Variable

Bendway Correction

Used to supply values associated with the calculation of vorticity. See the VO Card description in the RMA2 model documentation.

  • Compute vorticity – IVOR Variable
  • ASEC – ASEC coefficient for the vorticity equation. Recommend: 5.0
  • DSEC – DSEC coefficient for the vorticity equation. Recommend: 0.5
  • RCMIN – Minimum radius of curvature that will be allowed. Recommend: 6 feet (or 2 meters).

See also BV card, TV card.

Depth Convergence Parameters

  • Steady state depth convergence
  • Dynamic depth convergence

Vorticity Convergence Parameters

See the VO Card description in the RMA2 model documentation.

  • Steady state vorticity convergence
  • Dynamic vorticity convergence

Iterations for Vorticity Calculations

The maximum number of iterations allowed for the vorticity calculation is set by tvariables NVITI or NVITN on the TV card. If the number of passes between the phases reaches NPASS1 or NPASS2, then the calculation has failed to converge. If the number of “good passes” between the two phases exceeds NGOODMAX, the calculation is finished and the code can proceed to the next time step. See the "Bendway Correction (Vorticity)" section and TV Card description in the RMA2 model documentation.

The following TV Card variables are used to control the number of iterations for vorticity calculations:

  • Steady state passes – NPASS1 Variable
  • Steady state vorticity iterations – NVITI Variable
  • Dynamic passes – NPASS2 Variable
  • Dynamic vorticity iterations – NVITN Variable
  • Number of good passes required – NGOODMAX Variable

Files

File:RMA2 MC Files.jpg
RMA2 Model Control showing the Files tab

RMA2 Input Files

  • Specify geometry file – Select an existing RMA2 ASCII Geometry (*.geo) file to use with the simulation
  • Hotstart input file – Specify an existing RMA2 Hot Start File (*.hot) to use with the simulation
    • Use specific time for hotstart
  • Alternate dynamic BC file – See the "RMA2 Alternate Dynamic BC File Format" section of the RMA2 model documentation
  • Write dynamic memory file – See the "Dynamic Memory Allocation" section of the RMA2 model documentation

RMA2 Solution Files

  • Write RMA2 solution file
    • Write frequency in time steps
  • Write hot start file – Write an RMA2 Hot Start Output (*.hot) file. See RMA2 Spindown for a discussion of hot starting.
    • Save only the last time step – Write only the last successful RMA2 time step solution to the hot start file.
    • Write frequency in time steps – Write multiple time steps to the hot start file.

Informational Files

  • Echo card input to screen
  • Write ASCII results file
    • Do not echo any node/element input data
    • Echo all input data except initial conditions
    • Echo all input data
    • Write frequency of nodal results in time steps
    • Trace subroutines level
  • Write summary by node file
  • Write automatically computed parameters file
  • Write vorticity file
    • Write frequency in time steps

Global Methods

File:RMA2 MC Global.jpg
RMA2 Model Control dialog showing the Global Methods tab

Global Wet/Dry Technique

See the Material Properties article for a description of the Marsh Porosity parameters.

Global Roughness Assignment

Coriolis Forces

  • Latitude

Global Eddy Viscosity Assignment

See the Material Properties article for a description of the Turbulence parameters.

  • Traditional eddy viscosity approach (default)
  • Peclet Number
  • Smagorinski Method
    • Exx ratio
    • Eyx ratio
    • TBFACTS
    • TBMINFS
    • Peclet Number
    • Minimum velocity

Weather

File:RM2 MC Weather.jpg
RMA2 Model Control dialog showing the Weather tab

Wind

According to the RMA2 model documentation, "Because of lack of experience in using storms in a simulation, this feature remains experimental."

See the "Simulating With Storms" section and BWC Card description in the RMA2 model documentation for more information.

  • Method for wind
    • Do not use wind
    • Original RMA2 Formula
    • Van Dorn Formula
    • Wu Formula
    • Safaie Formula
    • Ekma Formula
    • Generic Formula
  • A
  • exp
  • C
  • rho
  • Specify global wind
    • Define – Opens the Wind Values dialog.
File:RMA2 Wind Values.jpg
Wind Values dialog

Rainfall/Evaporation / RA Card

See the "Adding Rainfall And Evaporation" section and RA Card description in the RMA2 model documentation [1] for more information.

Related Topics