User:Jcreer/SMS:AdH Interface: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(134 intermediate revisions by 2 users not shown)
Line 52: Line 52:
**''Draft of lid'' – Clicking '''Edit''' opens  the ''[[XY Series Editor]]'' dialog where draft values can be entered.
**''Draft of lid'' – Clicking '''Edit''' opens  the ''[[XY Series Editor]]'' dialog where draft values can be entered.


===Friction===
===Arc Friction===
[[File:AdH Friction.png|thumb|230 px|Example of the AdH Friction dialog]]
[[File:AdH Friction.png|thumb|230 px|Example of the AdH Friction dialog]]
Friction controls are used to compute estimated values of the friction induced by several types of bed roughness and linear roughness conditions.
Friction controls are used to compute estimated values of the friction induced by several types of bed roughness and linear roughness conditions.
Line 127: Line 127:
[[File:AdH SedimentDiversion.png|thumb|260 px|Example of the AdH Sediment Diversion dialog]]
[[File:AdH SedimentDiversion.png|thumb|260 px|Example of the AdH Sediment Diversion dialog]]
*''Sediment diversion'' – Turn on to include sediment diversion at the feature object location.
*''Sediment diversion'' – Turn on to include sediment diversion at the feature object location.
**Edgestring/midstring
**''Edgestring/midstring''
***Edgestring
***"Edgestring"
***Midstring
***"Midstring"
**Top elevation of the zone of withdrawal
**''Top elevation of the zone of withdrawal'' – Enter the highest elevation for withdrawal area.
**Bottom elevation of the zone of withdrawal
**''Bottom elevation of the zone of withdrawal'' – Enter the lowest elevation for withdrawal area.
**Bottom elevation of the main channel
**''Bottom elevation of the main channel'' – Enter the lowest elevation of the primary channel of the river or stream.
{{-}}
{{-}}


Line 200: Line 200:
===General===
===General===
The ''General'' tab of the AdH ''Material List and Properties'' dialog contains the following options:
The ''General'' tab of the AdH ''Material List and Properties'' dialog contains the following options:
*''Eddy viscosity method''
*''Eddy viscosity method'' – Defines the eddy viscosity for the simulation using one of two methods. Both methods cannot be used for
**''Estimated eddy viscosity weighing factor''
one material, but both can be used in a single model.
**''Estimated eddy viscosity method''
**"Estimated (EEV)" – Defines eddy viscosity utilizing an equation to estimate the value.
*''Refinement tolerance''
***''Estimated eddy viscosity weighing factor'' – Enter a value for the weighting factor.
*''Max refinement level''
***''Estimated eddy viscosity method'' – Select one of the following methods:
*''Wind properties''
****"1 – Isotropic"
**''Stress formulation''
****"2 – Anisotropic"
**''Attenuation''
****"3 – Smagorinsky"
*''Coriolis''
****"4 – Stansby"
**''Coriolis latitude''
**"Constant (EVS)" – Defines eddy viscosity through a user specified constant value.
*''Include meteorologic condition''
***''Vxx eddy viscosity''
**''Rain or evaporation''
***''Vxy eddy viscosity''
***''Vyy eddy viscosity''
*''Refinement tolerance'' – Enter a value to refine and relax the resolution of the model mesh during the simulation run.
*''Max refinement level'' – Enter a value for the maximum level of mesh refinement.
*''Wind properties'' – Check on to include wind stress calculations.
**''Stress formulation'' – Select the method that will be used for wind stress.
***"0 – no transform"
***"1 – Wu"
***"2 – Teeter"
**''Attenuation'' – Enter a scale factor to increase or decrease the wind shear stress magnitude.
*''Coriolis'' – Turn on to include the Coriolis force due to the earth’s rotation.
**''Coriolis latitude'' – Enter a value for the latitude in decimal degrees.
*''Include meteorologic condition'' – Turn on to include rain or evaporation for the material.
**''Rain or evaporation'' – Click the '''Edit''' button to open an ''XY Series Editor'' dialog where rainfall or evaporation data can be entered.


===Friction===
===Friction===
*''Friction''
*''Friction''
**Off
**"Off"  – No friction will be applied to the model.
**Manning's n (MNG)
**"Manning's n (MNG)"  – Friction will be applied using Manning's n.
***Manning's n
***''Manning's n'' – Specify the value of Manning's n.
**Manning's Equation (MNC)
**"Manning's Equation (MNC)"  – Friction will be applied using the classic formulation Manning's n.
***Manning's n
***''Manning's n'' – Specify the value of Manning's n.
**Equivalent roughness height (ERH)
**"Equivalent roughness height (ERH)" – Friction will be applied using  equivalent sand roughness height.
***Roughness height
***''Roughness height'' – Enter a value for the equivalent sand roughness height.
**Submerged aquatic vegetation (SAV)
**"Submerged aquatic vegetation (SAV)" – Compute the drag coefficient associated with the bottom shear stress resulting from a steady current field over a bed consisting of submerged aquatic vegetation.
***Roughness height of canopy
***''Roughness height of canopy'' – Enter a value for the roughness height of the SAV canopy.
***Undeflected stem height
***''Undeflected stem height'' – Enter a value for the undeflected stem height of the SAV.
**Un-submerged rigid vegetation (URV)
**"Un-submerged rigid vegetation (URV)" – Compute a shear stress coefficient for use in computing the bottom shear stress resulting from a steady current through rigid, unsubmerged vegetation.
***Bed roughness height
***''Bed roughness height'' – Enter a value for the bed roughness height.
***Average stem diameter
***''Average stem diameter'' – Enter a value for the average stem diameter.
***Average stem density
***''Average stem density'' – Enter a value for the average stem density.
**Equivalent drag obstructions (EDO)
**"Equivalent drag obstructions (EDO)"  – Computes a shear stress coefficient for use in computing the shear stress resulting from a steady  current through or over an evenly distributed field of flow obstructions.
***Bed roughness height
***''Bed roughness height'' – Enter a value for the bed roughness height.
***Obstruction diameter
***''Obstruction diameter'' – Enter a value for the average obstruction diameter.
***Obstruction height
***''Obstruction height'' – Enter a value for the average obstruction height.
**Ice friction (ICE, IRH, BRH)
**"Ice friction (ICE, IRH, BRH)" – Applies as a pressure field on the water surface to account for the effects that stationary ice on the water surface has on the flow below.
***Ice thickness
***''Ice thickness''
***Ice density
***''Ice density'' – Enter a value for the density of ice.
***Ice movement
***''Ice movement''
***Ice roughness height
***''Ice roughness height'' – Enter a value for the equivalent ice roughness height.
***Bed roughness height
***''Bed roughness height'' – Enter a value for the equivalent bed roughness height.
**Dune friction (DUN)
**"Dune friction (DUN)" – Enter a value for the bedform roughness calibration coefficient.
***Dune Factor
***''Dune Factor'' –
***Dune SEDLIB Inclusion
***''Dune SEDLIB Inclusion'' – Turn on to use the sediment model for bedload
***Dune D50
***''Dune D50'' – Enter a value for the d50 of the bed material.
***Dune D90
***''Dune D90'' – Enter a value for the d90 of the bed material.
*Include Seasonal Roughness Adjustment
*''Include Seasonal Roughness Adjustment''
**Roughness adjustment factor
**''Roughness adjustment factor''


===Transport===
===Transport===
The ''Transport'' tab allows adjusting the tolerance for transport constituents going through the material. The tab requires that a transport constituent component to be selected.


{{-}}
{{-}}
Line 292: Line 306:


=AdH Model Control=
=AdH Model Control=
The ''ADH Model Control'' dialog contains the graphical prompts for specifying model options.  The dialog is accessed through the ''ADH'' | '''Model Control...''' menu item.  
The ''ADH Model Control'' dialog contains the graphical prompts for specifying model options.  The dialog is accessed through right-clicking on the AdH simulation and selecting the  '''Model Control...''' item.  


The dialog is divided into several tabs which each contain a number of parameter options. Before [[SMS:ADH Run Model|running ADH]], set and review model control parameters. Entered data will be used to write the files employed in the ADH model run.
The dialog is divided into several tabs which each contain a number of parameter options. Before [[SMS:ADH Run Model|running ADH]], set and review model control parameters. Entered data will be used to write the files employed in the ADH model run.
Line 298: Line 312:
The available tabs are:
The available tabs are:


