SMS:BOUSS Runup / Overtopping

From XMS Wiki
Jump to navigationJump to search


BOUSS Runup / Overtopping model can used to in the design of coastal structures. The model runs a simulation based on user-specified parameters.

Simulations are available in BOUSS-2D Runup / Overtopping starting in SMS 11.2.

To create a new simulation:

  • Right-click on empty space in the project explorer and select New Simulation | Bouss Runup/Overtopping.
  • The New Runup/Overtopping Simulation dialog will appear. Select the coverages to be created in this dialog and give each coverage the desired name. Click OK.

A new tree item for the simulation will appear in the project explorer. Also, all coverages will be created that were selectect in the New Runup/Overtopping Simulation dialog will appear under the "Map Data" item. Coverages can be added to the simulation by selecting the coverage and dragging it under the simulation item in the project explorer.

File:New Runup.jpg
BOUSS2D Runup/Overtopping New Runup/Overtopping Simulation dialog

Simulation Menu

Right-clicking on the simulation item in the project explorer will bring up the simulation menu.

  • Delete – standard menu command to remove the simulation.
  • Duplicate – standard menu command create a copy of the simulation.
  • Rename – standard menu command to give the simulation a different name.
  • Model Control – this command launches the Runup/Overtopping Model Control dialog.
  • View Transect Profile – this will bring up the Transect Profile.
  • Export Runup/overtopping files – initiates creating and saving all BOUSS2D Run / Overtopping files necessary to run the model. Files will be saved in the project folder.
  • Launch Runup/overtopping – starts the BOUSS-2D model. A model wrapper should appear that shows the model run as it happens. Clicking the Abort button will end the model run early. Once the model run is complete, the Exit button can be selected.
  • Save project, export, and launch Runup/overtopping
  • Statistics – the Statistics dialog will open showing the values being used.

Coverage Menus

The right-click menus for Runup/Overtopping coverages are fairly standard. For each coverage (damping, probes, roughness, transects, and wave maker) there are the following options in the right-click menu:

  • Delete – standard menu command to remove the coverage.
  • Duplicate – standard menu command create a copy of the coverage.
  • Rename – standard menu command to give the coverage a different name.
  • Projection – Opens an Object Projection dialog.
  • Metadata – Opens the Metadata dialog.
  • Zoom to Coverage – will fit any feature objects associated with the coverage into the graphics window. This command will proportionally resize and center the objects associated with the coverage so they all fit in the graphics window viewing space.
  • Type – a sub-menu that allows seeing the current coverage type and changing the coverage type if necessary. The Runup/Overtopping model only uses the damping, probes, roughness, transects, and wave maker coverages and will not make use of other coverage types.

Probes

The probes coverage has an addition command option in the right-click menu.

Transects

The transects coverage has an addition command option in the right-click menu.

  • Extract Elevations – launches the Interpolation dialog.

Runup / Overtopping Coverages

The data from various coverages in SMS is combined to create a BOUSS-2D Run-up / Overtopping simulation. By clicking on the coverage in the project explorer and dragging the item under the Runup/Overtopping simulation item in the project explorer, the coverages become linked to the simulation. The different coverages are as follows:

Transects Coverage

Transects are made by creating arcs in the transects coverage. Each transect represents the 1-d grid used for a run-up simulation. It is recommended that these transects be linear. To assign elevations to the transects, use the right-click option: Extract elevations. This will prompt the user to select a dataset to use for extracting. This must be done before launching a runup simulation.

Wavemaker Coverage

Wavemakers are made by creating arcs in this coverage. The wave maker properties can be edited by double-clicking on the arc or by right-clicking and selecting Attributes. Each wavemaker can have multiple sets of wave parameters. Each set of wave parameters will be run in a separate simulation. It is necessary that each wavemaker arc in a simulation has the same number of wave parameters. The location of the wave makers on the transect is determined by the intersection of the transect arc and the wavemaker arc. Each transect arc may have only one wavemaker.

Probes Coverage

File:RunupProbeRules.jpg
BOUSS-2D Runup/Overtopping Probe Rules dialog.

Probes are also made by creating arcs. The location of each probe on the transect is determined by the intersection of the transect arc and the probe arc. In the arc attributes, a user can set the type of probe, which can be any of the following: Velocity, Pressure, Water Surface Elevation and Force. To create a run-up probe, simply create a polygon in the desired location. The run-up probe will be the portion of the transect arc that is inside of the polygon.

Auto-Create Probes

The Properties dialog for the probes coverage can be used to automatically create probes.

Runup Probes

