SMS:BOUSS-2D Simulations

From XMS Wiki
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 options and dialogs.

To create a new simulation:

  1. Right-click on empty space in the Project Explorer and select New Simulation | BOUSS-2D. A new tree item BOUSS2D Folder Icon.svg will appear.
  2. Drag and drop simulation components under the newly created simulation tree item BOUSS2D Simulation Icon.svg. Components available include:
    • 2D grid
    • wave maker coverage
    • damping coverage
    • porosity coverage

Multiple BOUSS-2D simulations can be included in a single project.

Simulation Components

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

Each component can be added to the simulation by selecting the component and dragging it under the simulation item BOUSS2D Simulation Icon.svg in the Project Explorer. Linked 2D grid Grid Link.svg and coverages Coverage Link.svg will be displayed under the simulation.

Menu Commands

Right-clicking on the simulation tree item BOUSS2D Simulation Icon.svg 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