SMS:ADH Boundary Condition Assignment: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
No edit summary
Line 5: Line 5:
To open this window, at least one node or nodestring must be selected. After a selection is made, select the ADH | Assign BC... menu item or use the right-click menu.
To open this window, at least one node or nodestring must be selected. After a selection is made, select the ADH | Assign BC... menu item or use the right-click menu.


ADH boundary conditions consist of two types: Dirichlet and Natural. Dirichlet data is applied on the domain to individual nodes or to groups of nodes (defined with nodestrings). Natural data (flux) is applied through edges of the domain defined by nodestrings.
ADH boundary conditions consist of two specification types (Dirichlet and Natural) and three condition types (flow, pressure, and transport). Dirichlet data is applied on the domain to individual nodes or to groups of nodes (defined with nodestrings). Natural data (flux) is applied through edges of the domain defined by nodestrings and includes a friction specification. A node or nodestring can be assigned only one condition option from each of the three condition types (two flow conditions cannot be assigned to a single node).  


'''Natural boundary conditions:''' (available only for nodestrings)


:* Flow (unit flow per unit length) - <font color="green">NB OVL</font> with <font color="green">FR MNG</font>, used to define either inflow or outflow.
==Boundary Conditions==
{|border="1"
|-
!width="200"|Flow Condition Options
!width="150"|Specification Type
!width="570"|Information
|-
| None
|align="center"| ---
| No condition specified
|-
|Flow (per unit length)
|align="center"|Natural
|Specified by a [[SMS:ADH Time Series|Flow (per unit length) time series]]; <font color="green">NB OVL</font> card with a friction card
|-
|Sidewall (no through flow)
|align="center"|Natural
|Creates a vertical wall with the specified shear stress; just a friction card
|-
|Subcritical inflow
|align="center"|Dirichlet
|Specified by a [[SMS:ADH Time Series|Velocity time series]]; <font color="green">DB OVL</font> card
|-
|Supercritical inflow
|align="center"|Dirichlet
|Specified by a Depth time series and a [[SMS:ADH Time Series|Velocity time series]]; <font color="green">DB OVH</font> card
|-
|Tailwater (outflow)
|align="center"|Natural
|Specified by a [[SMS:ADH Time Series|Water Surface Elevation time series]]; <font color="green">NB OTW</font> card with a friction card
|-
|Total discharge
|align="center"|Natural
|Specified by a [[SMS:ADH Time Series|Discharge time series]]; <font color="green">NB DIS</font> card with a friction card
|}
{|border="1"
|-
!width="200"|Pressure Condition Options
!width="150"|Specification Type
!width="570"|Information
|-
| None
|align="center"| ---
| No condition specified
|-
|Lid (depth underneath)
|align="center"|Dirichlet
|Specified by a [[SMS:ADH Time Series|Depth time series]]; i.e. a structure (ex. culvert, sluice gate, etc.) defined using bed elevation as datum; <font color="green">DB LDH</font> card
|-
|Lid (draft)
|align="center"|Dirichlet
|Specified by a [[SMS:ADH Time Series|Draft time series]]; i.e. a floating object (ex. boat, dock, etc.) with draft; <font color="green">DB LID</font> card
|-
|Lid (elevation)
|align="center"|Dirichlet
|Specified an [[SMS:ADH Time Series|Elevation time series]]; i.e. a structure (ex. culvert, sluice gate, etc.) defined using the elevation datum; <font color="green">DB LDE</font> card
|}
{|border="1"
|-
!width="200"|Transport Condition Options
!width="150"|Specification Type
!width="570"|Information
|-
| None
|align="center"| ---
| No condition specified
|-
|Dirichlet
|align="center"|Dirichlet
|Specified by a [[SMS:ADH Time Series|Transport time series]]; <font color="green">DB TRN</font> card
|-
|Equilibrium
|align="center"|Dirichlet
|Specified by initial concentration (in ppm); This condition can only be assigned to sediments and specified in simulations without cohesive sediments; <font color="green">EQ TRN</font> card
|-
|Natural
|align="center"|Natural
|Specified a [[SMS:ADH Time Series|Transport time series]]; <font color="green">NB TRN</font> card
|}
{|border="1"
|-
!width="200"|Weir Options
!width="150"|Specification Type
!width="570"|Information
|-
| None
|align="center"| ---
| No condition specified
|-
|Weir
|
|Nodestrings are specified as upstream, upstream edge, downstream or downstream edge. See the <font color="green">WER</font> and <font color="green">WRS</font> card
|}


