User:Jcreer/CMS-Wave 13.2

Graphical Interface

The CMS-Wave graphical interface includes tools to assist with creating, editing, and debugging a CMS-Wave model. The CMS-Wave interface exists in the Cartesian Grid Module.

Model Control

The CMS-Wave Model Control dialog is used to setup the options that apply to the simulation as a whole. These options include time controls, run types, output options, global parameters, print options and other global settings.

Running the Model

The CMS-Wave files are written automatically with the SMS project file or can be saved separately using the File | Save CMS-Wave or Save As menu commands. See CMS-Wave Files for more information on the files used for the CMS-Wave run.

CMS-Wave can be launched from SMS using the CMS-Wave | Run CMS-Wave menu command. A check of some of the common problems, called the Model Checker, is done each time the model is launched, or by selecting the CMS-Wave | Model Check menu command.

Visualizing Results

Select the spectral grid as the grid to use in the Spectral Energy dialog. This will open the spectral grid for viewing in the Spectral Energy dialog. Make sure to set the original grid back before leaving the dialog to ensure the model does not change.

CMS-Wave Menu

See CMS-Wave Menu for more information.

Related Topics

• CMS-Wave
• Create a 2D Cartesian grid

Model Control

CMS-Wave Model Control dialog

The Model Control… command in the CMS-Wave Menu opens the CMS-Wave Model Control dialog. This dialog is divided into sections for different types of parameters which are used by the model as it runs. These include:

Input Forcing

• Currents – A vector dataset can be used to define the currents for the simulation
• Water Level – A constant value or a scalar dataset can be used to define the water level for the simulation. If “constant” is selected, the constant value will be defined in the CMS-Wave Case Definition dialog for each case.
• Spectra
  • Plane Type – this option is only used if the Spatially Varied source option is selected.
    • "Half plane" – appropriate for nearshore coastal applications allowing wave input and generation on two boundaries resulting in a faster run-time.
    • "Full plane" – used with enclosed or semi-enclosed bays, estuaries, and lakes where there is no clear “offshore” direction and seas and swells may oppose each other. Allows wave input and geration on all four boundaries.
    • "Full plane with input reverse spectra" – this option allows spectral input to be used on two opposite boundaries.
  • Interpolation Type – sets the method for STWAVE to use when interpolating between spectra.
    • "Average spectra"
    • "IDW interpolation" – Inverse Distance Weighting
  • Spectral Grid
  • Create Nesting Points – if the From parent grid source option is selected and a parent grid has been specified, clicking on this button will allow specifying which points should be used from the parent grid for creating the nesting file.
• Wind – a constant value or a vector dataset can be used to define the wind for the simulation. If constant is selected, the wind direction and magnitude will be specified in the CMS-Wave Case Definition dialog for each case.
• Define Cases

Settings

The settings section is used to specify model input options including:

• Bed friction
• Matrix Solver
  • Gauss-Seidel
  • ADI
• Allow wetting and drying
• Infragravity wave effect
• Diffraction intensity
• Forward reflection – A constant value for the entire simulation or spatially varying data using a scalar dataset can be used to define the forward reflection for the model.
• Backward reflection – A constant value for the entire simulation or spatially varying data using a scalar dataset can be used to define the backward reflection for the model.
• Muddy bed – Spatially varying data using a scalar dataset can be used to define the muddy bed (values??) for the model.
• Non-linear wave effect
• Run up
• Quick mode

Output

This section is used to specify option output from the model. The output includes:

• Radiation stresses
• Sea/Swell
• Wave Breaking

Input Datasets

Here specify the format for SMS to write out the input datasets. They can be written in either ASCII or XMDF format.

Related Topics

• CMS-Wave

Menu

The following menu commands are available in the CMS-Wave Menu:

Assign Cell Attributes

Opens the CMS-Wave Cell Attributes dialog, which specifies the cell type.

Merge Cells

Merge multiple rows or columns into a single row or column.

Model Check…

Check for common problems. If problems are found, the Model Checker dialog will open.

Model Control…

Opens the CMS-Wave Model Control dialog to specify model parameters.

Run CMS-Wave

Launches the CMS-Wave model using the currently loaded simulation. As the model runs, a dialog monitors progress of the model and gives status messages. When the run is complete, the spatial solutions are read in for analysis and visualization.

Obsolete Commands

The following commands are no longer available in the current version of SMS.

Nest Grid

Opens the CMS-Wave Nesting Options dialog, which specifies nesting options.

Spectral Energy

Opens the Spectral Energy dialog to define/view wave energy spectra. Generally, CMS-Wave will generate wave conditions internally, but a spectrum may be input. This command also allows visualizing wave spectra that are generated inside of the model.

Related Topics

• CMS-Wave