SMS:CMS-Wave Model Control

From XMS Wiki
Revision as of 15:41, 16 August 2022 by Jcreer (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

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:

Parameters

The Parameters tab of the CMS-Wave Model Control dialog

The Parameters tab of the CMS-Wave Model Control dialog contains the following options:

  • CMSWAVE plane mode – Select the plane mode for the project.
      • "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 generation on all four boundaries.
      • "Full plane with input reverse spectra" – This option allows spectral input to be used on two opposite boundaries.
  • Source terms – This option is used to generate waves using wind input.
    • "Source terms and propagation" – Uses wind input if provided.
    • "Propagation only" – Neglects wind input in calculation.
  • Current interaction – Option to define currents for the simulation.
    • "None" – No current interaction will be in the simulation.
    • "Use dataset" – A vector dataset can be used to define the currents for the simulation. Click Select to select from the dataset options in a dialog.
  • Current interaction – Option to define currents for the simulation.
    • "None" – No current interaction will be in the simulation.
    • "Use dataset" – A vector dataset can be used to define the currents for the simulation.
  • Bottom friction – This option allows defining friction for the ocean bottom.
    • "None" – No bottom friction is applied to the simulation.
    • "Darcy-Weisbach constant" – Set a constant value to use the Darcy-Weisbach method for bottom friction.
    • "Darcy-Weisbach dataset" – Select a dataset in the project to use the Darcy-Weisbach method for bottom friction.
    • "Manning constant" – Set a constant value to use as the Manning's n value.
    • "Manning dataset" – Select a dataset in the project to use the Darcy-Weisbach method for bottom friction.
  • Surge fields – Option to set surge field values.
    • "None" – No surge field values will be used in the simulation.
    • "Constant Value" – Set a constant value for surge fields used in the simulation.
    • "Use dataset" – Select a dataset in the project to define surge fields in the simulation.
  • Wind fields – This option requires the Source terms be set to use "Source terms and propagation".
    • "Constant value" – Use a constant value for wind fields included in the simulation.
    • "Use dataset" – Use a dataset in the project to define wind fields in the simulation.
    • Limit wave inflation for wind >= 50 m/sec – When turned on, the wave inflation for wind will be limited.
  • Matrix Solver – Select the matrix solver used in the simulation.
    • "Gauss-Seidel" – Sets matrix solver to Gauss-Seidel solver with multi-processor capability.
      • Number of threads – Set number of threads to use with the multi-processor.
    • "ADI" – Sets matrix solver to Alternative Direction Iterative solver.

Boundary Control

The Boundary control tab contains options for assigning spectral data for the model run.

  • Source – Select the source for the external boundary conditions
    • "Spectral Coverage" – Uses the spectral coverage in the simulation for all boundary conditions.
    • "None" – Requires that energy spectra be entered.
  • Interpolation Type – Sets the interpolation method to use when interpolating between spectra.
      • "Average spectra" – Interpolation will use averaged spectra values.
      • "IDW interpolation" – Sets the type of data interpolation to Inverse Distance Weighting.
  • Computational Spectral Grid – Adjust and view data related to the computational spectral grid.
    • Frequency Distribution – Adjust the Frequency Distribution settings for the computational spectral grid.
      • Number – Adjust the number of frequency bands.
      • Delta – Adjust the step size in Hz.
      • Minimum – Adjust the minimum frequency in Hz.
    • Angle Distribution – View the Angle Distribution settings for the computational spectral grid.
      • Number – View the number of angle bands.
      • Delta – View the step size in degrees.
      • Minimum – View the minimum angle in degrees.
  • Sides – Specified when using a spectral coverage source. The types of boundary conditions include:
    • "Specified spectrum" – Click Select to the right to open a dialog box to assign the spectral coverage to the boundary.
    • "Zero spectrum" – The boundary doesn't have any spectral energy applied.
    • "Open lateral boundary" –
  • Case data – Defines the time step or cases that will be used and the input boundary conditions for each.
    • Wind direction angle convention – Set the convention for the wind direction field for the model.
      • "Cartesian" – The direction FROM. The origin (0.0) indicates the direction is coming from North. It increases clockwise from North (viewed from above). This is most commonly used for wind direction.
      • "Meterologic" – The direction TO. The origin (0.0) indicates the direction is going to the North. It increases clockwise (like a bearing) so 45 degrees indicates a direction heading towards the North East.
      • "Oceanographic" – The Cartesian coordinate axes as a direction TO. East, or the positive X axis, defines the zero direction. It increases in a counter clockwise direction or righthand rule. 45 degrees indicates a direction heading to the North East and 90 degrees indicates a direction heading to the North.
      • "Shore normal" – "TO" convention based on a Theta(grid) which defines the grid orientation relative to the positive X axis (CCW direction).
    • Populate from Spectra – Click the Populate button to auto-generate case data in the table below. Data is based on the imported spectral data in the spectral coverage.
    • Set Reference Time – Click this button to open the CMS-Wave Simulation Reference Time dialog and adjust the reference time and time units.
      • Reference time – Set the desired Reference time for the simulation.
      • Time units – Sets time units for case data to "days", "hours", or "minutes".
    • Add Row GMS MODFLOW 6 - Add Row button.png – Add a row to the case data table.
    • Delete Row GMS MODFLOW 6 - Delete Rows button.png – Removes a selected row from the case data table.
    • Time – The time offset value representing how much later the time is than the specified reference time. Hence, if 5 is entered for the time offset, and the time units is hours, then it is the case of 5 hours later. When nesting is used, the case ids, and the number of cases, will be determined by the parent simulation.
    • Wind Direction – Available if "Constant value" has been selected on the Parameters" tab.
    • Wind Magnitude – Available if "Constant value" has been selected on the Parameters" tab.
    • Water Level – Available if "Constant value" has been selected on the Parameters" tab.


Output Control

The Output control tab contains additional options for outputting results from the CMS-Wave model run.

  • Limit observation output – When checked on, turns off all output for observation cells except information in SELHT file.
  • Radiation Stresses – Turns on wave radiation stresses calculations for the simulation. Generates a wave radiation stress file with spatially varied data.
  • Breaking type – Option to generate wave breaking data resulting in a wave breaking file with spatially varied data.
    • "None" – Wave breaking file type will not be produced.
    • "Write indices" – Select for output of wave breaking indices.
    • "Calculate energy dissipation" – Select for output of dataset of energy dissipation fluxes.

Options

The Options tab contains the following options:

  • Allow wetting and drying – Allows fluctuation of cells between wet and dry depending on threshold flow depth at the cell center.
  • Infragravity wave effect – Sets the model to include infra-gravity wave effect.
  • Diffraction intensity – Sets the diffraction intensity for the model. Use 0 for no diffraction. Use 4 for strong diffraction.
  • Nonlinear wave effect – Sets the model to include computation for non-linear wave-wave interaction.
  • Run up – Sets the model to include computation for wave runup, which is the maximum shoreward wave swash on the beach face for engineering structures.
  • Fast-mode run – Turn on fast-mode simulation for wave generation and propagation.
  • Roller effects – Sets wave roller intensity factor. Use "None" for no effect. Use "100%" for strong effect.
  • 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.
    • "None" – Forward reflection will not be represented in the model.
    • "Constant" – Forward reflection will be defined by a constant value for the entire simulation.
    • "Use dataset" – Forward reflection will be defined by a scalar dataset with spatially varying data for the simulation. Select appears next to it. This button brings up a data tee that allows for selecting the desired dataset.
  • 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.
    • "None" – Backward reflection will not be represented in the model.
    • "Constant" – Backward reflection will be defined by a constant value for the entire simulation.
    • "Use dataset" – Backward reflection will be defined by a scalar dataset with spatially varying data for the simulation. Select appears next to it. This button brings up a data tee that allows for selecting the desired dataset.
  • Muddy bed – If desired, spatially varying data using a scalar dataset can be used to calculate wave dissipation over muddy bed for the model.
    • "None" – Turns off calculating for wave dissipation over muddy bed.
    • "Use dataset" – Define the scalar dataset to be used to calculate wave dissipation over muddy bed for the model. Select appears next to it. This button brings up a data tee that allows for selecting the desired dataset.
  • Wave breaking formula – Sets the formula for wave breaking used in the simulation.
    • "Extended Goda" – Sets wave breaking formula to "Extended Goda".
    • "Extended Miche" – Sets wave breaking formula to "Extended Miche".
    • "Battjes and Jannsen 1978" – Sets wave breaking formula to "Battjes and Jannsen 1978". For this formula, Gamma value definition is required.
    • "Chawla and Kirby" – Sets wave breaking formula to "Chawla and Kirby".
    • "Battjes and Jannsen 2007" – Sets wave breaking formula to "Battjes and Jannsen 2007".
    • "Miche Original" – Sets wave breaking formula to "Miche Original".
    • "Lifting breaking" – Sets wave breaking formula to "Lifting breaking".
  • Date format – Select the type of date format preferred.
      • "8 digits" – Sets date format to 8 digit format.
      • "12 digits" – Sets date format to 12 digit format.


Related Topics