:* Sidewall (no through flow) - <font color="green">FR MNG</font>, creates a vertical wall with a specified roughness.


:* Subcritical outflow - <font color="green">NB OTW</font> with <font color="green">FR MNG</font>
==Natural Flow Condition Friction Options==
{|border="1"
|-
!Friction Options
!Information
|-
|Manning's n
|Specified by a roughness value; <font color="green">FR MNG</font> card
|-
|Equivalent roughness height
|Specified by a roughness height (in ft or m); <font color="green">FR ERH</font> card
|-
|Submerged aquatic vegetation
|Specified by an undeflected stem height (in ft or m); <font color="green">FR SAV</font> card
|-
|Un-submerged rigid vegetation
|Specified by a roughness height (in ft or m), averaged stem diameter (in ft or m), and average stem density (in stems/ft² or stems/m²); <font color="green">FR URV</font> card
|}


:* Total discharge - <font color="green">NB DIS</font> with <font color="green">FR MNG</font>


'''Dirichlet boundary conditions:''' (available for nodes and nodestrings)
All mesh boundary edges that do not have a boundary condition will be treated as a frictionless sidewall with no through flow.


:* Subcritical inflow - <font color="green">DB OVL</font>
All boundary conditions listed above can only be assigned to the mesh boundary, expect the pressure conditions which can also be assigned to the mesh interior.


:* Supercritical inflow - <font color="green">DB OVH</font>
When changing a condition type on any tab, the existing condition information is cleared from the window such that the information must be respecified upon returning to that type.


:* Pressure lid (depth underneath) - <font color="green">DB LDH</font>, i.e. a structure (ex. culvert, sluice gate, etc.) defined using bed elevation as datum.
==Dialog Description==
The following controls specify the boundary condition to be assigned to the currently selected entities. This window is expandable by dragging the window edges to increase visibility of the spreadsheet data on the ''Transport tab''.  


:* Pressure lid (draft) - <font color="green">DB LID</font>, i.e. a floating object (ex. boat, dock, etc.) with draft.
===Boundary Condition Type (Tab Control)===
This tab control can contain the following three tabs:


:* Pressure lid (elevation) - <font color="green">DB LDE</font>, i.e. a structure (ex. culvert, sluice gate, etc.) defined using the elevation datum.
====Flow====
This tab is only available if all of the currently selected nodes or nodestrings are on the mesh boundary.
Boundary type combo box contains the conditions available for flow (listed above) for the selected entities.
Series data curve button selects the time series to be associated with the selected boundary type. The text label above this curve button will change with the boundary type to denote the type of input. Clicking on the curve button will open the [[SMS:Time Series|Time Series]] editor (limited to the [[SMS:ADH Time Series|curve group of the boundary type]]). A second curve button will appear for boundary types that require two conditions with time series data.  


All mesh boundary edges that do not have a boundary condition will be treated as a frictionless sidewall with no through flow.
''Friction'' combo box specifies the type of bed shear stress to be applied to the boundary edge and is available only for Natural boundary types. The friction options are:
* ''Manning's n'' provides the ''Manning's n'' roughness real number edit field limited to a value of 0.0 to 0.3.
* ''Equivalent roughness height'' provides the ''Roughness height'' positive real number edit field.
* ''Submerged aquatic vegetation'' provides the ''Undeflected stem height'' positive real number edit field.
* ''Un-submerged rigid vegetation'' provides the ''Roughness height, Average stem diameter'' and ''Average stem'' density positive real number edit fields.  


All boundary conditions listed above can only be assigned to the mesh boundary, expect the pressures lids which can be also be assigned to the mesh interior.
====Pressure====
This tab is always available.  


== Dialog Description ==
Boundary type combo box contains the conditions available for pressure (listed above) for the selected entities.


The following controls specify the boundary condition to be assigned to the currently selected entities.
Series data curve button selects the time series to be associated with the selected boundary type. The text label above this curve button will change with the boundary type to denote the type of input. Clicking on the curve button will open the [[SMS:Time Series|Time Series]] editor (limited to the [[SMS:ADH Time Series|curve group of the boundary type]]).  


