SMS:SRH-2D Coverages: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(72 intermediate revisions by 6 users not shown)
Line 1: Line 1:
The SRH-2D model makes use of the simulation based modeling approach.  This requires defining [[SMS:Coverages|coverages]] in the [[SMS:Map Module|Map module]] to build the components for use in the SRH-2D [[SMS:Simulations|simulation]].
The SRH-2D model makes use of the simulation based modeling approach.  This requires defining [[SMS:Coverages|coverages]] in the [[SMS:Map Module|Map module]] to build the components for use in the SRH-2D [[SMS:Simulations|simulation]].
==Boundary Conditions Coverage==
==Boundary Conditions Coverage==
[[File:SRH BC Type Parameters.png|thumb|400 px|Example of the SRH-2D ''BC Type Parameters'' dialog showing sediment transport options]]
==== Mobile Run Type ====
The boundary condition coverage consists of a collection of arcs with specified boundary conditions that control the inflow and outflow in a simulation. The coverage itself has the standard [[SMS:Project_Explorer_Items#Coverage Item Right-Click Menus|coverage item right-click menu commands]] as well as two specific attributes, accessed by right-clicking—the '''HY-8 Options''' and '''BC Types''' commands. These commands are described below.
The "Mobile" option is used to perform a sediment transport simulation. It should be noted that sediment transport simulations require a hotstart or restart file from a corresponding hydraulic simulation. When the "Mobile" option is specified the dialog expands to include sediment transport parameters.  
{{Anchor|Boundary_Conditions_Coverage_Right-Click_Menu}}


=== HY-8 Options ===
The sediment transport options are described in the [[SMS:SRH-2D_Sediment_Transport_Parameters|SRH-2D Sediment Transport Parameters]] article.
The '''HY-8 Options''' command opens the ''Coverage Options'' dialog which allows specifying a link to the location of the HY-8 data file that will be used with this coverage. Only the file name is specified here.  If an existing HY-8 file containing culvert crossing attributes already exists, that fie can be selected. Otherwise, a name is specified which will be used when the culvert crossings are defined for this set of boundary conditions. This is an optional parameter and does not need to be filled in unless an HY-8 crossing will be incorporated into the simulation.


=== BC Types Dialog===
=== Boundary Conditions ===
The ''BC Types'' dialog supports the following run types:
[[File:SRH2D_Assign_BC.PNG|thumb|400 px|The SRH-2D ''Linear BC'' dialog showing a the Inlet-Q option.]]
==== Flow Run Type ====
SRH-2D supports a variety of boundary conditions for hydraulic computation. The boundary conditions for the model are specified through the SRH-2D Boundary Condition coverage by selecting an arc. In SMS 11.2 and earlier versions, a boundary could also be defined by selecting a nodestring in the mesh instead, though this is no longer supported in SMS 12.0 and later versions. Once the arc or nodestring has been selected, double-clicking, or right-clicking and using the '''Assign BC...''' command, will bring up a dialog where the boundaries can be assigned.
The "Flow" option is the default and signifies that the SRH-2D simulation will include only hydrodynamic modeling. If this is the desired type of simulation, this parameter does not need to be changed/set.
The following options are available:
* ''Unsteady Output'' – Can be set to "On" for unsteady flow or "Off" for steady state flow. (This is not recommended.)


==== Mobile Run Type ====
All currently supported boundary types are exterior boundaries that must be placed on the mesh boundary with the exception of a monitor line. Other boundary types include the following: Inlet-Q, Inlet-SC, Exit-EX, Exit-H, Exit-Q, Wall, and Symmetry.
The "Mobile" option is used to perform a sediment transport simulationIt should be noted that sediment transport simulations require a hotstart or restart file from a corresponding hydraulic simulation. When the "Mobile" option is specified the dialog expands to include sediment transport parameters. These include:
BC Types:
=====Sediment Specific Gravity=====
*Inlet-Q is a subcritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. The velocity distribution type may be selected from the boundary condition menu. Inlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
Default value is "2.65".
*Inlet-SC is a supercritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. Inlet-SC also requires information about depth. Within the boundary condition menu, the velocity distribution type may be specifiedInlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
*Exit-EX is a supercritical exit boundary condition.
*Exit-H is a stage type exit boundary where water surface elevation may be given as a constant number or as a stage-discharge or rating curve. Using a constant or rating curve allows accessing the ''Populate'' dialog.
*Exit-Q is an exit boundary with a discharge given as a constant number or as a hydrograph.
*Wall
*Symmetry is defined as a boundary where all dependent variables are extrapolated assuming the gradient of the variable in a direction normal to the boundary is zero except the velocity component normal to the boundary.
*Monitor-Line it is an internal polyline which may be used to monitor the total flow discharge and average water surface elevation.  For a sediment transport simulation, the total sediment discharge, concentration, average bed elevation, and sediment discharges by size fraction are added to this output.
* [[SMS:SRH-2D_Structures#Weir|Weir]] – See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Culvert|Culvert]] – See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Pressure_Flow_Bridge|Pressure zone]] – See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Gate|Gate]] – See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D Structures#Internal Sink|Internal Sink]] – Models a drain or sink inside the model domain.
* [[SMS:SRH-2D Structures#Link|Link]] – Models flow between two separate meshes.
* [[SMS:SRH-2D_Structures#BC Data|BC Data]] – Options for specifying BCDATA lines and flow direction.


=====Particle Diameter Threshold=====
See [[SMS:SRH-2D Boundary Conditions|SRH-2D Boundary Conditions]] for more information on the options for each boundary type.
Represent the bin sizes of the bed material gradations and sediment inflow gradations. Nine representative bin sizes are specified. Typically the bins are defined using the Phi scale. Enter values using the '''Insert Above''' and '''Insert Below''' buttons. Enter values in increasing sizes. The first entered value represents the low end value of the bin. The second entered value represents the high end of the first bin and the low end of the second bin if another value is added.  


A simulation can be specified for only size class (bin) that represents a uniform size class, though several grain sizes are recommended. More size classes significantly increases the simulation time. The pre-processor suggests a limit of seven sizes classes, but the absolute limit is nine. If the cohesive sediment transport modeling is being performed, then the first size class (i.e. smallest sediment size) represents the cohesive size fraction.


The predicted sediment transport rates are sensitive to the number of sediment bins. It is recommended the user perform sensitivity analyses to evaluate the variability of the model output.  Sediment transport calculations within SRH-2D use the geometric mean of each size class. 
[[Category:SMS Boundary Conditions|SRH-2D]]


Note: the maximum number of bin sizes in SRH-2D is nine (ten particle sizes); the more bin sizes, the longer the simulation time.
==Obstructions Coverage==
[[File:SRH2D Assign Obstructions.png|thumb|400 px|The ''SRH-2D Assign Obstruction'' dialog]]
Used to create feature objects that represent obstructions, such as bank protrusions and boulder clusters. Obstructions can be assigned to feature arcs or points.


=====Sediment Transport Capacity Equations for Non-Cohesive Sediment=====
The elevation that is assigned to the point (for point obstructions) or nodes and vertices (for arc (line) obstructions) will be used as the bottom elevation of the obstruction. If the elevation from node to vertex or vertex to vertex along an arc (line) obstruction is different, the average of the two elevations will be used as the bottom elevation of the obstruction for that "span" of the arc.
There are seven sediment transport equations available in SRH-2D including:
*"Engelund-Hansen" (1972) – A total load equation.
*"Meyer-Peter Müller" (1948) – A bedload transport equation.
*"Parker" (1990) – A bedload transport equation.
*"Wilcock-Crowe" (2003) – A bedload transport equation.
*"Wu et al." (2000) – A total load equation.
*"Yang (1973) Sand with Yang (1984) Gravel" – A total load equation.
*"Yang (1979) Sand with Yang (1984) Gravel" – A total load equation.


There is also an option to apply two sediment transport equations simultaneously using the "Mixed" option; A particle size class cutoff is specified between the two equations. For example, the Engelund-Hansen (1972) equation could be applied for sizes up to 2 mm and Parker (1990) equation for sizes greater than 2 mm. However, the Size Class associated with 2 mm is input rather than the actual particle size.  
When this coverage is active, double-clicking on a feature arc or point, or right-clicking on an arc or point followed by selecting either the '''Assign Arc Obstruction''' or the '''Assign Point Obstruction''' command will bring up the ''SRH-2D Assign Obstruction'' dialog.


Specifically, for the particle classes defined in the figure of the dialog above, Size Class 6 is defined between particle size 6 (1 mm) and particle size 7 (2 mm).  So by specifying the "Sediment Size Class Cutoff" to be 6, the first 6 size classes, up through 2 mm,  would be computed with one equation and the remaining size classes would be computed with the second equation.  This method has been applied in conditions where a significant suspended load component (i.e. silts and sands) is transported in a predominately gravel-bed river.
The ''SRH-2D Assign Obstruction'' dialog has the following options:


=====Transport Equation Coefficient=====
* ''Width/Diameter'' – Each arc segment represents a rectangular area based on the assigned width. Each point represents a circular diameter based on the assigned width.
The options in this section are based on the selected ''Sediment Transport Equations''.
* ''Thickness (Z-dir)'' – Represents the vertical thickness of the obstruction.
*''Meyer Peter Muller Hiding Factor''
* ''Drag Coefficient (Cd)'' – A dimensionless coefficient used to describe the surface upon which the water will be flowing around. See the table below.
*''Reference Shields Parameters''
*''Units'' – May be assigned to either "ft" (feet) or "m" (meters).
*''Hiding Coefficients''
* ''Porosity'' &ndash; Represents the fraction of the projected area that is void, where 0.0 porosity represents a solid. <!--Represents the ability for water to flow through the obstruction object. A porosity of 0 represents a solid surface with no pores allowing for water to pass through the object and 1 represents a surface comparable to a wire mesh with many holes allowing water to pass through it.-->
*''Wilcock T1 Coefficient''
*''Wilcock T2 Coefficient''
*''Wilcock Sand Diameter''
*''Wu Critical Shields Parameter''
*''Mixed Sediment Transport Equations''
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Sediment Diameter Boundary''
* ''Lower Diameter Transport Equation'' &ndash; Applies to sediment sizes less than the ''Sediment Diameter Boundary''.
*''Higher Diameter Transport Equation'' &ndash; Applies to sediment sizes greater than the ''Sediment Diameter Boundary''.
</blockquote>


=====Non-Transport Equation Dependent=====
*''Water Temperature'' &ndash; Specified in degrees Celsius and is used to compute the water viscosity that in turn is used to compute the sediment fall velocity. The default value is 25 degrees Celsius.
*''Adaption Coefficient for Suspended Load'' &ndash; The characteristic length for sediment to adjust from non-equilibrium to equilibrium transport conditions.
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Deposition Coefficient'' &ndash; Default is "0.25".
*''Erosion Coefficient'' &ndash; Default is "1.0".
</blockquote>
*''Adaption Length for Bedload Transport'' &ndash; Computed using one of the following saltation length methods:
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Mode'' &ndash; There are five methods available including:
<blockquote style="margin-top:0px; margin-bottom:0px;">
*"Constant Length" &ndash; Recommended for gravel-bed rivers with values ranging from 1 to 5 channel widths.
*"Phillips-Sutherland Saltation Length Formula" &ndash; Recommended for sandy bed rivers.
*"Van Rijn Sand Dune Formula"
*"Van Rijn Saltation Length Formula"
*"Seminar et al. (2002) Formula"
</blockquote>
*''Length'' &ndash; Enter a value for the "Constant Length" method.
</blockquote>
*''Active Layer Thickness Specification'' &ndash; The channel bed is divided into the active layer and the sub-surface layer(s) to account for the bed sediment dynamics. The active layer is used to calculate sediment exchange between the bed material and bed load transport. The sub-surface can be divided into a number of layers based on variation of the sediment gradation in the vertical direction. The sub-surface layer(s) provide sediment supply to the active layer. The gradations of both the surface and subsurface layers may change over the duration of the simulation.
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Mode'' &ndash; Has two methods:
<blockquote style="margin-top:0px; margin-bottom:0px;">
*"Constant Thickness" &ndash;
*"Thickness Based on D90" &ndash; A constant value [T_Para] times the size (D90) of the material in the surface layer, where D90 is the particle diameter that 90-percent of the materials in the sediment gradation curve are finer than.
</blockquote>
*''Thickness/Thickness Scale'' &ndash; For the "Thickness Based on D90" method, set the thickness scale from 1 to 3 times the D90 for gravels, 5 to 14 for sands.
</blockquote>
[[File:SRH CohesiveSedimentErosionRate.png|thumb|400 px|Definition sketch of cohesive sediment erosion rate variables and relationships]]
*''Cohesive Sediment Modeling'' &ndash; When set to "On" cohesive sediment transport estimates are performed for the first sediment size class.
*''Cohesive Sediment Modeling Options'' &ndash; The following properties need to be specified: cohesive sediment fall velocity, erosion rates of cohesive sediment, and deposition rates of cohesive sediment.
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Fall Velocity'' &ndash; Specified using default values or in a text file. The default fall velocities originate from previous studies conducted by the USBR.
<blockquote style="margin-top:0px; margin-bottom:0px;">
{| class="wikitable"
{| class="wikitable"
|+ Drag Coefficient
|-
|-
|+ style="text-align: center;"|SRH-2D default parameters for fall velocity applied to cohesive sediment
! Type of Object !! Drag Coefficient !! Frontal Area &ndash; A
|-
|-
!Material
|Long stream-lined body || 0.1 ||
!width="80"| Concentration (g/l)
!width="80"| Fall Velocity (mm/s)
|-
|-
|rowspan="4"| Kaolinite ||0.2 || 0.012
|Hollow semi-sphere facing stream || 0.38 ||
|-
|-
|6 || 0.15
|Solid hemisphere || 0.42 || &pi; / 4 d2
|-
|-
| 20 || 0.15
|Sphere || 0.5 ||
|-
|-
| 100 || 0.012
|Cube || 0.8 ||
|-
|-
|rowspan="4"|Severn River ||0.09 || 0.025
|Thin disk || 1.1 || &pi; / 4 d2
|-
|-
|2 || 2
|Squared flat plate at 90&deg; || 1.17 ||
|-
|-
|9 || 2.2
|Circular cylinder || 1.0&ndash;1.3 ||
|-
|90 || 0.028
|}
</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
* "Kaolinite Properties" &ndash; Uses the default Kaolinite values as shown in the table above.
* "Severn River Properties" &ndash; Uses the default Severn River values as shown in the table above.
* "Data File" &ndash; Import a text file with the fall velocity.
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Fall Velocity File'' &ndash; Enter a file path for the data file. An example of the format in a text file (fall_vel.dat) for Kaolinite is:
{|  
|-
|-
|style="border: 1px solid gray; background: #eeeeee"|<tt>
|Hollow semi-cylinder opposite stream || 1.2 ||
// Fall Velocity versus Concentration for the Cohesive Sediment<br>
// Kaolinite example<br>
// CONC(g/l) F_Velo(mm/s)<br>
{|
|-
|-
|align="right"|
|Long flat plate at 90&deg; || 1.98 ||
  0.0<br>
  0.2<br> 
  6.0<br> 
  20.0<br>
100.0 
|width="10"|
|
0.0<br>
0.012<br>
0.15<br>
0.15<br>
0.012
|}
|}
</tt>
|}
</blockquote></blockquote>
*''Erosion Rate'' &ndash; Based on the hydraulic shear stress, Tau (lb/ft<sup>2</sup>), and the following equations:
::Erosion rate = S<sub>s</sub> + S<sub>m</sub> * [(Tau / TAU<sub>em</sub>)-1] if Tau > TAU<sub>em</sub>
::Erosion rate = S<sub>s</sub> * [(Tau - TAU<sub>es</sub>)/(TAU<sub>em</sub> - TAU<sub>es</sub>)]  if TAU<sub>es</sub> < Tau < TAU<sub>em</sub>
::Erosion rate = 0.0 if Tau < TAU<sub>es</sub>
*''Erosion Rate Parameters''
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Critical Shear Stress for Surface Erosion'' &ndash; TAU<sub>es</sub> (N/m<sup>2</sup> or lb/ft<sup>2</sup>).
*''Critical Shear Stress for Mass Erosion'' &ndash; TAU<sub>em</sub> (N/m<sup>2</sup> or lb/ft<sup>2</sup>).
*''Surface Erosion Constant'' &ndash; S<sub>s</sub> (mm/s or lb/ft<sup>2</sup>/hr).
*''Mass Erosion Constant'' &ndash; S<sub>m</sub> (mm/s or lb/ft<sup>2</sup>/hr).
*''Units for Erosion Shear Stresses'' &ndash; Set to "SI" or "English" units.
*''Erosion Rate File''
</blockquote>
*''Deposition Rate Parameters''
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Critical Shear Stress for Full Deposition'' &ndash; TAU<sub>df</sub> (N/m<sup>2</sup> or lb/ft<sup>2</sup>).
*''Critical Shear Stress for Partial Deposition'' &ndash; TAU<sub>dpl</sub> (N/m<sup>2</sup> or lb/ft<sup>2</sup>).
*''Equilibrium Concentration'' &ndash; CONC<sub>eq</sub> (in units of kg/m<sup>3</sup>). Note: 1 kg/m<sup>3</sup> = 1 gm/l = 1000 mg/l, which is approximately equal to 1000 PPM by weight.
*''Units for Deposition Shear Stresses''  &ndash; Set to "SI" or "English" units.
</blockquote></blockquote>


=== Boundary Conditions ===
Please refer to the SRH-2D user manual for additional details on how obstructions are applied in a model.
[[File:SRHnodestringBC.jpg|thumb|300 px|The SRH-2D ''Linear BC'' dialog showing a the Inlet-Q option.]]
 
SRH-2D support a variety of boundary conditions for hydraulic computation. The boundary conditions for the model are specified through the SRH-2D Boundary Condition coverage by selecting an arc. In SMS 11.2 and earlier versions a boundary could also be defined by selecting a nodestring in the mesh instead, though this is no longer supported in SMS 12.0 and later versions. Once the arc or nodestring has been selected, double-clicking, or right-clicking and using the '''Assign Linear BC...''' command, will bring up a dialog where the boundaries can be assigned.
==Monitor Coverage==
Monitor points and lines are optional.  
 
If a Monitor coverage has been created, then it must be linked to the SRH-2D simulation. This can be done by dragging the coverage under the simulation item in the Project Explorer or right-clicking on the coverage and using the ''Link to'' menu item. When the simulation is launched, monitoring point and line data will be collected and outputted.


All currently supported boundary types are exterior boundaries that must be placed on the mesh boundary with the exception of a monitor line. Other boundary types include the following: Inlet-Q, Inlet-SC, Exit-EX, Exit-H, Exit-Q, Wall, and Symmetry.
In SMS 11.2 only, the Monitor Points coverage must be assigned and selected in the ''Select the Monitor Point Coverage'' dialog for SRH-2D to recognize them. The dialog is accessed through the '''Assign Monitor Points Coverage''' command in the ''SRH-2D'' menu. This process is obsolete in SMS 12.0 and higher.
*Inlet-Q is a subcritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. The velocity distribution type may be selected from the boundary condition menu. Inlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
*Inlet-SC is a supercritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. Inlet-SC also requires information about depth. Within the boundary condition menu, the velocity distribution type may be specified.  Inlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
*Exit-EX is a supercritical exit boundary condition.
*Exit-H is a stage type exit boundary where water surface elevation may be given as a constant number or as a stage-discharge or rating curve. Using a constant or rating curve allows accessing the ''Populate'' dialog.
*Exit-Q is an exit boundary with a discharge given as a constant number or as a hydrograph.
*Wall
*Symmetry is defined as a boundary where all dependent variables are extrapolated assuming the gradient of the variable in a direction normal to the boundary is zero except the velocity component normal to the boundary.
*Monitor-Line it is an internal polyline which may be used to monitor the total flow discharge and average water surface elevation.  For a sediment transport simulation, the total sediment discharge, concentration, average bed elevation, and sediment discharges by size fraction are added to this output.
* [[SMS:SRH-2D_Structures#Weir|Weir]] &ndash; See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Culvert|Culvert]] &ndash; See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Pressure_Flow_Bridge|Pressure zone]] &ndash; See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.
* [[SMS:SRH-2D_Structures#Gate|Gate]] &ndash; See the [[SMS:SRH-2D_Structures|SRH-2D Structures]] article for more information.


See [[SMS:SRH-2D Boundary Conditions|SRH-2D Boundary Conditions]] for more information on the options for each boundary type.
Starting in SMS version 13.0, monitor lines are no longer set on the Boundary Conditions coverage. Because of this change, when importing SRH-2D projects create in earlier versions of SMS several items will happen:
*SMS will separate the monitoring lines from other arcs in the boundary conditions coverage. The monitoring lines will be placed in their own Monitor coverage.
*The former Boundary Condition coverage will be made into two coverages, one for the monitor lines and the other for the existing boundary conditions. The names of these coverages will have either "Boundary Conditions" or "Monitor" attached to designate which coverage contains the boundary condition arcs and which contains the monitor lines.
*If a Monitor Points coverage existed in the project, this coverage will be changed to a Monitor coverage and the coverage name will have "Monitor" attached.
*If the imported project had both monitor points and monitor lines, there will now be a Monitor coverage for each Monitor Points coverage and a Monitor coverage for each Boundary Condition coverage that contained monitor lines.
*By default, the Monitor coverage with the monitor lines will be included in any simulations.
*The monitor points and monitor lines from the previous project will need to be merged into one Monitor coverage and linked to the simulation in order for both points and lines to be included in the simulation run.
*The default boundary condition for arcs on an SRH-2D boundary condition coverage is now the "Wall" type. The boundary condition arcs should be reviewed to ensure no parameters were lost in the conversion.


[[Category:SMS Boundary Conditions|SRH-2D]]
===Monitor Points===
If choosing to have monitor points, add points using the '''Create Feature Point''' tool in the Monitor coverage. A monitor point is used to gather specific information for that location at all time steps. Information calculated by SRH-2D at a monitor point includes position in the X and Y direction, bed elevation, water elevation, water depth, X direction velocity component, Y direction velocity component, velocity magnitude, Froude number, and shear stress. This data is written to a separate output file for each monitor point. These files appear in the output directory and are called PT(''n'').dat, where ''n'' is a sequential integer corresponding to the order of the SMS feature point ID numbers for the monitor points.


==Obstructions Coverage==
To ensure the ID number will match the numbers appended to the data files, it is recommended that the following be done:
[[File:SRH Obstructions.png|thumb|300 px|The SRH-2D ''Obstructions'' dialog]]
* Create all monitor points before creating monitor lines.
Used to create feature objects that represent obstructions, such as bank protrusions and boulder clusters. Obstructions can be assigned to feature arcs or points.  
* Renumber the Monitor coverage before running SRH-2D.


When this coverage is active, double-clicking on a feature arc or point, or right-clicking on an arc or point followed by selecting the '''Assign Obstructions...''' command, will bring up the ''Obstructions'' dialog.
For a sediment transport simulation, the D50 particle size is included in the monitor point output file, and an additional sediment monitor point file is created that includes concentration, erosion and deposition, and bed material gradations.


The ''Obstructions'' dialog has the following options:
Usually, one monitor point will be created near the outflow boundary and another near the inflow or perhaps near an area of interest. Water levels for the first two monitor points created will be displayed during the model run.


* ''Obstruction Width/Diameter'' &ndash; Each arc segment represents a rectangular area based on the assigned width. Each point represents a circular diameter based on the assigned width.
===Monitor Lines===
* ''Obstruction Thickness (Z-dir)'' &ndash; Represents the vertical thickness of the obstruction.
Monitor Lines are created to extract data from the solution along an arc. Monitor lines are optional, but highly recommended to help verify continuity and model stability. SRH-2D will calculate the total flow across the arc and the average water surface elevation along the arc.
* ''Drag Coefficient (Cd)'' &ndash; A dimensionless coefficient used to describe the surface upon which the water will be flowing around.
*''Units'' &ndash; May be assigned to either "ft" (feet) or "m" (meters).
* ''Porosity'' &ndash; Represents the ability for water to flow through the obstruction object. A porosity of 0 represents a solid surface with no pores allowing for water to pass through the object and 1 represents a surface comparable to a wire mesh with many holes allowing water to pass through it.


==Monitor Points Coverage==
Create monitor lines using the '''Create Feature Arc''' tool, and digitizing arcs in the Monitor coverage. Create the arcs in the Monitor coverage at locations where it is desirable to compute flow. The direction of the monitor line does not matter, except that flow values will be reported as positive or negative if the line creation direction is reversed. It is recommended that monitor lines be created near the inflow and outflow boundaries. Monitor lines must be created inside the domain and not outside the domain or on the edge of the domain. Monitoring flows near the outflow boundary can help verify model continuity. Monitor lines are also useful for evaluating flow splits or other areas where the flow across a line is desirable.
Monitor Points are optional. If choosing to have monitor points, create a monitor points coverage and add points using the '''Create Feature Point''' tool. A monitor point is used to gather specific information for that location at all time steps. Information calculated by SRH-2D at a monitor point includes position in the X and Y direction, bed elevation, water elevation, water depth, X direction velocity component, Y direction velocity component, velocity magnitude, Froude number, and shear stress.  


For a sediment transport simulation, the D50 particle size is included in the monitor point output file, and an additional sediment monitor point file is created that includes concentration, erosion and deposition, and bed material gradations.
Monitor line output is written to a separate output file for each monitor line. These files will appear in the output directory and are called LN(''n'').dat, where ''n'' is a sequential integer corresponding to the order of the SMS feature arc ID numbers. The monitor lines are save sequentially from how they are encountered in by the SRH-2D model run. Displaying the ID numbers in the Monitor coverage will show the order.  


If a Monitor Points coverage has been created, then it must be linked to the SRH-2D simulation. This can be done by dragging the coverage under the simulation item in the Project Explorer or right-clicking on the coverage and using the ''Link to'' menu item. When the simulation is launched, monitoring point data will be collected and outputted.
To ensure the ID number will match the numbers appended to the data files, it is recommended that the following be done:
* Create all monitor points before creating monitor lines.
* Renumber the Monitor coverage before running SRH-2D.


In SMS 11.2 only, the Monitor Points coverage must be assigned and selected in the ''Select the Monitor Point Coverage'' dialog for SRH-2D to recognize them. The dialog is accessed through the '''Assign Monitor Points Coverage''' command in the ''SRH-2D'' menu. This process is obsolete in SMS 12.0 and higher.
Once steady state is achieved, flows reported in these files corresponding to monitor lines placed near the outflow should be very close to the total inflow. Also, reviewing the flow and WSE values reported in these files at the final time steps can help verify model stability. Unstable models may show varying or oscillating values for the flows reported for the monitor line.


==Materials Coverage==
==Materials Coverage==
The SRH-2D materials coverage allows creating material zones specific to the SRH-2D model. The materials zones must cover the domain extents of the project.
The SRH-2D materials coverage allows creating material zones specific to the SRH-2D model. The materials zones must cover the domain extents of the project.
===Materials Coverage Right-Click Menu===
===Materials Coverage Right-Click Menu===
The materials coverage has the standard [[SMS:Project_Explorer_Items#Coverage Item Right-Click Menus|coverage item right-click menu commands]] as well as specific right-click commands. The following commands are also part of the SRH-2D materials coverage:
The materials coverage has the standard [[SMS:Map_Project_Explorer#Coverage Item Right-Click Menus|coverage item right-click menu commands]] as well as specific right-click commands. The following commands are also part of the SRH-2D materials coverage:
*[[SMS:SRH-2D Material Properties|'''Material Properties''']] &ndash; Opens the ''Material Properties'' dialog.
*[[SMS:SRH-2D Material Properties|'''Material List and Properties''']] &ndash; Opens the ''Material List and Properties'' dialog.
*'''Assign Material To''' &ndash; Opens the ''Assign Materials'' dialog for managing multiple material coverages.
*'''Assign Material''' &ndash; Opens the ''Assign Material'' dialog for managing multiple material coverages.


===Assign Materials===
===Assign Materials===
[[File:SRH AssignMaterials.jpg|thumb|250 px|Example of the ''Assign Materials'' dialog.]]
[[File:Assign_Material_Dialog.PNG|thumb|250 px|Example of the ''Assign Materials'' dialog.]]
SRH-2D allows the option to have multiple material coverages. When multiple material coverages exist, there are options to manage these coverages. By right-clicking on an SRH-2D materials coverage and selecting the '''Assign Materials to...''' command, the ''Assign Materials'' dialog can be accessed. This dialog allows adding the unique material definition of one material coverage to that of another material coverage. Select the target material coverage that will be modified by the material coverage used to access the dialog. There are then two option for how SMS will modify the target material coverage.
SRH-2D allows the option to have multiple material coverages. When multiple material coverages exist, there are options to manage these coverages. By right-clicking on an SRH-2D materials coverage and selecting the '''Assign Material''' command, the ''Assign Materials'' dialog can be accessed. This dialog allows adding the unique material definition of one material coverage to that of another material coverage. Select the target material coverage that will be modified by the material coverage used to access the dialog. There are a number of options available for the coverage selections.
*''Append to target material list'' &ndash; This will add any unique material definitions to the target material coverage.
*"Flood Plain" &ndash; Represents a flood plain.
*''Replace target material list'' &ndash; Deletes the existing material definitions in the target material coverage and replaces them with the selected material coverage.
*"Unassigned" &ndash; Represents an unassigned coverage.
*"Road" &ndash; Represents a road.
*"River" &ndash; Represents a river.
After performing either of these actions, opening the ''Material Properties'' dialog for the target material coverage will show the material list modified with the new definitions.
After performing either of these actions, opening the ''Material Properties'' dialog for the target material coverage will show the material list modified with the new definitions.


===Assigning Materials to Polygons===
===Assigning Materials to Polygons===
Materials can be assigned to individual polygons using the '''Select Polygon''' tool and double-clicking on a polygon in the materials coverage. This will bring up the ''Assign Material Properties'' dialog.  
Materials can be assigned to individual polygons using the '''Select Polygon''' tool and double-clicking on a polygon in the materials coverage. This will bring up the ''Assign Material'' dialog.  


The ''Assign Material Properties'' dialog can also be reached by right-clicking on a polygon in the materials coverage and selecting the '''Assign Material Properties''' command.
The ''Assign Material'' dialog can also be reached by right-clicking on a polygon in the materials coverage and selecting the '''Assign Material''' command.


See [[SMS:SRH-2D Material Properties|SRH-2D Material Properties]] for more information about the ''Assign Material Properties'' dialog.
See [[SMS:SRH-2D Material Properties|SRH-2D Material Properties]] for more information about the ''Assign Material'' dialog.


==Sediment Materials Coverage==
==Sediment Materials Coverage==
The SRH-2D Sediment Materials coverage is similar to the Materials coverage, however, the materials zones in this coverage assign sediment properties. The coverage has the same right-click menu options as the Materials coverage.  Sediment materials are assigned to polygons.  Sediment layer thicknesses, gradations, and bulk densities (in dry unit weights in lb/ft<sup>3</sup> or kg/m<sup>3</sup>) are provided for each layer. A non-erodible material can be specified by leaving the layer information blank.
The SRH-2D Sediment Materials coverage is similar to the Materials coverage, however, the materials zones in this coverage assign sediment properties. The coverage has the same right-click menu options as the Materials coverage.   
 
Sediment materials are assigned to polygons. The polygons are then [[SMS:Snapping#Snap_Preview_of_Feature_Objects_to_a_Geometry|"snapped"]] to the mesh elements during the model run. If the border of a polygon falls on the centroid of an elementa, it will be unassigned. If this happens, SMS will give a warning when launching the simulation. This warning can be ignored in some cases, such as when the cell is a fringe cell or when cells are intentionally disabled, but this is up to the user's discretion.   
 
Sediment layer thicknesses, gradations, and bulk densities (in dry unit weights in lb/ft<sup>3</sup> or kg/m<sup>3</sup>) are provided for each layer. A non-erodible material can be specified by leaving the layer information blank.


For more information, see the [[SMS:SRH-2D_Material_Properties#Sediment_Material_Properties| Sediment Material Properties]] article section.
For more information, see the [[SMS:SRH-2D Sediment Material Properties| Sediment Material Properties]] article.


==Related Topics==
==Related Topics==

Latest revision as of 16:21, 24 September 2024

The SRH-2D model makes use of the simulation based modeling approach. This requires defining coverages in the Map module to build the components for use in the SRH-2D simulation.

Boundary Conditions Coverage

Mobile Run Type

The "Mobile" option is used to perform a sediment transport simulation. It should be noted that sediment transport simulations require a hotstart or restart file from a corresponding hydraulic simulation. When the "Mobile" option is specified the dialog expands to include sediment transport parameters.

The sediment transport options are described in the SRH-2D Sediment Transport Parameters article.

Boundary Conditions

The SRH-2D Linear BC dialog showing a the Inlet-Q option.

SRH-2D supports a variety of boundary conditions for hydraulic computation. The boundary conditions for the model are specified through the SRH-2D Boundary Condition coverage by selecting an arc. In SMS 11.2 and earlier versions, a boundary could also be defined by selecting a nodestring in the mesh instead, though this is no longer supported in SMS 12.0 and later versions. Once the arc or nodestring has been selected, double-clicking, or right-clicking and using the Assign BC... command, will bring up a dialog where the boundaries can be assigned.

All currently supported boundary types are exterior boundaries that must be placed on the mesh boundary with the exception of a monitor line. Other boundary types include the following: Inlet-Q, Inlet-SC, Exit-EX, Exit-H, Exit-Q, Wall, and Symmetry. BC Types:

  • Inlet-Q is a subcritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. The velocity distribution type may be selected from the boundary condition menu. Inlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
  • Inlet-SC is a supercritical inlet boundary that may be given as a constant discharge or as a variable discharge hydrograph. Inlet-SC also requires information about depth. Within the boundary condition menu, the velocity distribution type may be specified. Inlet flow volume values can only be positive. For a sediment transport run, the inflowing sediment loads are also specified.
  • Exit-EX is a supercritical exit boundary condition.
  • Exit-H is a stage type exit boundary where water surface elevation may be given as a constant number or as a stage-discharge or rating curve. Using a constant or rating curve allows accessing the Populate dialog.
  • Exit-Q is an exit boundary with a discharge given as a constant number or as a hydrograph.
  • Wall
  • Symmetry is defined as a boundary where all dependent variables are extrapolated assuming the gradient of the variable in a direction normal to the boundary is zero except the velocity component normal to the boundary.
  • Monitor-Line it is an internal polyline which may be used to monitor the total flow discharge and average water surface elevation. For a sediment transport simulation, the total sediment discharge, concentration, average bed elevation, and sediment discharges by size fraction are added to this output.
  • Weir – See the SRH-2D Structures article for more information.
  • Culvert – See the SRH-2D Structures article for more information.
  • Pressure zone – See the SRH-2D Structures article for more information.
  • Gate – See the SRH-2D Structures article for more information.
  • Internal Sink – Models a drain or sink inside the model domain.
  • Link – Models flow between two separate meshes.
  • BC Data – Options for specifying BCDATA lines and flow direction.

See SRH-2D Boundary Conditions for more information on the options for each boundary type.

Obstructions Coverage

The SRH-2D Assign Obstruction dialog

Used to create feature objects that represent obstructions, such as bank protrusions and boulder clusters. Obstructions can be assigned to feature arcs or points.

The elevation that is assigned to the point (for point obstructions) or nodes and vertices (for arc (line) obstructions) will be used as the bottom elevation of the obstruction. If the elevation from node to vertex or vertex to vertex along an arc (line) obstruction is different, the average of the two elevations will be used as the bottom elevation of the obstruction for that "span" of the arc.

When this coverage is active, double-clicking on a feature arc or point, or right-clicking on an arc or point followed by selecting either the Assign Arc Obstruction or the Assign Point Obstruction command will bring up the SRH-2D Assign Obstruction dialog.

The SRH-2D Assign Obstruction dialog has the following options:

  • Width/Diameter – Each arc segment represents a rectangular area based on the assigned width. Each point represents a circular diameter based on the assigned width.
  • Thickness (Z-dir) – Represents the vertical thickness of the obstruction.
  • Drag Coefficient (Cd) – A dimensionless coefficient used to describe the surface upon which the water will be flowing around. See the table below.
  • Units – May be assigned to either "ft" (feet) or "m" (meters).
  • Porosity – Represents the fraction of the projected area that is void, where 0.0 porosity represents a solid.
Drag Coefficient
Type of Object Drag Coefficient Frontal Area – A
Long stream-lined body 0.1
Hollow semi-sphere facing stream 0.38
Solid hemisphere 0.42 π / 4 d2
Sphere 0.5
Cube 0.8
Thin disk 1.1 π / 4 d2
Squared flat plate at 90° 1.17
Circular cylinder 1.0–1.3
Hollow semi-cylinder opposite stream 1.2
Long flat plate at 90° 1.98

Please refer to the SRH-2D user manual for additional details on how obstructions are applied in a model.

Monitor Coverage

Monitor points and lines are optional.

If a Monitor coverage has been created, then it must be linked to the SRH-2D simulation. This can be done by dragging the coverage under the simulation item in the Project Explorer or right-clicking on the coverage and using the Link to menu item. When the simulation is launched, monitoring point and line data will be collected and outputted.

In SMS 11.2 only, the Monitor Points coverage must be assigned and selected in the Select the Monitor Point Coverage dialog for SRH-2D to recognize them. The dialog is accessed through the Assign Monitor Points Coverage command in the SRH-2D menu. This process is obsolete in SMS 12.0 and higher.

Starting in SMS version 13.0, monitor lines are no longer set on the Boundary Conditions coverage. Because of this change, when importing SRH-2D projects create in earlier versions of SMS several items will happen:

  • SMS will separate the monitoring lines from other arcs in the boundary conditions coverage. The monitoring lines will be placed in their own Monitor coverage.
  • The former Boundary Condition coverage will be made into two coverages, one for the monitor lines and the other for the existing boundary conditions. The names of these coverages will have either "Boundary Conditions" or "Monitor" attached to designate which coverage contains the boundary condition arcs and which contains the monitor lines.
  • If a Monitor Points coverage existed in the project, this coverage will be changed to a Monitor coverage and the coverage name will have "Monitor" attached.
  • If the imported project had both monitor points and monitor lines, there will now be a Monitor coverage for each Monitor Points coverage and a Monitor coverage for each Boundary Condition coverage that contained monitor lines.
  • By default, the Monitor coverage with the monitor lines will be included in any simulations.
  • The monitor points and monitor lines from the previous project will need to be merged into one Monitor coverage and linked to the simulation in order for both points and lines to be included in the simulation run.
  • The default boundary condition for arcs on an SRH-2D boundary condition coverage is now the "Wall" type. The boundary condition arcs should be reviewed to ensure no parameters were lost in the conversion.

Monitor Points

If choosing to have monitor points, add points using the Create Feature Point tool in the Monitor coverage. A monitor point is used to gather specific information for that location at all time steps. Information calculated by SRH-2D at a monitor point includes position in the X and Y direction, bed elevation, water elevation, water depth, X direction velocity component, Y direction velocity component, velocity magnitude, Froude number, and shear stress. This data is written to a separate output file for each monitor point. These files appear in the output directory and are called PT(n).dat, where n is a sequential integer corresponding to the order of the SMS feature point ID numbers for the monitor points.

To ensure the ID number will match the numbers appended to the data files, it is recommended that the following be done:

  • Create all monitor points before creating monitor lines.
  • Renumber the Monitor coverage before running SRH-2D.

For a sediment transport simulation, the D50 particle size is included in the monitor point output file, and an additional sediment monitor point file is created that includes concentration, erosion and deposition, and bed material gradations.

Usually, one monitor point will be created near the outflow boundary and another near the inflow or perhaps near an area of interest. Water levels for the first two monitor points created will be displayed during the model run.

Monitor Lines

Monitor Lines are created to extract data from the solution along an arc. Monitor lines are optional, but highly recommended to help verify continuity and model stability. SRH-2D will calculate the total flow across the arc and the average water surface elevation along the arc.

Create monitor lines using the Create Feature Arc tool, and digitizing arcs in the Monitor coverage. Create the arcs in the Monitor coverage at locations where it is desirable to compute flow. The direction of the monitor line does not matter, except that flow values will be reported as positive or negative if the line creation direction is reversed. It is recommended that monitor lines be created near the inflow and outflow boundaries. Monitor lines must be created inside the domain and not outside the domain or on the edge of the domain. Monitoring flows near the outflow boundary can help verify model continuity. Monitor lines are also useful for evaluating flow splits or other areas where the flow across a line is desirable.

Monitor line output is written to a separate output file for each monitor line. These files will appear in the output directory and are called LN(n).dat, where n is a sequential integer corresponding to the order of the SMS feature arc ID numbers. The monitor lines are save sequentially from how they are encountered in by the SRH-2D model run. Displaying the ID numbers in the Monitor coverage will show the order.

To ensure the ID number will match the numbers appended to the data files, it is recommended that the following be done:

  • Create all monitor points before creating monitor lines.
  • Renumber the Monitor coverage before running SRH-2D.

Once steady state is achieved, flows reported in these files corresponding to monitor lines placed near the outflow should be very close to the total inflow. Also, reviewing the flow and WSE values reported in these files at the final time steps can help verify model stability. Unstable models may show varying or oscillating values for the flows reported for the monitor line.

Materials Coverage

The SRH-2D materials coverage allows creating material zones specific to the SRH-2D model. The materials zones must cover the domain extents of the project.

Materials Coverage Right-Click Menu

The materials coverage has the standard coverage item right-click menu commands as well as specific right-click commands. The following commands are also part of the SRH-2D materials coverage:

  • Material List and Properties – Opens the Material List and Properties dialog.
  • Assign Material – Opens the Assign Material dialog for managing multiple material coverages.

Assign Materials

Example of the Assign Materials dialog.

SRH-2D allows the option to have multiple material coverages. When multiple material coverages exist, there are options to manage these coverages. By right-clicking on an SRH-2D materials coverage and selecting the Assign Material command, the Assign Materials dialog can be accessed. This dialog allows adding the unique material definition of one material coverage to that of another material coverage. Select the target material coverage that will be modified by the material coverage used to access the dialog. There are a number of options available for the coverage selections.

  • "Flood Plain" – Represents a flood plain.
  • "Unassigned" – Represents an unassigned coverage.
  • "Road" – Represents a road.
  • "River" – Represents a river.

After performing either of these actions, opening the Material Properties dialog for the target material coverage will show the material list modified with the new definitions.

Assigning Materials to Polygons

Materials can be assigned to individual polygons using the Select Polygon tool and double-clicking on a polygon in the materials coverage. This will bring up the Assign Material dialog.

The Assign Material dialog can also be reached by right-clicking on a polygon in the materials coverage and selecting the Assign Material command.

See SRH-2D Material Properties for more information about the Assign Material dialog.

Sediment Materials Coverage

The SRH-2D Sediment Materials coverage is similar to the Materials coverage, however, the materials zones in this coverage assign sediment properties. The coverage has the same right-click menu options as the Materials coverage.

Sediment materials are assigned to polygons. The polygons are then "snapped" to the mesh elements during the model run. If the border of a polygon falls on the centroid of an elementa, it will be unassigned. If this happens, SMS will give a warning when launching the simulation. This warning can be ignored in some cases, such as when the cell is a fringe cell or when cells are intentionally disabled, but this is up to the user's discretion.

Sediment layer thicknesses, gradations, and bulk densities (in dry unit weights in lb/ft3 or kg/m3) are provided for each layer. A non-erodible material can be specified by leaving the layer information blank.

For more information, see the Sediment Material Properties article.

Related Topics