SMS:BOUSS-2D Simulations: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(56 intermediate revisions by the same user not shown)
Line 1: Line 1:
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.
[[File:BOUSSsimulation.png|thumb|300 px|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:
To create a new simulation:
# Right click on empty space in the project explorer and select “New Simulation→BOUSS-2D”
# Right-click on empty space in the Project Explorer and select ''New Simulation'' | '''BOUSS-2D'''. A new tree item [[File:BOUSS2D Folder Icon.svg|16 px]] will appear.
# Drag and drop bouss2d grid, wave maker/damping/porosity coverages under the newly created “Simulation” tree item.
# Drag and drop simulation components under the newly created simulation tree item [[File:BOUSS2D Simulation Icon.svg|16 px]]. Components available include:
A New tree item will appear
#* 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:
* [[SMS:Cartesian Grid Module|Cartesian Grid]] (created from the [[SMS:Model Specific Coverages|BOUSS-2D coverage]])
* [[SMS:BOUSS-2D_Using_the_Model#Damping_.2F_Porosity_coverage|Damping Coverage]]
* [[SMS:BOUSS-2D_Using_the_Model#Damping_.2F_Porosity_coverage|Porosity Coverage]]
* [[SMS:BOUSS-2D_Using_the_Model#Wave_Maker_coverage|Wave Maker Coverage]]
Each component can be added to the simulation by selecting the component and dragging it under the simulation item [[File:BOUSS2D Simulation Icon.svg|16 px]] in the Project Explorer. Linked 2D grid [[File:Grid Link.svg|16 px]] and coverages [[File:Coverage Link.svg|16 px]] will be displayed under the simulation.


==Menu Commands==
==Menu Commands==
Right clicking on the simulation tree item will display a list of menu commands and dialogs that are available. These items are:
Right-clicking on the simulation tree item [[File:BOUSS2D Simulation Icon.svg|16 px]] will display a list of menu commands and dialogs that are available. These items are:


*Generating Arcs along land boundary
*'''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
*'''Generating Arcs along open boundary''' – Opens a dialog that will create arcs in a damping or porosity coverage from an existing grid or scatterset.
These options open a dialog that will create arcs in a damping or porosity coverage from an existing grid or scatterset.
*[[SMS:BOUSS-2D Calculators|'''Calculators''']]
*Calculators ( link to Calculators)
*[[SMS:BOUSS-2D Probes|'''Probe Manager''']]
*Spectral Energy
*[[SMS:BOUSS-2D Model Control|'''Model Control''']]
*Probe Manager ( link to Probes)
* [[SMS:Model Checker|'''Model Check''']] – The model check will warn of potential errors that should be considered for fixing before running the model.
*Model Control
* '''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 user can instruct BOUSS-2D 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.
The simulation right-click menu also has [[SMS:Simulations#Simulation_Menu|general simulation commands]].
 
See [[SMS:BOUSS-2D Graphical Interface|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
*Steady-state/single value spatially varied datasets
Line 34: Line 55:
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 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.
The output options are located in the [[SMS:BOUSS-2D Model Control|''Model Control'']].


* Model Check – The model check will warn you of potential errors that you should consider fixing before running the model.
==Related Topics==
* Exporting – When the Bouss2d 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 your simulation. In this directory you will find the .par file(link to Parameter file)
* [[SMS:BOUSS-2D|BOUSS-2D]]
* Running the model




{{Navbox SMS}}
{{Navbox SMS}}
[[Category:BOUSS-2D|Simulation]]
[[Category:SMS Simulations|BOUSS]]

Latest revision as of 21:24, 16 June 2020

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