SMS:3D Bridge: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOINDEX__
{{SMS Deprecated Feature}}
{{Version SMS 13.1}}
[[File:3dbridge.png|thumb|400 px|3D bridge example]]
[[File:3dbridge.png|thumb|400 px|3D bridge example]]
The 3D bridge component can be used to for multiple purposes in a model. These include:
The 3D bridge component can be used to for multiple purposes in a model. These include:
# The bridge component can be used to generate a 3D UGrid to visualize a bridge in the graphics window. Use the '''Export 3D Bridge''' button in the ''Bridge'' dialog described below to generate this UGrid.
# The bridge component can be used to generate a 3D UGrid to visualize a bridge in the graphics window. Use the '''Add 3D Bridge UGrid to SMS on OK''' toggle in the ''Bridge'' dialog described below to generate this UGrid.
# The bridge component can be included in an observation plot. (See [[SMS:Observation_Profile_Plot|Observation Profile Plot]] for more information.)
# The bridge component can be included in an observation plot. (See [[SMS:Observation_Profile_Plot|Observation Profile Plot]] for more information.)
# One or more bridge components can be used to generate a "ceiling elevation" dataset. This dataset represents the maximum water surface that can be reached at each point in the mesh. Nodes that have no ceiling elevation have an "inactive" value in this dataset. An upcoming version of SRH-2D will be able to utilize this dataset instead as an option to represent pressure zones.
# One or more bridge components can be used to generate a "ceiling elevation" dataset. This dataset represents the maximum water surface that can be reached at each point in the mesh. Nodes that have no ceiling elevation have an "inactive" value in this dataset. An upcoming version of SRH-2D will be able to utilize this dataset instead as an option to represent pressure zones. Each bridge also has a user specified Manning's N value for the underside of the bridge. '''Note:''' The ceiling elevation method of simulating pressure flow in SRH-2D is not compatible with pressure zone arcs in the simulation boundary conditions coverage. Only one of these approaches can be applied to a simulation.


To create a 3D bridge component, the following is needed:
To create a 3D bridge component, the following is needed:
* Area Property coverage containing two arcs.  These arcs define the upstream and downstream sides of the bridge
* 3D bridge coverage containing two arcs.  These arcs define the upstream and downstream sides of the bridge
* Top, upstream, and downstream profiles
* Top, upstream, and downstream profiles
Also, having an existing mesh, scatter set, or grid of the site is typically helpful.
Also, having an existing mesh, scatter set, or grid of the site is typically helpful.
Line 15: Line 14:
To build a 3D bridge, do the following:
To build a 3D bridge, do the following:
# Create an 3D bridge coverage.
# Create an 3D bridge coverage.
# Create arcs representing the upstream and downstream side of the bridge location.
# Create two arcs representing the upstream and downstream side of the bridge location.
# Right-click on the 3D bridge coverage and select '''Edit Bridge'''.
# Right-click on the 3D bridge coverage and select '''Edit Bridge'''.
# In the ''Bridge'' dialog, define the top profile, upstream profile, and downstream profile.
# In the ''Bridge'' dialog, define the top profile, upstream profile, and downstream profile.
# Export the 3D bridge and save out the XMUGRID file.
<!--# Export the 3D bridge and save out the XMUGRID file.
# Import the XMUGRID file.
# Import the XMUGRID file.-->
 
'''''Note:''''' CAD files of the bridge design or as built configuration can be used to simplify the bridge definition. Having a topographic surface to display (2D mesh, UGrid, scatter set, grid or raster) in conjunction with the bridge is also typically very helpful.


==3D Bridge Modeling Tips==
==3D Bridge Modeling Tips==
* The first arc drawn on the Area Properties coverage will be made the upstream arc by default. Use the '''Swap Arcs''' button in the ''Bridge'' dialog to change this.
* The first arc drawn on the 3D Bridge coverage will be made the upstream arc by default. Use the '''Swap Arcs''' button in the ''Bridge'' dialog to change this.
* The bridge will use the same units as set in the project's projection.
* The bridge will use the same units as set in the project's projection.
* Multiple bridges can be modeled by creating addition components.
* Multiple bridges can be modeled by creating addition components.
* When exporting the bridge, the XMUGRID file is created as well as a PRJ file containing the bridge's projection. These files should be kept together.
* When exporting the bridge, the XMUGRID file is created as well as a PRJ file containing the bridge's projection. These files should be kept together.
* When modeling piers, the stations cannot be at the same x location. This means the stations must be offset slightly for the vertical wall of the pier.
* Piers modeled using a 3D bridge should not be used to model piers in an SRH-2D pressure flow model. Piers for pressure flow in an SRH-2D should be modeled by creating a void in the mesh at the pier location.