=== Boundary Type ===
====Transport Constituents====
This tab is only available if all of the currently selected nodes or nodestrings are on the mesh boundary and constituents have been included in [[SMS:ADH Model Control Transport Constituents|Model Control Transport Constituents]].


Boundary type combo box contains the conditions available (listed above) for the selected entities.
Boundary type combo box contains the conditions available for transport (listed above) for the selected entities.  


Series data curve button with the associated ''Series time units'' combo box, and ''Specify curve fit tolerance'' check box and positive integer edit field defines the data to be associated with the selected boundary type. The text label above this curve button will change with the boundary type to denote the type of input. Clicking on the curve button will open the [[XY Series Editor]]. This control group correlates to the <font color="green">XY1</font> card.
Spreadsheet contains the following information specific to each transport type:
* ''None'' clears the display of any information in the spreadsheet.
* ''Dirichlet'' provides each defined constituent (first column) with a ''Include'' check box (second column), ''Specify Series''... curve button (third column), and a series name cell (fourth column). To include the constituent in the specification of the transport condition, check the ''Include'' control and specify a concentration series by clicking on the ''Specify Series''... button which will open the [[SMS:Time Series|Time Series]] editor (limited to the [[SMS:ADH Time Series|Transport curve group]]). When a series has been defined, the name will be listed in the series name cell. A series can be selected by multiple constituents. The concentration series button and name cells are only enabled if the constituent is included in the transport source.
* ''Equilibrium'' provides each defined sediment (first column) with a Include check box (second column) and a positive real number ''Initial concentration'' cell (third column). To include the sediment in the specification of the transport condition, check the ''Include'' control and specify a concentration (in parts per million). If the sediment is not to be present at the beginning of the simulation, specify a concentration of zero. The ''Initial concentration'' cell is only enabled if the sediment is included in the transport source.
* ''Natural'' provides the same as ''Dirichlet.''


''Manning's n roughness'' or ''Skin friction coefficient'' real number edit field correlates to the <font color="green">FR MNG</font> card. This is available only for Natural boundary types.
Velocity data control group includes the ''Specify Velocity Series...'' button with the associated ''Series time units'' combo box, and ''Specify curve fit tolerance'' check box and positive integer edit field. Clicking on the ''Specify Velocity Series...'' button will open the [[SMS:Velocity Series Editor | Velocity Series Editor]]. This control group correlates to the two <font color="green">XY1</font> cards necessary to define a velocity series and is available only for Dirichlet conditions that include velocity series.


=== Output (untitled group box) ===
=== Output (untitled group box) ===

Revision as of 16:03, 2 November 2012

Go to SMS:ADH page

To open this window, at least one node or nodestring must be selected. After a selection is made, select the ADH | Assign BC... menu item or use the right-click menu.

ADH boundary conditions consist of two specification types (Dirichlet and Natural) and three condition types (flow, pressure, and transport). Dirichlet data is applied on the domain to individual nodes or to groups of nodes (defined with nodestrings). Natural data (flux) is applied through edges of the domain defined by nodestrings and includes a friction specification. A node or nodestring can be assigned only one condition option from each of the three condition types (two flow conditions cannot be assigned to a single node).


Boundary Conditions

Flow Condition Options Specification Type Information
None --- No condition specified
Flow (per unit length) Natural Specified by a Flow (per unit length) time series; NB OVL card with a friction card
Sidewall (no through flow) Natural Creates a vertical wall with the specified shear stress; just a friction card
Subcritical inflow Dirichlet Specified by a Velocity time series; DB OVL card
Supercritical inflow Dirichlet Specified by a Depth time series and a Velocity time series; DB OVH card
Tailwater (outflow) Natural Specified by a Water Surface Elevation time series; NB OTW card with a friction card
Total discharge Natural Specified by a Discharge time series; NB DIS card with a friction card
Pressure Condition Options Specification Type Information
None --- No condition specified
Lid (depth underneath) Dirichlet Specified by a Depth time series; i.e. a structure (ex. culvert, sluice gate, etc.) defined using bed elevation as datum; DB LDH card
Lid (draft) Dirichlet Specified by a Draft time series; i.e. a floating object (ex. boat, dock, etc.) with draft; DB LID card
Lid (elevation) Dirichlet Specified an Elevation time series; i.e. a structure (ex. culvert, sluice gate, etc.) defined using the elevation datum; DB LDE card
Transport Condition Options Specification Type Information
None --- No condition specified
Dirichlet Dirichlet Specified by a Transport time series; DB TRN card
Equilibrium Dirichlet Specified by initial concentration (in ppm); This condition can only be assigned to sediments and specified in simulations without cohesive sediments; EQ TRN card
Natural Natural Specified a Transport time series; NB TRN card
Weir Options Specification Type Information
None --- No condition specified
Weir Nodestrings are specified as upstream, upstream edge, downstream or downstream edge. See the WER and WRS card


