SMS:BOUSS-2D Simulations

From XMS Wiki
Revision as of 18:51, 13 April 2016 by Jcreer (talk | contribs)
Jump to navigationJump to search
Example of the project explorer containing a BOUSS-2D simulation.

Simulations are available in BOUSS-2D starting in SMS 11.2. A simulation should contain a BOUSS-2D grid, a wave maker coverage, and optional damping and porosity coverages. Right-clicking on the simulation will display the options and dialogs.

To create a new simulation:

  1. Right-click on empty space in the project explorer and select New Simulation | BOUSS-2D
  2. Drag and drop bouss2d grid, wave maker/damping/porosity coverages under the newly created Simulation tree item.

A new tree item will appear.

Simulation Components

A BOUSS-2D simulation uses the following components in the model run:


Menu Commands

Right-clicking on the simulation tree item will display a list of menu commands and dialogs that are available. These items are:

  • Generating Arcs along land boundary – Opens a dialog that will create arcs in a damping or porosity coverage from an existing grid or scatterset.
  • Generating Arcs along open boundary – Opens a dialog that will create arcs in a damping or porosity coverage from an existing grid or scatterset.
  • Calculators
  • Probe Manager
  • Model Control
  • Model Check – The model check will warn of potential errors that should be considered for fixing before running the model.
  • Export BOUSS-2D – When the BOUSS-2D files are exported a new directory under the project called “BOUSS-2D” is created. In this directory, the grids will be written to. Also a new directory under the “BOUSS-2D” will be created and it will be the name of the simulation. In this directory, the *.par file(link to Parameter file) can be found.
  • Run BOUSS-2D
  • Save Project, Export, and Run BOUSS-2D

The simulation right-click menu also has general simulation commands.

See BOUSS-2D Graphical Interface for more information.

Output Options

BOUSS-2D can be instructed to create a variety of output files. These may include spatially varied data consisting of a value for each cell in the grid, transient data defining time series at a location, or a combination of these two options (multiple time steps of data that includes a value at each cell). The output options, along with the keyword included in the parameter file to enable these options are shown below.

  • Steady-state/single value spatially varied datasets
  • Significant wave height (":HS_FILE")
  • Mean currents (":MEAN_UV_FILE")
  • Mean wave direction (":THETA_FILE")
  • Transient spatially varied datasets. Each output includes data from a specified start time, to a specified end time at a specified time step.
  • Water surface elevations (":SAVE_ETA_ANIMATION")
  • Transient currents (":SAVE_UV_ANIMATION")
  • Time series output at specified cells (probes). BOUSS-2D saves each type of data (for multiple locations) in a single "*.ts1" file.
  • Water surface elevations (":TS_ETA_FILE")
  • Currents (":TS_U_FILE", ":TS_V_FILE") – This saves the current at a specified elevation up from the bed. Multiple elevations can be monitored.
  • Pressure (":TS_PRESSURE_FILE") – This saves the pressure at a specified elevation up from the bed. Multiple elevations can be monitored.
  • Flow rate (":TS_Q_FILE" – This saves the flow crossing a location and can be used for overtopping.

The spatially varied data may be output in to either BOUSS-2D native files or a eXtensible Data Format File (XMDF). If BOUSS-2D format is specified, the model creates "*.grd" files for each of the single value spatially varied outputs and binary data files for the transient data. The ":SOLUTION_FILE_OPTION" in the par file instructs the model to save the data in BOUSS-2D format (if set to 0), XMDF format (if set to 1) or both formats (if set to 2). When the XMDF option is specified, the ":XMDF_SOLUTION_FILE" record must also be in the parameters file along with the name of the XMDF file to store the datasets in.

The output options are located in the Model Control.

Related Topics