To automatically create a runup probe, define the following variables:

  • Minumum z – probes will not be created below this elevation
  • Maximum z – probes will not be created above this elevation
  • Delta z – the difference in elevation that must occur for a probe to be created

When auto-creating these probes, SMS will traverse the transect arc, starting from the land and going seaward. Once a local maximum that is below "maximum z" is found, this point will be the starting point of the probe. SMS continues to traverse the arc until it reaches a point that is a distance of "delta z" below the starting point. This point will be the end point. However, if SMS reaches another local maximum with a higher elevation than the starting point, this point with the higher elevation will replace the original starting point.

Other Probes

To automatically create other types of probes, it's necessary to set the following parameters:

  • Elevation (m) – this is the elevation (along the transect) at which the probe should be placed
  • Location – this can be set to "First" or "Last". This is used only when the defined elevation occurs more than once on the transect arc. If "First" is selected, the probe will be placed at the first qualifying location on the transect arc. If "Last" is selected, the probe will be placed at the last location.
  • Probe Types – the available probe types are flowrate, WSE, force, pressure, and velocity. A user can set which type(s) should be created for this rule. For pressure and velocity, define elevation(s) above the seabed where they should be placed. These can be entered by clicking the "Define..." button next to their checkboxes.

Damping / Porosity Coverage

Damping and porosity attributes are created by making arcs. The type of attribute (damping or porosity) and its coefficient and width are set in the arc properties.

Roughness Coverage

If there is varying roughness throughout a transect arc, roughness polygons can be used to define the varying roughness. Each polygon that is created will be assigned a Chezy roughness value (set in the polygon attributes). The portion of the transect arc that is inside of the polygon will be assigned that value. Otherwise, the default Chezy coefficient (defined in the model control), will be used. Note: It is helpful to turn on the display of inactive coverages while creating the wavemakers, probes, damping arcs, porosity arcs, and roughness polygons. This enables the user to see the location of the transect arcs to ensure that they are intersecting the wavemakers, probes, etc., in the desired locations.

Runup / Overtopping Model Control

File:Runup MC.jpg
BOUSS2D Runup / Overtopping Model Control dialog

The BOUSS2D Runup / Overtopping Model Control dialog is accessed by right-clicking on the Runup/Overtopping simulation and selecting the Model Control command. The dialog allows setting the following parameters:

  • Project Title – Enter the title of the project in this field. The title is used for the folder name where the output files will be stored.
  • Input Datasets – These inputs specify spatially varied input parameters for the model. In addition to the bathymetry, BOUSS-2D can utilize spatially varied damping, porosity and currents. In this section, the user defines whether these inputs are used (“None” is selected if not), and if so, how they are defined.
  • Damping – specified using boundary conditions on cell strings or selected from the scalar functions.
  • Porosity – specified using boundary conditions on cell strings or selected from the scalar functions.
  • Current – selected from the available vector functions.
  • Time Control – The interface displays the recommended values for Duration and Time step in parentheses.
  • Duration – enter the model run duration.
  • Time Step – enter the number of time steps for the model run duration.
  • Grid Information – This section displays the attributes of the active grid.
  • Cell Size – specifies the size of cells the model run will use.
  • Porosity Friction Factors
  • Turbulent – value ranges from 0.0 to 3.6 with a default value of 2.4.
  • Laminar – value ranges from 0 to 1500 with a default value of 800.
  • Store Size – represents the characteristic stone size (d50) in meters of the breakwater armor layer and must be greater than zero.
  • Added Mass Coeff.
  • Parameters
    • Roughness Type
    • Smagorinsky Number
    • Enable Wave Runup
      • Min. Flodding Depth
    • Enable Wave Breaking
      • Turbulent Length Scale
    • Nonlinear Option
  • Output Options
  • Overide Default File Prefix – allows the user to specify a file name for these solution files. The default file prefix is the filename of the *.par file.
  • File Prefix – becomes active once the Overide Default File Prefix is toggled on. A new prefix may be entered when active.
  • Time Independent
  • Output Significant Wave Height
  • Output Mean Currents
  • Output Mean Direction (Theta)
  • Output Mean Water Level
  • Output Max Inundation Water Level
  • Output Format – gives options to output in an "XMDF" file, a "BOUSS-2D Native" file, or "Both".
  • Animation Output
  • Output WSE – tells the model to output time varying datasets.
  • Output Velocity – tells the model to output time varying datasets.
    • Number of Frames
    • Required Memory
  • Override Defaults – Enables the Begin Output, End Output, and Step controls.
    • Begin Output – must be greater than 0.0 and less than the run duration.
    • End Output– must be greater than 0.0 and less than the run duration.
    • Step – determines how often the model will save time-varying output.

Related Topics