Natural Flow Condition Friction Options

Friction Options Information
Manning's n Specified by a roughness value; FR MNG card
Equivalent roughness height Specified by a roughness height (in ft or m); FR ERH card
Submerged aquatic vegetation Specified by an undeflected stem height (in ft or m); FR SAV card
Un-submerged rigid vegetation Specified by a roughness height (in ft or m), averaged stem diameter (in ft or m), and average stem density (in stems/ft² or stems/m²); FR URV card


All mesh boundary edges that do not have a boundary condition will be treated as a frictionless sidewall with no through flow.

All boundary conditions listed above can only be assigned to the mesh boundary, expect the pressure conditions which can also be assigned to the mesh interior.

When changing a condition type on any tab, the existing condition information is cleared from the window such that the information must be respecified upon returning to that type.

Dialog Description

The following controls specify the boundary condition to be assigned to the currently selected entities. This window is expandable by dragging the window edges to increase visibility of the spreadsheet data on the Transport tab.

Boundary Condition Type (Tab Control)

This tab control can contain the following three tabs:

Flow

This tab is only available if all of the currently selected nodes or nodestrings are on the mesh boundary.

Boundary type combo box contains the conditions available for flow (listed above) for the selected entities.

Series data curve button selects the time series to be associated with the selected boundary type. The text label above this curve button will change with the boundary type to denote the type of input. Clicking on the curve button will open the Time Series editor (limited to the curve group of the boundary type). A second curve button will appear for boundary types that require two conditions with time series data.

Friction combo box specifies the type of bed shear stress to be applied to the boundary edge and is available only for Natural boundary types. The friction options are:

  • Manning's n provides the Manning's n roughness real number edit field limited to a value of 0.0 to 0.3.
  • Equivalent roughness height provides the Roughness height positive real number edit field.
  • Submerged aquatic vegetation provides the Undeflected stem height positive real number edit field.
  • Un-submerged rigid vegetation provides the Roughness height, Average stem diameter and Average stem density positive real number edit fields.

Pressure

This tab is always available.

Boundary type combo box contains the conditions available for pressure (listed above) for the selected entities.

Series data curve button selects the time series to be associated with the selected boundary type. The text label above this curve button will change with the boundary type to denote the type of input. Clicking on the curve button will open the Time Series editor (limited to the curve group of the boundary type).

Transport Constituents

This tab is only available if all of the currently selected nodes or nodestrings are on the mesh boundary and constituents have been included in Model Control Transport Constituents.

Boundary type combo box contains the conditions available for transport (listed above) for the selected entities.

Spreadsheet contains the following information specific to each transport type:

  • None clears the display of any information in the spreadsheet.
  • Dirichlet provides each defined constituent (first column) with a Include check box (second column), Specify Series... curve button (third column), and a series name cell (fourth column). To include the constituent in the specification of the transport condition, check the Include control and specify a concentration series by clicking on the Specify Series... button which will open the Time Series editor (limited to the Transport curve group). When a series has been defined, the name will be listed in the series name cell. A series can be selected by multiple constituents. The concentration series button and name cells are only enabled if the constituent is included in the transport source.
  • Equilibrium provides each defined sediment (first column) with a Include check box (second column) and a positive real number Initial concentration cell (third column). To include the sediment in the specification of the transport condition, check the Include control and specify a concentration (in parts per million). If the sediment is not to be present at the beginning of the simulation, specify a concentration of zero. The Initial concentration cell is only enabled if the sediment is included in the transport source.
  • Natural provides the same as Dirichlet.


Output (untitled group box)

Output calculated flow across this entity check box is available only for nodestrings and correlates to the FLX card.


Go to SMS:ADH page