* Time  – Specifies the simulation duration. By default, ADH uses transient conditions, but steady state simulations can be specified.  
* ''Time'' – Specifies the simulation duration. By default, ADH uses transient conditions, but steady state simulations can be specified.  
* Control Iteration –
* ''Control Iteration'' – Specifies the level of precision for the conservation of mass and momentum.
* Control Operation –
* ''Control Operation'' – Specifies the number of processors and precoditioner.
* Model Control Output – Set parameters for how often solution data will be written.
* ''Model Control Output'' – Set parameters for how often solution data will be written.
* Control Constants –
* ''Control Constants'' – Contains global parameters that are set over the entire domain.
* Hot Start –
* ''Hot Start'' – Allows setting initial conditions for the simulation.
* Interface – Allows maintaining options which are not otherwise supported by the SMS interface.
* ''Interface'' – Allows maintaining options which are not otherwise supported by the SMS interface.


See the individual articles for each of the ADH model control tabs.
See the individual articles for each of the ADH model control tabs.
==Time==
==Time==
[[File:ADH Model Time Control.png|thumb|400 px| ''Time'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Time Control.png|thumb|400 px| ''Time'' tab of the ''ADH Model Control'' dialog]]
* ''Time'' option provides the following:
DH is set up as a transient conditions model, however, a steady state simulation can be invoked which utilizes an iterative process to converge to a solution. A steady state solution is accepted if the end time of the model is reached or the iteration tolerance requirement (see [[ SMS:ADH Model Control Model Parameters | Model Parameters ]]) is met. It's required to ensure that all series data are acceptable (constant linear series) if the steady state method is used. ADH also includes a quasi-unsteady method which strings multiple steady state simulation together to form a step function style hydrograph.
** ''Start'' time field
 
** ''Start time units'' numbered as seconds, minutes, hours, days, and weeks.   
Due to the nature of a steady state simulation, constituent transport and bed layers cannot be included in the simulation. If any constituent (and bed layer) is specified in a dynamic simulation and then the simulation is changed to steady state, SMS will clear the constituent data (and bed layer specification). A message will warn of this effect when the steady state simulation type is selected and constituent data (and a bed layer) exists. Another message will state that SMS has cleared the data (if steady state is still selected) when switching to another tab or exiting ''Model Control'' by selecting '''OK'''.
** ''End'' time field (with the defined start) specifies the simulation run length on the <font color="green">TC TF</font> card.
 
** ''End time units'' numbered as seconds, minutes, hours, days, and weeks.
Since series data specified for a dynamic simulation is usually inappropriate for a steady state simulation, a change in simulation type from dynamic to steady state will force SMS to clear all previously specified series data when changes are accepted in Model Control. This data is usually associated with the boundary conditions of materials, nodes, and nodestrings. A message will warn of this effect when the simulation type is changed and series data exists. Another message will state that SMS has cleared the data (if the simulation type remains changed) upon accepting the changes (exiting Model Control).
** ''Time step option'' lists one of three options:  
 
*** ''Steady state solution (TC STD)''
The following controls specify the timing parameters for the ADH model run.
**** ''Steady state min time step size''
 
**** ''Steady state max time step size''
''Time'' tab provides the following:
*** ''Time step series (SERIES DT)''
* ''Start time field'' &ndash; Input the start time for the simulation.
**** Max time step size time series'' opens an XY Series Editor
* ''Start time units''&ndash; Numbered as seconds, minutes, hours, days, or weeks.   
*** ''Auto Time Step Find (TC ATF)''
* ''End time'' &ndash; Field (with the defined start) specifies the simulation run length on the <font color="green">TC TF</font> card.
**** Auto time step find min time step size
* ''End time units'' &ndash; Numbered as seconds, minutes, hours, days, and weeks.
**** Auto time step find max time step size series
* ''Time step option'' &ndash; Lists one of three options:  
** "Steady state solution (TC STD)"
*** ''Steady state min time step size'' &ndash; The lowest the time step size should go.
*** ''Steady state max time step size'' &ndash; The highest the time step size should go.
** "Time step series (SERIES DT)"
*** ''Max Time Series size time differences'' &ndash; Clicking the '''Edit Series''' pulls up the ''XY Series Editor''.
** "Auto Time Step Find (TC ATF)"
*** ''Auto time step find min time step size''
*** ''Auto time step find max time step size series''
{{-}}
{{-}}


==Iteration==
==Iteration==
[[File:ADH Model Iteration Control.png|thumb|400 px| ''Iteration'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Iteration Control.png|thumb|400 px| ''Iteration'' tab of the ''ADH Model Control'' dialog]]
The ''Iterations'' tab allows specifying the level of precision for the conservation of mass and momentum as ADH performs its calculations. 


ADH solves conservation statements concerning water volume, momentum, and constituent mass. ADH is written in conservative form and thus can be regarded as both a finite element method and also a finite volume method. As such ADH can be shown to represent a sum of fluxes around the edge of an element to be in balance with the mass or volume change within the element. In the case of the momentum equation it will be a sum of fluxes and forces balancing the momentum change within an element.
ADH computes the water levels and velocities at each computation point in the domain for each time step in the simulation in an iterative process.  At the end of each iteration, calculations are made to determine how much the solution is changing and what the errors in conservation are.  If the errors are small, and the solution is not changing, the process is said to be converged and calculations can proceed to the next time step.  If the solution is changing and/or the errors in conservation are large, ADH can attempt another iteration.
There are several iteration parameter controls in ADH.  These are described in detail in the [http://chl.erdc.usace.army.mil/chl.aspx?p=m&a=MEDIA;1225 ADH users manual].  The Advanced options tab controls the linear iterations. This dialog controls the non-linear iteration parameters.
At the end of each iteration ADH computes the conservation properties for the current approximations of water depth and velocity.  If the errors are less than specified tolerance, the solver moves on to the next time step.  If the errors are greater than the specified tolerance, but still reasonable, and the maximum number of iterations specified on the IP NIT card has not been reached, ADH will attempt another iteration. If the errors have become unreasonable (divergence), ADH will exit the loop with a failure notification.  The controls in this dialog allow defining how ADH should determine convergence and how to proceed when convergence is not reached.
*''Non Linear Iterations'' &ndash; In this edit field specify the maximum number of iterations that ADH will try for a single time step
*''Non Linear Tolerance Options''
** "NTL (IP_NTL Card)" &ndash; If the "NTL" option is selected, ADH will check for non-linear convergence on the "maximum residual norm".  An initial estimate for an appropriate tolerance value for a problem can be computed. This is the maximum allowance. It will likely be desirable to set the tolerance higher than this estimate so the simulation will progress.
** "ITL (IP_ITL Card)" &ndash; If the ''ITL'' option is selected, ADH will check for non-linear convergence on the "maximum increment norm" or the change in the solution (velocity, depth and concentration).
** "Both" &ndash; If the ''Both'' option is selected, SMS will write both cards to the BC file and ADH will check for convergence on both terms.  Both must be satisfied for the solution to proceed.
*''Non Linear Residual Tolerance'' &ndash; Allows for a solution for residual non-linear iterations.
*''Non Linear Incremental Tolerance'' &ndash; Allows for a solution for incremental tolerance iterations.
*''Linear Iterations'' &ndash; used to solve a linear system of equations when using multiple processors.


{{-}}
{{-}}
Line 333: Line 373:
==Operation==
==Operation==
[[File:ADH Model Operation Control.png|thumb|400 px| ''Operation'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Operation Control.png|thumb|400 px| ''Operation'' tab of the ''ADH Model Control'' dialog]]
*''Physics''
** "SW2" &ndash; used to specify 2D shallow water flow modeling.
** "SW3" &ndash; used to specify 3D shallow water flow modeling
*''Incremental Memory''
*''Number of Processors''
*''Blocks per Processor''
*''Preconditioner type'' &ndash; Offers four different options:
**"0 &ndash; none"
**"1 &ndash; One level additive Schwartz"
**"2 &ndash; Two level additive Schwartz"
**"3 &ndash; Two level hybrid"
* ''Second order temporal coefficient active'' &ndash; Reduces numerical dissipation, higher order temporal schemes are often advantageous for problems where wave reflection is important.
* ''Petrov Galerkin coefficient active'' &ndash; can be included in the boundary condition file.
* ''Velocity gradient'' &ndash; will preform velocity gradient simulations.
* ''Wind'' &ndash; can be included at a single point, or several points, or through a wind field.
* ''Wave'' &ndash; when selected will perform wind simulations.
* ''Dam'' &ndash; when selected will perform dam break simulations.
{{-}}


==Output==
==Output==
[[File:ADH Model Output Control.png|thumb|400 px| ''Output'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Output Control.png|thumb|400 px| ''Output'' tab of the ''ADH Model Control'' dialog]]
ADH output files are specified in the [[SMS:ADH Model Control|''ADH Model Control'']] dialog on the ''Output'' tab
ADH will write solution data at startup and at each time step specified in a <font color="green">XY1</font> series definition and referred to by the <font color="green">OC</font> card. Flux data will be included with the solution data if output flow strings are specified (see [[ SMS:ADH Boundary Condition Assignment |assigning boundary conditions]]).
The following controls specify how often solution data will be written by ADH and the number of flux boundaries present.
*Output Control Options:
** "Specify Autobuild (OS)"
** "Specify Output Frequency (OC)"
** "Output Control Units" &ndash; This dropdown lets you choose seconds, minutes, hours, days, and weeks.
*'''Output Time''' &ndash; Combo box specifies the time unit the list box will display the output times in.
*'''Add [[File:GMS MODFLOW 6 - Add Row button.png|16 px]]''' &ndash; includes the time information from the above radio group in the times list box. Duplicate times will be automatically removed from the list.
*'''Delete [[File:GMS MODFLOW 6 - Delete Rows button.png|16 px]]'''  &ndash; removes the selected time(s) from the list box.
*''Print adaptive mesh'' &ndash; prints the mesh.
*''Print numerical fish surrogate'' &ndash; will print TecPlot format of the numerical fish surrogate.
*''Screen Output Residual'' &ndash; generates a portion of data that may not be explained in the model.
*''Screen Output All'' &ndash; This puts all the screen output out.
*''Screen Output Mass Error Active'' &ndash; This makes the mass error output active.
{{-}}


==Constants==
==Constants==
[[File:ADH Model Constants Control.png|thumb|400 px| ''Constants'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Constants Control.png|thumb|400 px| ''Constants'' tab of the ''ADH Model Control'' dialog]]
The ''Constants'' tab contains global parameters that are set over the entire domain.  These parameters will be global constants and independent of spatial variations within the model.
*''Kinematic Viscosity'' &ndash; Enter a postive real number for the kinematic viscosity.
*''Uniform background viscosity'' &ndash; Enter a positive real number for background viscosity.
*''Gravitation acceleration'' &ndash; Enter a positive real number for gravitation acceleration.
*''Density'' &ndash; Enter a positive real number for density.
*''Enable Wetting/drying'' &ndash; is check box and the associated wetting and drying process.  When this toggle is selected, AdH performs extra calculations for all cells with depth values less than the specified minimum to stabilize the process.  As the specified depth value increases, extra calculations also increase and model performance decreases.
**''Wet dry limit'' &ndash; ADH will decide the wet dry limit.
*''Mannings unit constant'' &ndash; Calculates changes in the model
{{-}}


==Hot Start==
==Hot Start==
[[File:ADH Model HotStart Control.png|thumb|400 px| ''Hot Start'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model HotStart Control.png|thumb|400 px| ''Hot Start'' tab of the ''ADH Model Control'' dialog]]
The hot start file contains the initial conditions for each node of a mesh. ADH allows for the specification of depth and velocity hydrodynamics, and sediment concentration and displacement datasets. The model requires at least depth initial conditions for hydrodynamics, and non-specified conditions.
*''Initial depth dataset (ioh)'' &ndash; Clicking the '''Select''' button here will bring up the ''Select initial depth dataset'' dialog. The initial depth dataset will be used for the initial depth at the start of the simulation.
*''Use Initial Velocity'' &ndash; Turn on the include initial velocity in the simulation.
**''Initial velocity dataset (iov)'' &ndash; Clicking the '''Select''' button will bring up the ''Select initial velocity dataset'' dialog. The initial velocity dataset will be used for the initial velocity at the start of the simulation.
{{-}}


==Advanced==
==Advanced==
AdH features not supported by SMS can be added in the ''ADH Model Control'' dialog by clicking on the ''Advanced'' tab.
SMS includes support for many of the features in ADH, however, this list of features is a dynamic set.  The user base of ADH includes a development team that is constantly experimenting with new options. 
This window allows SMS to maintain the options that are not otherwise supported by the interface.  For example, when SMS reads the BC file for an ADH simulation, and encounters a card that it does not recognize, that card is stored, verbatim, to a list of "Advanced Cards".  That list is displayed in this window.
Enter cards in this dialog to experiment with other new features in the model.  As those features are added to the list of supported features, they would automatically be moved to their own location in the model control the next time SMS reads the BC file.
Unsupported or advanced cards are written at the end of the BC file, just before the END card.  This relies on the attribute of ADH that does not require any order dependence in the BC file.




==Related Topics==
[[File:ADH Model Advanced Control.png|thumb|400 px| ''Advanced'' tab of the ''ADH Model Control'' dialog]]
[[File:ADH Model Advanced Control.png|thumb|400 px| ''Advanced'' tab of the ''ADH Model Control'' dialog]]
Model options not available in the interface can be specified under the ''Advanced'' tab. Each row in the spreadsheet will be saved as a different line in the *.bc file. The cards can be inserted and deleted using the '''Insert Row''' [[File:Insert Row Icon.svg|16 px]] and '''Delete Row''' [[File:Delete Row Icon.svg|16 px]] buttons.
*'''Add [[File:GMS MODFLOW 6 - Add Row button.png|16 px]]''' &ndash; button includes the information in the Card_Line.
*'''Delete [[File:GMS MODFLOW 6 - Delete Rows button.png|16 px]]''' &ndash; button removes the selected time(s) from the list box.
* The lines will be written out exactly as typed.
* The lines will be written out in the order in which they appear in the dialog.
* Any lines encountered in a *.bc file that is not recognized will appear in this list.
* Lines beginning with a "!" character are treated as comment lines and will be skipped over during a read.
* Comment lines are automatically generated and will not be preserved.
* All of these advanced cards will be grouped together at the bottom of the file regardless of where they appeared during reading.


{{-}}


==Related Topics==
*[[SMS:ADH Model Control | ADH Model Control]]
*[[SMS:ADH Model Control | ADH Model Control]]
=AdH Project Workflow=
This is a top level workflow. This workflow includes all of the specific workflows users will need to use in creating an [[SMS:ADH|ADH]] project. Newer and infrequent SMS users should start here.
To build an ADH model in SMS, use the following steps:
{| class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|1. Start a new SMS project.
|-
|
<blockquote>
{{SMS Project Setup Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|2. Import data.
|-
|
<blockquote>
{{SMS Import Data Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|3. Review and edit the elevation data.
|-
|
<blockquote>
{{SMS Review-Edit Elevation Data Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|4. Define model limits (domain extents).
|-
|
<blockquote>
{{SRH Define Model Limits Workflow}}
</blockquote>>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
! style="text-align:left;"|5. Generate a mesh.
|-
|
<blockquote>
{{SRH Generate Mesh Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|6. Define materials for AdH.
|-
|
<blockquote>
{{ADH Materials Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
! style="text-align:left;"|7. Define boundary conditions.
|-
|
<blockquote>
{{ADH Boundary Conditions Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|8. Create the AdH Simulation.
|-
|
<blockquote>
{{AdH Simulation Workflow}}
</blockquote>
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|9. Define the AdH model parameters.
|-
|
:# Right-click on the [[SMS:AdH Simulations|simulation]] and select the '''Model Control''' command.
:# Set the model parameters in the [[SMS:AdH Model Control|AdH ''Model Control'']] dialog.
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|10. Run the AdH Simulation.
|-
|
:# Right-click on the AdH simulation and select '''Save Project, Simulation and Run''']to run the simulation.
:#*Use the [[SMS:Simulations#Simulation_Run_Queue|''Simulation Run Queue'']] to track the model run.
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
|-
!style="text-align:left;"|11. Review results.
|-
|
<blockquote>
{{SMS Review Results Workflow}}
</blockquote>
|}
{{Navbox_SMS}}
{{Navbox_SMS}}


[[Category:ADH]]
[[Category:ADH]]

Latest revision as of 21:52, 17 October 2023

AdH Coverages

The AdH interface includes a few map coverages. These map coverages are used to provide input for the AdH simulation. AdH use the following model specific coverages:

  • Boundary Conditions
  • Materials
  • Sediment Materials

AdH Boundary Conditions

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).

The boundary conditions coverage for AdH allows assigning boundary condition attributes for both arcs and points.

Arc Attributes

Example of the AdH Arc Attributes dialog

The Arc Attributes dialog is reached by right-clicking on an arc in the AdH boundary conditions and selecting the Assign Arc Attributes command. In the dialog, the Arc type option have several boundary condition attributes for the selected arc. The following Arc type options are as follows:

  • "Off" – No attributes will be assigned to the arc.
  • "Natural outflow (OB OF)" – allows flow out without any modification to flow properties. Can be specified on boundaries where the exact flow conditions are unknown.
  • "Discharge (NB DIS)" – Applies subcritical inflow as a natural total discharge boundary condition.
    • Discharge – Clicking Edit opens the XY Series Editor dialog where discharge values can be entered.
  • "Flow (NB OVL)" – Applies inflow as a natural unit discharge boundary condition.
    • Flow per unit area – Clicking Edit opens the XY Series Editor dialog where discharge values can be entered.
  • "Water surface elevation (NB OTW)" – Links a particular time series of water surface elevation to the boundary condition.
    • Elevation – Clicking Edit opens the XY Series Editor dialog where water surface elevation values can be entered.
  • "Spillway (NB SPL)" – Specifies spillway flow.
    •  % flow out – Clicking Edit opens the XY Series Editor dialog where weir coefficient values can be entered.
  • "Tidal boundary (NB TID)" – Indicates tidal constituents will be applied to the boundary.
  • "Stage discharge boundary (NB SDR)" – Specifies a stage-discharge boundary.
    • Coefficient – Specified constants for coefficients A–E.
  • "Velocity and depth (DB OVH)" – Dirichlet boundary condition for supercritical flow.
    • Snapping type – Defines how the boundary conditions are applied to mesh.
      • "Point snap" – Applies the attributes to the mesh nodes or points upon export.
      • "Edgestring snap" – Applies the attributes to the mesh element edge upon export.
      • "Midstring snap" – Applies the attributes to the center of the mesh elements upon export.
    • X velocity – Clicking Edit opens the XY Series Editor dialog where x-velocity values can be entered.
    • Y velocity – Clicking Edit opens the XY Series Editor dialog where y-velocity values can be entered.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Stationary lid elevation (DB LDE)" – Allows assigning lid elevations to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Elevation – Clicking Edit opens the XY Series Editor dialog where elevation values can be entered.
  • "Depth of water under stationary lid (DB LDH)" – Allows assigning lid depths to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Floating stationary object (DB LID)" – Allows assigning liddraft to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Draft of lid – Clicking Edit opens the XY Series Editor dialog where draft values can be entered.

Arc Friction

Example of the AdH Friction dialog

Friction controls are used to compute estimated values of the friction induced by several types of bed roughness and linear roughness conditions.

Friction can be applied to a feature arc by right-clicking on the arc and selecting the Assign Friction command. In the Friction dialog, specify the Friction type as one of the following options:

  • "Off" – No friction will be applied to the arc.
  • "Manning's N (MNG)" – Friction will be applied using Manning's n.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n – Specify the value of Manning's n.
  • "Manning's Equation (MNC)" – Friction will be applied using the classic formulation Manning's n.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n – Specify the value of Manning's n.
  • "Equivalent roughness height (ERH)" – Friction will be applied using equivalent sand roughness height.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height – Enter a value for the equivalent sand roughness height.
  • "Submerged aquatic vegetation (SAV)" – Compute the drag coefficient associated with the bottom shear stress resulting from a steady current field over a bed consisting of submerged aquatic vegetation.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height of canopy – Enter a value for the roughness height of the SAV canopy.
    • Undeflected stem height – Enter a value for the undeflected stem height of the SAV.
  • "Un-submerged rigid vegetation (URV)" – Compute a shear stress coefficient for use in computing the bottom shear stress resulting from a steady current through rigid, unsubmerged vegetation.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height – Enter a value for the bed roughness height.
    • Average stem diameter – Enter a value for the average stem diameter.
    • Average stem density – Enter a value for the average stem density.
  • "Equivalent drag obstructions (EDO)" – Computes a shear stress coefficient for use in computing the shear stress resulting from a steady current through or over an evenly distributed field of flow obstructions.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height – Enter a value for the bed roughness height.
    • Obstruction diameter – Enter a value for the average obstruction diameter.
    • Obstruction height – Enter a value for the average obstruction height.
  • "Ice friction (ICE, IRH, BRH)" – Applies as a pressure field on the water surface to account for the effects that stationary ice on the water surface has on the flow below.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Ice thickness
    • Ice density – Enter a value for the density of ice.
    • Ice movement
    • Ice roughness height – Enter a value for the equivalent ice roughness height.
    • Bed roughness height – Enter a value for the equivalent bed roughness height.
  • "Dune friction (DUN)" – Invokes the bedform friction model.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Dune factor – Enter a value for the bedform roughness calibration coefficient.
    • Dune SEDLIB Inclusion – Turn on to use the sediment model for bedload
    • Dune D50 – Enter a value for the d50 of the bed material.
    • Dune D90 – Enter a value for the d90 of the bed material.
  • "Submerged dike (SDK)" – Simulates the loss associated with the expansion of flow downstream of a submerged dike or weir.
    • Dike height – Enter a value for the height of the dike above the bed.
  • "Bridge deck (BRD)" – Simulates the the loss associated with a bridge deck.
    • Bridge deck elevation – Enter a value for the elevation of the bridge deck.
    • Bridge deck thickness – Enter a value for the thickness of the bridge deck.

Flux Output

The Flux Output dialog

The flux output calculates of flow and constituent mass across strings. To assign flux to a feature arc, right-click on the arc and select the Assign Flux command to open the Flux Output dialog. The Flux Output dialog contains the following options:

  • Flux output – Turn on to include fluz output calculations in the model run.
  • Edgestring – Select if the flux output is to be calculated along the edge of the mesh domain.
  • Midstring – Select if the flux output is to be calculated from internal strings inside the mesh domain.


Sediment Diversion

Example of the AdH Sediment Diversion dialog
  • Sediment diversion – Turn on to include sediment diversion at the feature object location.
    • Edgestring/midstring
      • "Edgestring"
      • "Midstring"
    • Top elevation of the zone of withdrawal – Enter the highest elevation for withdrawal area.
    • Bottom elevation of the zone of withdrawal – Enter the lowest elevation for withdrawal area.
    • Bottom elevation of the main channel – Enter the lowest elevation of the primary channel of the river or stream.


Arc Transport Constituents

Example of the Arc Transport Constituent dialog

The Arc Transport Constituents dialog allows assigning transport constituents to an arc. This requires that transport constituents component to have been created in the AdH simulation. To assign transport constituents to a feature arc, right-click on the arc and select the Assign Arc Transport command to open the Arc Transport Constituents dialog. The Arc Transport Constituents dialog contains the following options:

  • Transport constituents – Turning on this option will allow assigning transport constituents.
    • Transport constituents – Clicking the Select button will open the Select Transport Constituent dialog where a transport component can be selected. Once the transport component has been selected, the table in this section can be completed.
      • Name – This column will display the name of the transport constituents that are active in the Transport Constituents dialog.
      • Type – This column allows setting the transport constituent to be "None", "Dirichlet", or "Natural".
      • Time Series – This column becomes active if the "Dirichlet" or "Natural" type is selected. Clicking the Edit Curve button will open the XY Series Editor dialog where the time series can be entered.
      • Snapping Method
  • Sediment transport constituents – Turning on this option will allow assigning sediment transport constituents.
    • Sediment transport constituents – Clicking the Select button will open the Select Sediment Transport Constituent dialog where a transport component can be selected. Once the transport component has been selected, the table in this section can be completed.
      • Name – This column will display the name of the transport constituents that are active in the Sediment Transport Constituents dialog.
      • Type – This column allows setting the transport constituent to be "None", "Dirichlet", or "Natural".
      • Time Series – This column becomes active if the "Dirichlet" or "Natural" type is selected. Clicking the Edit Curve button will open the XY Series Editor dialog where the time series can be entered.
      • Snapping Method

Select Transport Constituents

Example of the AdH Select Transport Constituents dialog

When working with transport constituents, the transport constituent component in the simulation needs be attached to transport constituents attributes assigned to feature objects. In the Project Explorer, right-clicking on the AdH boundary condition coverage and selecting the Assign Transport command will being up the Select Transport Constituents dialog. This dialog allows assigning the transport feature object attributes to the transport components.

  • Transport constituents – Clicking the Select button in this section will being up the Select Transport Constituents dialog. In the Select Transport Constituents dialog, the transport component can be assigned to the coverage.
  • Sediment transport constituents – Clicking the Select button in this section will being up the Select Sediment Transport Constituents dialog. In the Select Sediment Transport Constituents dialog, the transport component can be assigned to the coverage.

Point Attributes

Example of the AdH Point Attributes dialog

The Point Attributes dialog is reached by right-clicking on a point in the AdH boundary conditions and selecting the Assign Point Attributes command. In the dialog, the Point type option have several boundary condition attributes for the selected point. The following Point type options are as follows:

  • "Off" – No attributes will be assigned to the point.
  • "Velocity and depth (DB OVH)" – Dirichlet boundary condition for supercritical flow.
    • X velocity – Clicking Edit opens the XY Series Editor dialog where x-velocity values can be entered.
    • Y velocity – Clicking Edit opens the XY Series Editor dialog where y-velocity values can be entered.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Stationary lid elevation (DB LDE)" – Allows assigning lid elevations to an arc.
    • Elevation – Clicking Edit opens the XY Series Editor dialog where elevation values can be entered.
  • "Depth of water under stationary lid (DB LDH)" – Allows assigning lid depths to an arc.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Floating stationary object (DB LID)" – Allows assigning liddraft to an arc.
    • Draft of lid – Clicking Edit opens the XY Series Editor dialog where draft values can be entered.
  • "Wind Definition (OP WND)" – Defines wind stressing.
    • Wind – Clicking Edit opens the XY Series Editor dialog where wind values can be entered.

Point Transport Constituents

Example of the Point Transport Constituent dialog

The Point Transport Constituents dialog allows assigning transport constituents to a point. This requires that transport constituents component to have been created in the AdH simulation. To assign transport constituents to a feature point, right-click on the point and select the Assign Point Transport command to open the Point Transport Constituents dialog. The Popint Transport Constituents dialog contains the following options:

  • Transport constituents – Turning on this option will allow assigning transport constituents.
    • Transport constituents – Clicking the Select button will open the Select Transport Constituent dialog where a transport component can be selected. Once the transport component has been selected, the table in this section can be completed.
      • Name – This column will display the name of the transport constituents that are active in the Transport Constituents dialog.
      • Type – This column allows setting the transport constituent to be "None" or "Dirichlet".
      • Time Series – This column becomes active if the "Dirichlet" type is selected. Clicking the Edit Curve button will open the XY Series Editor dialog where the time series can be entered.
  • Sediment transport constituents – Turning on this option will allow assigning sediment transport constituents.
    • Sediment transport constituents – Clicking the Select button will open the Select Sediment Transport Constituent dialog where a transport component can be selected. Once the transport component has been selected, the table in this section can be completed.
      • Name – This column will display the name of the transport constituents that are active in the Sediment Transport Constituents dialog.
      • Type – This column allows setting the transport constituent to be "None" or "Dirichlet".
      • Time Series – This column becomes active if the "Dirichlet" type is selected. Clicking the Edit Curve button will open the XY Series Editor dialog where the time series can be entered.

AdH Materials

Example of the AdH Material Lists and Properties dialog

Material properties are set for AdH on an AdH materials coverage. In the Project Explorer, define the material attributes by right-clicking the materials coverage and selecting Material List and Properties to open the Material List and Properties dialog. The Material List and Properties dialog contains the following options:

  • Transport constituents – Turning on this option will allow assigning transport constituents.
    • Transport constituents – Clicking the Select button will open the Select Transport Constituent dialog where a transport component can be selected.
  • Add Rows Row-add.svg – Adds a material item to the list below this.
  • Delete Rows Row-delete.svg – Removes a selected material.
  • Change all material textures Texture Button Icon.png – Brings up the Texture Attributes dialog where the texture for all materials can be changed.
  • Import – Brings up an Open dialog where an AdH material file (*.adh_mat) can be imported into the dialog.
  • Export – Brings up a Save dialog where an AdH materila file (*adh_mat) can be exported.
  • Material list – The Materials list contains two columns (Color and Name) for the defined materials. The default "OFF" material cannot be edited (except the display pattern) and will always be at the top of the spreadsheet regardless of sorting. Each material is accompanied by a Color button in the Color column. To select a color and pattern, click on the button to open the Texture Attributes window. On the right side of the dialog, the numeric properties of the material are displayed and can be edited.

General

The General tab of the AdH Material List and Properties dialog contains the following options:

  • Eddy viscosity method – Defines the eddy viscosity for the simulation using one of two methods. Both methods cannot be used for

one material, but both can be used in a single model.

    • "Estimated (EEV)" – Defines eddy viscosity utilizing an equation to estimate the value.
      • Estimated eddy viscosity weighing factor – Enter a value for the weighting factor.
      • Estimated eddy viscosity method – Select one of the following methods:
        • "1 – Isotropic"
        • "2 – Anisotropic"
        • "3 – Smagorinsky"
        • "4 – Stansby"
    • "Constant (EVS)" – Defines eddy viscosity through a user specified constant value.
      • Vxx eddy viscosity
      • Vxy eddy viscosity
      • Vyy eddy viscosity
  • Refinement tolerance – Enter a value to refine and relax the resolution of the model mesh during the simulation run.
  • Max refinement level – Enter a value for the maximum level of mesh refinement.
  • Wind properties – Check on to include wind stress calculations.
    • Stress formulation – Select the method that will be used for wind stress.
      • "0 – no transform"
      • "1 – Wu"
      • "2 – Teeter"
    • Attenuation – Enter a scale factor to increase or decrease the wind shear stress magnitude.
  • Coriolis – Turn on to include the Coriolis force due to the earth’s rotation.
    • Coriolis latitude – Enter a value for the latitude in decimal degrees.
  • Include meteorologic condition – Turn on to include rain or evaporation for the material.
    • Rain or evaporation – Click the Edit button to open an XY Series Editor dialog where rainfall or evaporation data can be entered.

Friction

  • Friction
    • "Off" – No friction will be applied to the model.
    • "Manning's n (MNG)" – Friction will be applied using Manning's n.
      • Manning's n – Specify the value of Manning's n.
    • "Manning's Equation (MNC)" – Friction will be applied using the classic formulation Manning's n.
      • Manning's n – Specify the value of Manning's n.
    • "Equivalent roughness height (ERH)" – Friction will be applied using equivalent sand roughness height.
      • Roughness height – Enter a value for the equivalent sand roughness height.
    • "Submerged aquatic vegetation (SAV)" – Compute the drag coefficient associated with the bottom shear stress resulting from a steady current field over a bed consisting of submerged aquatic vegetation.
      • Roughness height of canopy – Enter a value for the roughness height of the SAV canopy.
      • Undeflected stem height – Enter a value for the undeflected stem height of the SAV.
    • "Un-submerged rigid vegetation (URV)" – Compute a shear stress coefficient for use in computing the bottom shear stress resulting from a steady current through rigid, unsubmerged vegetation.
      • Bed roughness height – Enter a value for the bed roughness height.
      • Average stem diameter – Enter a value for the average stem diameter.
      • Average stem density – Enter a value for the average stem density.
    • "Equivalent drag obstructions (EDO)" – Computes a shear stress coefficient for use in computing the shear stress resulting from a steady current through or over an evenly distributed field of flow obstructions.
      • Bed roughness height – Enter a value for the bed roughness height.
      • Obstruction diameter – Enter a value for the average obstruction diameter.
      • Obstruction height – Enter a value for the average obstruction height.
    • "Ice friction (ICE, IRH, BRH)" – Applies as a pressure field on the water surface to account for the effects that stationary ice on the water surface has on the flow below.
      • Ice thickness
      • Ice density – Enter a value for the density of ice.
      • Ice movement
      • Ice roughness height – Enter a value for the equivalent ice roughness height.
      • Bed roughness height – Enter a value for the equivalent bed roughness height.
    • "Dune friction (DUN)" – Enter a value for the bedform roughness calibration coefficient.
      • Dune Factor
      • Dune SEDLIB Inclusion – Turn on to use the sediment model for bedload
      • Dune D50 – Enter a value for the d50 of the bed material.
      • Dune D90 – Enter a value for the d90 of the bed material.
  • Include Seasonal Roughness Adjustment
    • Roughness adjustment factor

Transport

The Transport tab allows adjusting the tolerance for transport constituents going through the material. The tab requires that a transport constituent component to be selected.


AdH Sediment Materials

AdH Simulation

Example of an AdH simulation in the Project Explorer

Simulations are available for AdH starting in SMS 13.3. A simulation should contain a 2D mesh and an AdH boundary conditions coverage, and optional AdH coverages. Right-clicking on the simulation will display options and dialogs.

To create a new simulation:

  1. Right-click on empty space in the Project Explorer and select New Simulation | AdH. A new tree item Simulation Folder Icon.svg will appear.
  2. Drag and drop simulation components under the newly created simulation tree item Simulation Icon.svg. Components available include:
    • 2D mesh
    • Boundary Conditions coverage
    • Materials coverage

Multiple AdH simulations can be included in a single project.

Simulation Components

An AdH simulation uses the following components in the model run:

  • 2D mesh – Any generic 2D mesh will work. Generally this mesh should be created from the Mesh Generation coverage.
  • Boundary Conditions coverage – Contains arcs defining the boundary condition attributes for the model run.
  • Materials coverage – Allows creating recording stations at specified nodal locations.
  • Sediment Material coverage –

Each component can be added to the simulation by selecting the component and dragging it under the simulation item Simulation Icon.svg in the Project Explorer. Linked 2D mesh Mesh Link.svg and coverages Coverage Link.svg will be displayed under the simulation.

Linking Components

After a simulation has been created, components may be added to the simulation. Components are usually added by clicking on the component item in the Project Explorer and dragging the item under the AdH simulation. A link Mesh Link.svg is then created between the component and the simulation.

Components can also be added to a simulation by right-clicking on the component in the project explorer and selecting the simulation name in the Apply To submenu. The Apply To submenu becomes available once a simulation has been created.

Components can be removed by right-clicking on the component link under the simulation and select Remove.

If a component is updated, it must be reapplied to the simulation.

Running the AdH Simulation

After all components have been added to the simulation and the model parameters have been established, the simulation can be run. This is done by right-clicking on the simulation and choosing the Run Simulation command or the Save and Run Simulation command.

The simulation run involves three steps.

  1. Exporting the AdH files – SMS writes out an AdH folder in the same directory where the SMS project is saved. The AdH folder has several files which have mesh geometry information, and boundary conditions as well as model control information defined in the model.
  2. Running AdH – After using a launch command, the Simulation Run Queue dialog will appear. If there are any errors in the model run, the model wrapper will exit early. The model run can also be exited early by clicking the Abort button. When the model run is completed, select Exit to close the model wrapper.

The Load solution button appears with the model run has finished. Clicking this button will load the solution into SMS.

AdH Model Control

The ADH Model Control dialog contains the graphical prompts for specifying model options. The dialog is accessed through right-clicking on the AdH simulation and selecting the Model Control... item.

The dialog is divided into several tabs which each contain a number of parameter options. Before running ADH, set and review model control parameters. Entered data will be used to write the files employed in the ADH model run.

The available tabs are:

  • Time – Specifies the simulation duration. By default, ADH uses transient conditions, but steady state simulations can be specified.
  • Control Iteration – Specifies the level of precision for the conservation of mass and momentum.
  • Control Operation – Specifies the number of processors and precoditioner.
  • Model Control Output – Set parameters for how often solution data will be written.
  • Control Constants – Contains global parameters that are set over the entire domain.
  • Hot Start – Allows setting initial conditions for the simulation.
  • Interface – Allows maintaining options which are not otherwise supported by the SMS interface.

See the individual articles for each of the ADH model control tabs.

Time

Time tab of the ADH Model Control dialog

DH is set up as a transient conditions model, however, a steady state simulation can be invoked which utilizes an iterative process to converge to a solution. A steady state solution is accepted if the end time of the model is reached or the iteration tolerance requirement (see Model Parameters ) is met. It's required to ensure that all series data are acceptable (constant linear series) if the steady state method is used. ADH also includes a quasi-unsteady method which strings multiple steady state simulation together to form a step function style hydrograph.

Due to the nature of a steady state simulation, constituent transport and bed layers cannot be included in the simulation. If any constituent (and bed layer) is specified in a dynamic simulation and then the simulation is changed to steady state, SMS will clear the constituent data (and bed layer specification). A message will warn of this effect when the steady state simulation type is selected and constituent data (and a bed layer) exists. Another message will state that SMS has cleared the data (if steady state is still selected) when switching to another tab or exiting Model Control by selecting OK.

Since series data specified for a dynamic simulation is usually inappropriate for a steady state simulation, a change in simulation type from dynamic to steady state will force SMS to clear all previously specified series data when changes are accepted in Model Control. This data is usually associated with the boundary conditions of materials, nodes, and nodestrings. A message will warn of this effect when the simulation type is changed and series data exists. Another message will state that SMS has cleared the data (if the simulation type remains changed) upon accepting the changes (exiting Model Control).

The following controls specify the timing parameters for the ADH model run.

Time tab provides the following:

  • Start time field – Input the start time for the simulation.
  • Start time units– Numbered as seconds, minutes, hours, days, or weeks.
  • End time – Field (with the defined start) specifies the simulation run length on the TC TF card.
  • End time units – Numbered as seconds, minutes, hours, days, and weeks.
  • Time step option – Lists one of three options:
    • "Steady state solution (TC STD)"
      • Steady state min time step size – The lowest the time step size should go.
      • Steady state max time step size – The highest the time step size should go.
    • "Time step series (SERIES DT)"
      • Max Time Series size time differences – Clicking the Edit Series pulls up the XY Series Editor.
    • "Auto Time Step Find (TC ATF)"
      • Auto time step find min time step size
      • Auto time step find max time step size series


Iteration

Iteration tab of the ADH Model Control dialog

The Iterations tab allows specifying the level of precision for the conservation of mass and momentum as ADH performs its calculations.

ADH solves conservation statements concerning water volume, momentum, and constituent mass. ADH is written in conservative form and thus can be regarded as both a finite element method and also a finite volume method. As such ADH can be shown to represent a sum of fluxes around the edge of an element to be in balance with the mass or volume change within the element. In the case of the momentum equation it will be a sum of fluxes and forces balancing the momentum change within an element.

ADH computes the water levels and velocities at each computation point in the domain for each time step in the simulation in an iterative process. At the end of each iteration, calculations are made to determine how much the solution is changing and what the errors in conservation are. If the errors are small, and the solution is not changing, the process is said to be converged and calculations can proceed to the next time step. If the solution is changing and/or the errors in conservation are large, ADH can attempt another iteration.

There are several iteration parameter controls in ADH. These are described in detail in the ADH users manual. The Advanced options tab controls the linear iterations. This dialog controls the non-linear iteration parameters.

At the end of each iteration ADH computes the conservation properties for the current approximations of water depth and velocity. If the errors are less than specified tolerance, the solver moves on to the next time step. If the errors are greater than the specified tolerance, but still reasonable, and the maximum number of iterations specified on the IP NIT card has not been reached, ADH will attempt another iteration. If the errors have become unreasonable (divergence), ADH will exit the loop with a failure notification. The controls in this dialog allow defining how ADH should determine convergence and how to proceed when convergence is not reached.

  • Non Linear Iterations – In this edit field specify the maximum number of iterations that ADH will try for a single time step
  • Non Linear Tolerance Options
    • "NTL (IP_NTL Card)" – If the "NTL" option is selected, ADH will check for non-linear convergence on the "maximum residual norm". An initial estimate for an appropriate tolerance value for a problem can be computed. This is the maximum allowance. It will likely be desirable to set the tolerance higher than this estimate so the simulation will progress.
    • "ITL (IP_ITL Card)" – If the ITL option is selected, ADH will check for non-linear convergence on the "maximum increment norm" or the change in the solution (velocity, depth and concentration).
    • "Both" – If the Both option is selected, SMS will write both cards to the BC file and ADH will check for convergence on both terms. Both must be satisfied for the solution to proceed.
  • Non Linear Residual Tolerance – Allows for a solution for residual non-linear iterations.
  • Non Linear Incremental Tolerance – Allows for a solution for incremental tolerance iterations.
  • Linear Iterations – used to solve a linear system of equations when using multiple processors.


Operation

Operation tab of the ADH Model Control dialog
  • Physics
    • "SW2" – used to specify 2D shallow water flow modeling.
    • "SW3" – used to specify 3D shallow water flow modeling
  • Incremental Memory
  • Number of Processors
  • Blocks per Processor
  • Preconditioner type – Offers four different options:
    • "0 – none"
    • "1 – One level additive Schwartz"
    • "2 – Two level additive Schwartz"
    • "3 – Two level hybrid"
  • Second order temporal coefficient active – Reduces numerical dissipation, higher order temporal schemes are often advantageous for problems where wave reflection is important.
  • Petrov Galerkin coefficient active – can be included in the boundary condition file.
  • Velocity gradient – will preform velocity gradient simulations.
  • Wind – can be included at a single point, or several points, or through a wind field.
  • Wave – when selected will perform wind simulations.
  • Dam – when selected will perform dam break simulations.


Output

Output tab of the ADH Model Control dialog

ADH output files are specified in the ADH Model Control dialog on the Output tab

ADH will write solution data at startup and at each time step specified in a XY1 series definition and referred to by the OC card. Flux data will be included with the solution data if output flow strings are specified (see assigning boundary conditions).

The following controls specify how often solution data will be written by ADH and the number of flux boundaries present.

  • Output Control Options:
    • "Specify Autobuild (OS)"
    • "Specify Output Frequency (OC)"
    • "Output Control Units" – This dropdown lets you choose seconds, minutes, hours, days, and weeks.
  • Output Time – Combo box specifies the time unit the list box will display the output times in.
  • Add GMS MODFLOW 6 - Add Row button.png – includes the time information from the above radio group in the times list box. Duplicate times will be automatically removed from the list.
  • Delete GMS MODFLOW 6 - Delete Rows button.png – removes the selected time(s) from the list box.
  • Print adaptive mesh – prints the mesh.
  • Print numerical fish surrogate – will print TecPlot format of the numerical fish surrogate.
  • Screen Output Residual – generates a portion of data that may not be explained in the model.
  • Screen Output All – This puts all the screen output out.
  • Screen Output Mass Error Active – This makes the mass error output active.



Constants

Constants tab of the ADH Model Control dialog

The Constants tab contains global parameters that are set over the entire domain. These parameters will be global constants and independent of spatial variations within the model.

  • Kinematic Viscosity – Enter a postive real number for the kinematic viscosity.
  • Uniform background viscosity – Enter a positive real number for background viscosity.
  • Gravitation acceleration – Enter a positive real number for gravitation acceleration.
  • Density – Enter a positive real number for density.
  • Enable Wetting/drying – is check box and the associated wetting and drying process. When this toggle is selected, AdH performs extra calculations for all cells with depth values less than the specified minimum to stabilize the process. As the specified depth value increases, extra calculations also increase and model performance decreases.
    • Wet dry limit – ADH will decide the wet dry limit.
  • Mannings unit constant – Calculates changes in the model


Hot Start

Hot Start tab of the ADH Model Control dialog

The hot start file contains the initial conditions for each node of a mesh. ADH allows for the specification of depth and velocity hydrodynamics, and sediment concentration and displacement datasets. The model requires at least depth initial conditions for hydrodynamics, and non-specified conditions.

  • Initial depth dataset (ioh) – Clicking the Select button here will bring up the Select initial depth dataset dialog. The initial depth dataset will be used for the initial depth at the start of the simulation.
  • Use Initial Velocity – Turn on the include initial velocity in the simulation.
    • Initial velocity dataset (iov) – Clicking the Select button will bring up the Select initial velocity dataset dialog. The initial velocity dataset will be used for the initial velocity at the start of the simulation.


Advanced

AdH features not supported by SMS can be added in the ADH Model Control dialog by clicking on the Advanced tab.

SMS includes support for many of the features in ADH, however, this list of features is a dynamic set. The user base of ADH includes a development team that is constantly experimenting with new options.

This window allows SMS to maintain the options that are not otherwise supported by the interface. For example, when SMS reads the BC file for an ADH simulation, and encounters a card that it does not recognize, that card is stored, verbatim, to a list of "Advanced Cards". That list is displayed in this window.

Enter cards in this dialog to experiment with other new features in the model. As those features are added to the list of supported features, they would automatically be moved to their own location in the model control the next time SMS reads the BC file.

Unsupported or advanced cards are written at the end of the BC file, just before the END card. This relies on the attribute of ADH that does not require any order dependence in the BC file.


Advanced tab of the ADH Model Control dialog

Model options not available in the interface can be specified under the Advanced tab. Each row in the spreadsheet will be saved as a different line in the *.bc file. The cards can be inserted and deleted using the Insert Row Insert Row Icon.svg and Delete Row Delete Row Icon.svg buttons.

  • Add GMS MODFLOW 6 - Add Row button.png – button includes the information in the Card_Line.
  • Delete GMS MODFLOW 6 - Delete Rows button.png – button removes the selected time(s) from the list box.
  • The lines will be written out exactly as typed.
  • The lines will be written out in the order in which they appear in the dialog.
  • Any lines encountered in a *.bc file that is not recognized will appear in this list.
  • Lines beginning with a "!" character are treated as comment lines and will be skipped over during a read.
  • Comment lines are automatically generated and will not be preserved.
  • All of these advanced cards will be grouped together at the bottom of the file regardless of where they appeared during reading.


Related Topics

AdH Project Workflow

This is a top level workflow. This workflow includes all of the specific workflows users will need to use in creating an ADH project. Newer and infrequent SMS users should start here.

To build an ADH model in SMS, use the following steps:

1. Start a new SMS project.
1. Start SMS, or clear existing projects in SMS.
  1. If SMS is already running, select File | Delete All.
  2. A new project can also be started by using CTRL + N.
2. Set the display projection.
  1. Select the Display | Projection... command.
  2. Set the horizontal and vertical projection using the Display Projection dialog.
2. Import data.
1. Gather and open image files.

Images are imported into the GIS module in SMS.

1. Open local images.
  1. Load images from local computer files using the File | Open... command.
  2. Alternatively, drag and drop the file into the Graphics Window in SMS.
2. Import images from the web.
1. Import static images.
  1. Use the File | Import from Web command.
  2. Select a location in the Virtual Map Locator.
  3. Set a projection for the project using the Display Projections dialog.
  4. Use the Data Service Options dialog to select a web service or catalog.
    • Use the Advanced options if needing to access a unique or unavailable data source.
  5. Save the data file and import the data into SMS.
2. Import dynamic images.
  1. Use the File | Add Online Maps command.
  2. Select a location in the Virtual Map Locator.
  3. Set a projection for the project using the Display Projections dialog.
  4. Use the Data Service Options dialog to select a web service or catalog.
  5. Save the data file and import the data into SMS.
2. Gather and open geometric data files.
1. Import map data.
  1. Use the File | Open... command to import map data such as Map files, boundary ID files, or boundary XY files.
  2. Alternately, drag and drop the file into the Graphics Window in SMS.
2. Import GIS data.
  1. Use the File | Open... command to import GIS data files such as Shapefiles, MIF/MID files, Lidar files, or raster files.
  2. Alternatively, drag and drop the file into the Graphics Window in SMS.
3. Import scatter data.
  1. Use File | Open... to open files with scatter data such as scatter point files, ASCII dataset files, binary dataset files, tabular data files, or XYZ files.
  2. Alternatively, drag and drop the file into the Graphics Window in SMS.
  3. Use the File Import Wizard to specify how to import the data.
4. Import CAD data.
  1. Verify the CAD file type is readable by SMS before importing it. SMS can import DXF and DWG files.
  2. Use the File | Open... command to launch the Open dialog (or drag and drop) to import the CAD files.
The data should load in layers into the Project Explorer.
5. Review and set object projections.
  1. Right-click on an object in the Project Explorer and select the Projection command.
  2. Set the horizontal and vertical projection using the Object Projection dialog.
  3. To set a global projection, use the Horizontal Projection dialog.
3. Review and edit the elevation data.
1. Review elevation data for errors.
1. Use the Dataset Info dialog.
  1. Find the "Z", "elevation" or "depth" datasets on the geometric object (mesh, TIN, grid, raster) that is being reviewed
  2. Right-click on elevation data and select Info.
  3. Review information in the Dataset Info dialog to see that the range of values are as expected.
2. Use contour display options.
  1. Turn off Points and Triangles, then turn on Contours in the Scatter tab of the Display Options dialog.
  2. Set contour options in the Contours tab. The "Color Fill" option is recommended for this.
  3. Look for inconsistent points (points with values much higher/lower than their neighbors or regions where no data points exist).
  4. Verify that the region being modeled is covered by the elevation/depth data and there are no holes.
3. Rotate the elevation data.
  1. Use the Rotate Rotate Tool.svg tool to examine the elevation data from different angles.
2. Remove erroneous points and triangles.
After reviewing the imported data, points or triangles covering regions where there are no data points should be deleted. This could include outlier points or thin triangles.
1. Use the Scatter Options dialog.
  1. Open the Scatter Options dialog.
  2. Select or delete duplicate points.
  3. Select or delete long triangles.
  4. Select thin triangles.
  5. Use a triangulation optimization option.
2. Manually remove points.
  1. Use Select Scatter Point Select Point Tool.svg tool to select erroneous points in the scatter set.
  2. Review and edit point data in the Edit Window.
  3. Delete erroneous points.
3. Add breaklines.
  1. Select the Create Breakline SMS Create Nodestring Tool.svg tool.
  2. Click along points of a common elevation, such as at a bank toe or levee crest, to connect these points in the surface.
  3. Use the Backspace key to back up if an erroneous selection is made.
  4. Double-click or press Enter key to complete the breakline.
4. Merge elevation datasets.
  1. Select the Scatter | Merge Sets command.
  2. Use the Merge Scatter Sets dialog to select elevation data to be merged.
4. Define model limits (domain extents).
1. Create a Mesh Generator coverage in the Map module.
Create a new coverage with the "Mesh Generator" type.
1. Create new coverage from scratch.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage type.
2. Digitize arcs to define domain edges.
1. Create feature arcs, nodes and vertices.
With the Mesh Generator coverage as the active coverage, create feature objects.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
3. Generate domain extent arcs from other data sources.
Domain extents can be created from data outside of the Map module by converting the data to a mesh generator coverage.
1. Convert GIS objects to a map coverage.
1. Convert raster data to feature objects.
Converting raster data to feature objects can be done in one of two ways:
  1. Right-click on the raster data and select Convert To | Feature Objects which will create a new map coverage with arcs along all contours.
  2. Right-click on the raster data and select Convert To | Feature Objects at Elevation and enter a contour elevation to create arcs in a new coverage along the specified elevation.
2. Convert shapefile data to feature objects.
  1. Select a shapefile dataset in the GIS module and use the Mapping | Shape→Feature Objects command.
  2. Use the GIS to Feature Objects Wizard to specify how the shapefile attribute will be converted.
2. Convert a scatter dataset to a map coverage.
1. Convert a scatter contour value to a map coverage.
  1. Select the Data | Scatter Contour→Feature command.
  2. Use the Create Contour Arcs dialog to create arcs along the contour elevation into an existing coverage.
2. Convert scatter boundaries to a map coverage.
  1. Select the Data | Boundary→Feature command.
  2. Use the Select Coverage dialog to create a new coverage for the arcs or have the boundary arcs created on an existing coverage.
4. Merge domain coverages.
If domain extents have been created on multiple map coverages, these coverages need to be merged into a Mesh Generator coverage.
  1. Select multiple coverages that have feature objects which need to be on the same coverage.
  2. Use the Merge Coverages right-click command.
  3. Right-click on the new coverage and set the correct coverage type.
  4. Use the Clean Options dialog to resolve conflicting feature object data in the new coverage.
>
5. Generate a mesh.
1. Create arcs to capture key edges features (channel, embankments, etc.).
Create arcs inside the mesh domain to represent key edges for features such as channels, embankments, etc.
1. Create feature arcs, nodes and vertices.
With the Mesh Generator coverage as the active coverage, create feature objects.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
2. Set vertex spacing on arcs to define mesh element size.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select arc(s) and use the Redistribute right-click command.
  2. Use the Redistribute Vertices dialog to set the vertex distribution.
3. Create polygons in the Mesh Generator coverage.
Polygons are not created automatically when arcs are enclosed. To create polygons:
  1. Use the Feature Objects | Build Polygons command.
4. Specify mesh type for each polygon (pave / patch / none).
1. Select a polygon and open the 2D Mesh Polygon Properties dialog.
  1. Use the Select Poylgon SMS Select Polygon Tool.svg tool to select a polygon.
  2. Double-click on the selected polygon or use the Feature Objects | Attributes menu command.
2. Set the Mesh Type, Bathymetry Type, and Material Type for the polygon.
  1. Mesh types include Patch, Paving, Scalar Paving Density, and Constant Paving Density.
  2. Bathymetry type describes the elevation/topography source for the mesh nodes. Bathymetry types include a constant elevation value, interpolated elevation values from a scatter set, or interpolated elevation values from an existing mesh.
  3. Material types can be assigned to a polygon using materials previously created in Materials Data dialog.
3. Preview and edit the polygon mesh.
  1. Select the Preview Mesh button.
  2. Use the preview tools to edit the mesh.
  3. Set Arc Options to adjust distribution of vertices.
  4. Use Node Options to change how arcs are treated when using a patch mesh type.
5. Generate mesh from the Mesh Generator coverage.
  1. Select the Mesh Generator coverage and use the Map → 2D Mesh right-click command.
  2. Review the mesh quality for the newly generated mesh.
6. Define materials for AdH.
1. Create an Materials coverage using domain extents.
Create a new coverage with the AdH "Materials" type.
1. Duplicate the mesh domain coverage and change it to the AdH Material coverage type.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage type.
2. Digitize material areas (polygons).
If needing to create addition polygons for material areas, follow the steps below:
1. Create additional arcs for material polygons.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
2. Build polygons for material areas.
Polygons are not created automatically when arcs are enclosed. To create polygons:
  1. Use the Feature Objects | Build Polygons command.
3. Define material types.
  1. Right-click on the materials coverage and select the Materials List and Properties command.
  2. In the Materials List and Properties dialog, add materials to the material list and assign Manning's n values to each material. If desired, change the fill display properties (color and texture) of each material.
4. Assign materials to polygons in the materials coverage.
  1. Using the Select Feature Polygons SMS Select Polygon Tool.svg tool, select a polygon and use the Assign Material command.
  2. In the Assign Material dialog, assign the material using the drop down menu.
7. Define boundary conditions.
1. Create an AdH Boundary Conditions coverage.
Create a new coverage with the AdH "Boundary Conditions" type.
1. Create new coverage from scratch.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage type.
2. Create boundary conditions arcs.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
3. Assign boundary conditions.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Assign Arc Attributes command.
  2. Specify the boundary condition type in the AdH Arc Attributes dialog.
8. Create the AdH Simulation.
1. Create a new AdH simulation.
After creating the components of a simulation, create a new AdH simulation.
  1. Right-click in the Project Explorer and select the New Simulations | AdH command.
2. Add AdH simulation components.
To link components to the simulation, do one of the following.
  1. Right-click on the component and select the simulation name from the Apply To submenu.
  2. In the Project Explorer, click and drag items under the simulation object.
9. Define the AdH model parameters.
  1. Right-click on the simulation and select the Model Control command.
  2. Set the model parameters in the AdH Model Control dialog.
10. Run the AdH Simulation.
  1. Right-click on the AdH simulation and select Save Project, Simulation and Run]to run the simulation.
11. Review results.
1. Load solution files.
The solution file should load after running the model assuming the Load Solution option was checked in the model wrapper before exiting the model run. If loading the solution file separately from the model run, do the following:
  1. Open the output files generated from the model run.
2. Review results datasets and data visualization.
1. Manually review dataset solutions.
  1. In the Project Explorer, click on solution dataset created from the simulation run and view results in the Graphics Window.
  2. Click through the time steps for each dataset to see changes over time in the Graphics Window.
2. Adjust the display options.
1. Set display options.
  1. Open the Display Options Display Options Macro.svg dialog.
  2. Set the general display options.
  3. Set general lighting options.
  4. Set display options for each module that is being used.
  5. Set contour options.
  6. Set vector options.
2. View display.
  1. Use the Rotate Rotate Tool.svg, Pan Pan Tool.svg, and Zoom Zoom Tool Icon.svg tools.
  2. Use the View menu commands found in the Display menu.
  3. Use the Frame Frame Macro.svg command to center and resize the display as needed.
3. Adjust display.
Display may need to be adjusted during the remainder of the project.
  1. Use the Display Options dialog and viewing tools as needed.
  2. Use the Frame Frame Macro.svg command to center and resize the display as needed.
3. Create a film loop visualization.
  1. Select a solution dataset and use the Data | Film Loop menu command.
  2. Use the Film Loop Setup wizard to specify the animation parameters.
  3. Save and view the animation file.
4. Create a plot.
1. Load solution files if not already in the project.
  1. The solution should load automatically assuming the Load Solution option was checked in the model wrapper before exiting the model run.
  2. If loading the solution separately from the model run, open the solution file generated from model run.
2. Create an observation coverage.
Create a new coverage with the "Observation" type.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
3. Create observation points in the observation coverage.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
4. Add observation point attributes.
  1. With the Select Feature Point SMS Select Node Tool.svg tool, right-click on the observation point and select the Node Attributes command.
  2. Set the observation attributes in the Observation Coverage dialog.
5. Use the Plot Wizard to generate plot type.
The Plot Wizard can generate any of the following plot types:
1. Computed vs. Observed Data plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Computed vs. Observed Data" option on the left and click Next.
  3. Review measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
2. Residual vs. Observed Data plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Residual vs. Observed Data" option on the left and click Next.
  3. Review measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
3. Error vs. Simulation plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error vs. Simulation" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
4. Error vs. Time Step plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error vs. Time Step" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
5. Error Summary plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error Summary" option on the left and click Next.
  3. Specify measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
6. Time Series plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Time Series" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
3. Use an observation profile plot.
1. Create an observation coverage.
Create a new coverage with the "Observation" type.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create observation arcs in the observation coverage.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
3. Create an observation plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Observation Profile" option on the left and click Next.
  3. Select arcs, datasets, and time steps to be plotted.
  4. Review plot window.
4. Create and compare datasets.
  1. Select the Data | Dataset Toolbox menu command.
  2. In the Dataset Toolbox, compare datasets by subtracting the alternate dataset from the base dataset.
  3. New dataset can be generated in the Dataset Toolbox using the Data Calculator.