==Bridge Component==
==3D Bridge Coverage==
A new bridge component is created by right-clicking in the Project Explorer and select ''New General Component'' | '''Bridge'''. In the Project Explorer, a "Component Data" folder and a "Bridge" component item will appear.
The 3D Bridge coverage is used like any other map coverage. Generally, it should have the arcs that define the upstream and downstream side of each bridge. In the Project Explorer, right-clicking on the 3D bridge coverage brings up the standard coverage right-click menu with the addition of the following command:
 
The "Component Data" folder will contain all components in the project. Right-clicking on this item has the following commands:
*'''Turn on Visibility of All Components'''
*'''Turn off Visibility of All Components'''
*'''Delete All''' &ndash; Removes all components listed under the folder.
 
The "Bridge" component item can be right-clicked on to access the following commands:
*'''Rename''' &ndash; Change the name of the component.
*'''Duplicate''' &ndash; Creates a copy of the component including an properties that may have been set.
*'''Delete''' &ndash; Removes the component.
*'''Lock''' &ndash; Prevents the component from being edited.
*'''Edit Bridge''' &ndash; Brings up the ''Bridge'' dialog for defining the bridge profiles.
*'''Edit Bridge''' &ndash; Brings up the ''Bridge'' dialog for defining the bridge profiles.
*'''Properties''' &ndash; Opens the ''Properties'' dialog for the component.


==Bridge Dialog==
==Bridge Dialog==
[[File:3d-bridge_dialog.png|thumb|300 px|The ''Bridge'' dialog]]
The ''Bridge'' dialog is reached by right-clicking on a bridge component and selecting the '''Edit Bridge...''' command. The dialog contains the following options:
*'''Swap Arcs''' &ndash; Changes which arc is the upstream arc and which is the downstream arc.
*''Bridge ceiling manning roughness coefficient'' &ndash; Define a Manning's N or roughness value for the bridge if used in a model run. In particular, this option is for use of a 3D bridge that is included in an SRh-2D pressure ceiling model.
*''Add 3D Bridge UGrid to SMS on OK'' &ndash; Exports the 3D UGrid file containing the 3D bridge then imports the bridge UGrid into the SMS project.
*'''Export 3D Bridge''' &ndash; Brings up a ''Save'' dialog where the bridge can be saved as a ugrid.
*''Top profile'' &ndash; Defines the highest points of the bridge.
**'''Edit...''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
*''Upstream Profile'' &ndash; Defines the elevations on the underside of the bridge on the upstream end side.
**'''Edit...''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
*''Specify downstream profile'' &ndash; The downstream profile will be the same as the upstream profile unless this option is turned on.
**''Downstream profile'' &ndash; Defines the elevations on the underside of the bridge on the downstream end side.
***'''Edit...''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
<!--
[[File:3dbridgedialog.png|thumb|300 px|The ''Bridge'' dialog]]
[[File:3dbridgedialog.png|thumb|300 px|The ''Bridge'' dialog]]
The ''Bridge'' dialog is reached by right-clicking on a bridge component and selecting the '''Edit Bridge''' command. The dialog contains the following options:
The ''Bridge'' dialog is reached by right-clicking on a bridge component and selecting the '''Edit Bridge''' command. The dialog contains the following options:
Line 53: Line 58:
**'''Edit''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
**'''Edit''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
*''Downstream Profile'' &ndash; Defines the elevations on the underside of the bridge on the downstream end side.
*''Downstream Profile'' &ndash; Defines the elevations on the underside of the bridge on the downstream end side.
**'''Edit''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.
**'''Edit''' &ndash; Launches the ''XY Series Editor'' for the bridge profiles.-->
===XY Series Editor===
===XY Series Editor===
This dialog is reached through the ''Bridge'' dialog. The dialog contains the following:
This dialog is reached through the ''Bridge'' dialog. The dialog contains the following:

Latest revision as of 19:47, 6 October 2023

3D bridge example

