SMS:CMS-Wave Graphical Interface

From XMS Wiki
Jump to navigationJump to search

CMS-wave makes use of simulations starting in SMS 13.2 and later. Simulations are useful as multiple simulations can be used in the same project.

Simulations for CMS-Wave are created by right-clicking in the Project Explorer and selecting New Simulation | CMS-Wave. The simulation will appear in the Project Explorer under the "Simulation Data" item.

Right-clicking on the simulation gives access to the CMS-Wave menus, including access to the CMS-Wave Model Control dialog. Each CMS-Wave simulation can have its own parameters based on what is entered into the Model Control. Each simulation can share the same components or use different components or any combination of shared and different components.

CMS-Wave Components

Components for CMS-Wave usually include:

  • A Cartesian grid
  • A observation cells coverage
  • A nesting points coverage
  • A structures coverage

A simulation cannot include multiple coverages of the same type. So if building multiple boundary condition coverages, only one of the boundary condition coverages can be included in the simulation. Coverages can be merged if needed.

Linking Components

After a simulation has been created, components may be added to the simulation. Components are usually added by clicking on the component item in the Project Explorer and dragging the item under the CMS-Wave simulation. A link (Coverage Link.svg or Quadtree Link.svg) is then created between the component and the simulation. If the component is updated, it is updated automatically in all simulations that are linked to it.

Components can also be added to a simulation by right-clicking on the component in the Project Explorer and selecting the simulation name in the Link To submenu. Simularly, components can be unlinked from a simualtion by right-clicking on the component and selecting the simulation name in the Unlink From submenu. The Link To and Unlink From submenus become available once a simulation has been created.

CMS-Wave Model Check

Whenever the using the Model Check command, and just before launching an analysis, SMS performs a check on the model. If conditions are detected that are out of the ordinary or recommended range, warnings are given with suggestions to correct the problem. If serious problems are detected, errors are reported, again with suggestions.

These checks include:

  • All water boundaries have boundary conditions specified.
  • Cell aspect ratio is no greater than 2.
  • Max time step size is suggested according to an internal calculation made within SMS.
  • Make sure model control has been set up correctly.
  • Ensure that CMS-Wave has been set up to output the specific data for any existing observation station and that observation stations exist for any specified output data. Observation is not required to run CMS-Wave so this is a reminder that something may have been intended but forgotten.
  • Ensure that no invalid hard bottom specifications exist in the grid. An invalid specification may be created, for example, by setting an infeasible hard bottom scalar value in the Edit Window or adjusted the grid's geometry without updating the hard bottom.

The model check is not all inclusive. Just because a model passes the model check does not guarantee the model will run and produce viable solutions.

Running a CMS-Wave Simulation

After all components have been added to the simulation and the model parameters have been established, the simulation can be run. This is done by right-clicking on the simulation and choosing the Run Simulation command or the Save Project, Simulation and Run command.

The Simulation Run Queue will appear. See Simulation Run Queue for more information.

Map Coverages

SMS contains specific coverages for use with CMS-Wave. This coverages include:

  • Observation cells – Points created on this coverage will define observation cells for the simulation. The feature points will be used for collecting observation data during the simulation run if the coverage is included in a simulation. The observation results will be placed on a spectral coverage where the results can be viewed in the Spectral Energy dialog for each observation point.
  • Nesting points – Points created on this coverage will define nesting points for the simulation. Nesting points operate similar to observation points with results being placed on a spectral coverage.
  • Structures – Contains options for defining structure modifications. Right-clicking on the coverage and selecting the Structure List and Properties command will open a dialog where structures can be defined. The Structure List and Properties dialog allows the following structures to be defined:
Type Modficiation Type
Unassigned none
Bathymetry modification Depth
Floating breakwater Draft
Highly permeable Porous layer thickness
Semi-permeable Porous layer thickness
Rubble-mound Elevation
Wall breakwater Elevation
Wave runup Elevation

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.

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