The 3D bridge component can be used to for multiple purposes in a model. These include:

  1. The bridge component can be used to generate a 3D UGrid to visualize a bridge in the graphics window. Use the Add 3D Bridge UGrid to SMS on OK toggle in the Bridge dialog described below to generate this UGrid.
  2. The bridge component can be included in an observation plot. (See Observation Profile Plot for more information.)
  3. One or more bridge components can be used to generate a "ceiling elevation" dataset. This dataset represents the maximum water surface that can be reached at each point in the mesh. Nodes that have no ceiling elevation have an "inactive" value in this dataset. An upcoming version of SRH-2D will be able to utilize this dataset instead as an option to represent pressure zones. Each bridge also has a user specified Manning's N value for the underside of the bridge. Note: The ceiling elevation method of simulating pressure flow in SRH-2D is not compatible with pressure zone arcs in the simulation boundary conditions coverage. Only one of these approaches can be applied to a simulation.

To create a 3D bridge component, the following is needed:

  • 3D bridge coverage containing two arcs. These arcs define the upstream and downstream sides of the bridge
  • Top, upstream, and downstream profiles

Also, having an existing mesh, scatter set, or grid of the site is typically helpful.

Steps to Defining a 3D Bridge

To build a 3D bridge, do the following:

  1. Create an 3D bridge coverage.
  2. Create two arcs representing the upstream and downstream side of the bridge location.
  3. Right-click on the 3D bridge coverage and select Edit Bridge.
  4. In the Bridge dialog, define the top profile, upstream profile, and downstream profile.

Note: CAD files of the bridge design or as built configuration can be used to simplify the bridge definition. Having a topographic surface to display (2D mesh, UGrid, scatter set, grid or raster) in conjunction with the bridge is also typically very helpful.

3D Bridge Modeling Tips

  • The first arc drawn on the 3D Bridge coverage will be made the upstream arc by default. Use the Swap Arcs button in the Bridge dialog to change this.
  • The bridge will use the same units as set in the project's projection.
  • Multiple bridges can be modeled by creating addition components.
  • When exporting the bridge, the XMUGRID file is created as well as a PRJ file containing the bridge's projection. These files should be kept together.
  • When modeling piers, the stations cannot be at the same x location. This means the stations must be offset slightly for the vertical wall of the pier.
  • Piers modeled using a 3D bridge should not be used to model piers in an SRH-2D pressure flow model. Piers for pressure flow in an SRH-2D should be modeled by creating a void in the mesh at the pier location.

3D Bridge Coverage

The 3D Bridge coverage is used like any other map coverage. Generally, it should have the arcs that define the upstream and downstream side of each bridge. In the Project Explorer, right-clicking on the 3D bridge coverage brings up the standard coverage right-click menu with the addition of the following command:

  • Edit Bridge – Brings up the Bridge dialog for defining the bridge profiles.

Bridge Dialog

The Bridge dialog

The Bridge dialog is reached by right-clicking on a bridge component and selecting the Edit Bridge... command. The dialog contains the following options:

  • Swap Arcs – Changes which arc is the upstream arc and which is the downstream arc.
  • Bridge ceiling manning roughness coefficient – Define a Manning's N or roughness value for the bridge if used in a model run. In particular, this option is for use of a 3D bridge that is included in an SRh-2D pressure ceiling model.
  • Add 3D Bridge UGrid to SMS on OK – Exports the 3D UGrid file containing the 3D bridge then imports the bridge UGrid into the SMS project.
  • Export 3D Bridge – Brings up a Save dialog where the bridge can be saved as a ugrid.
  • Top profile – Defines the highest points of the bridge.
    • Edit... – Launches the XY Series Editor for the bridge profiles.
  • Upstream Profile – Defines the elevations on the underside of the bridge on the upstream end side.
    • Edit... – Launches the XY Series Editor for the bridge profiles.
  • Specify downstream profile – The downstream profile will be the same as the upstream profile unless this option is turned on.
    • Downstream profile – Defines the elevations on the underside of the bridge on the downstream end side.
      • Edit... – Launches the XY Series Editor for the bridge profiles.

XY Series Editor

This dialog is reached through the Bridge dialog. The dialog contains the following:

  • Number of Rows – Defines the number of rows available in the spreadsheet.
  • Spreadsheet – Contains values for the profile distance and elevation.
    • Distance – Location along the arc. The distance starts at the first node in the arc and moves in the same direction as the arc.
    • Elevation – Elevation of the given distance.
  • Preview area – Displays a preview of the profile.
Example of the bridge XY Series Editor