SMS:ADH Model Control Solver: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
This window is part of the ''ADH model control'' dialog (''ADH'' | '''Model Control...''' command). It is accessed from the ''Model Control'' window by clicking on the ''Solver'' tab.
__NOINDEX__
{{SMS Deprecated Feature}}
[[File:ADH Model Control Solver.png|thumb|500 px|The ''Solver'' tab of the ''ADH Model Control'' dialog]]
Advanced options for the ADH solver can be set the [[SMS:ADH Model Control|''ADH Model Control'']] dialog (''ADH'' | '''Model Control...''' command). It is accessed in the ''ADH Model Control''dialog by clicking on the ''Solver'' tab.
   
   
(As noted at the top of this dialog, this is an advanced feature and we recommend that only users working with the ADH development team use these options.)
As noted at the top of this dialog, this is an advanced feature. It is recommended to only use these options when working with the ADH development team.
==Operation==
The operation section contains controls to specify general operation parameters for ADH. SMS automatically writes the <font color="green">OP SW2</font> card to all ADH boundary condition files because SMS interfaces with the 2D shallow water problems simulated by ADH.  The other operational parameters specified in this section include:
* ''Increment memory allocation block size''
::The memory used when running the ADH model is allocation in blocks. The size of the block  (<font color="green">OP INC</font> card) can be specified here. The default value is 40 units. If the specified number is too small, running ADH may be slowed as the model will search for additional memory. If the number is too large, the model run will use excess memory not needed to complete the run.
 
*''Iterative solver pre-conditioner''
::The ''Iterative solver pre-conditioner'' parameters apply to parallel processing applications. If running ADH in single processor mode, this card has no impact.
 
::If running ADH in parallel mode, the edit field defines how many blocks per processor are to be used in the preconditioning which subdivides the problem for each processor. Provides the following options: "One-level Additive Schwarz", "Two-level Additive Schwarz", and "Two-level Hybrid". After selecting a preconditioning scheme, specify  how many blocks per processor are to be used in the preconditioner by completing the ''Block specification'' field.
 
*''Include vessel stress effects''
::This toggle instructs SMS to write the <font color="green">OP BTS</font> card which includes vessel stress effects check in the simulation when checked. This calculates and outputs bed shear stresses due to vessels in dyn/cms. This currently requires use of metric units. If enabling this option, make sure there are vessel coverages in the simulation and that each boat has propellers defined.


==Linear Iterations By Solver==
==Linear Iterations By Solver==
Line 7: Line 22:
This window includes the options to control linear iterations in ADH.  The controls are similar to the controls for non-linear iterations included on the [[SMS:ADH Model Control Iterations|Iterations]] tab.
This window includes the options to control linear iterations in ADH.  The controls are similar to the controls for non-linear iterations included on the [[SMS:ADH Model Control Iterations|Iterations]] tab.


The distinction between linear and non-linear iterations are described in some detain in the [http://chl.erdc.usace.army.mil/chl.aspx?p=m&a=MEDIA;1225 ADH users manual.]   
The distinction between linear and non-linear iterations are described in some detain in the [https://chl.erdc.dren.mil/adh/main/index.html ADH users manual.]   
 
===Maximum number of iterations  (IP MIT and IP FLI cards)===


In this edit field the user specifies the maximum number of linear iterations that ADH will try for each non-linear iteration.  
''Maximum Number of Iterations  (IP MIT and IP FLI Cards)''
:In this edit field specify the maximum number of linear iterations that ADH will try for each non-linear iteration.  


SMS writes either the IP MIT or IP FLI card based on the setting of the ''If internal linear tolerance is not satisfied'' radio group.  
SMS writes either the <font color="green">IP MIT</font> or <font color="green">IP FLI</font> card based on the setting of the ''If internal linear tolerance is not satisfied'' radio group.  
* IP MIT card is written if the ''Stop the solution'' option is selected. (Recommended)
* <font color="green">IP MIT</font> card is written if the ''Stop the solution'' option is selected. (Recommended)
* IP FLI card is written if the ''Proceed to the next non-linear iteration'' option is selected.
* <font color="green">IP FLI</font> card is written if the ''Proceed to the next non-linear iteration'' option is selected.


The IP FLI card instructs ADH to continue with the solution as if it had converged.  This is not recommended.
The <font color="green">IP FLI</font> card instructs ADH to continue with the solution as if it had converged.  This is not recommended.


When the ''Stop the solution'' option is selected and the solution has not converged at the maximum number of iterations have been attempted, ADH will treat the solution as diverged and the non-linear iterations will be aborted.  
When the ''Stop the solution'' option is selected and the solution has not converged at the maximum number of iterations have been attempted, ADH will treat the solution as diverged and the non-linear iterations will be aborted.


==Related Topics==
==Related Topics==
[[SMS:ADH | ADH]]
*[[SMS:ADH | ADH]]
*[[SMS:ADH Model Control|ADH Model Control]]




Line 29: Line 44:
[[Category:ADH|M]]
[[Category:ADH|M]]
[[Category:SMS Model Control|A]]
[[Category:SMS Model Control|A]]
[[Category:ADH Dialogs|mod|sol]]
[[Category:External Links]]

Latest revision as of 20:22, 11 September 2023

The Solver tab of the ADH Model Control dialog

Advanced options for the ADH solver can be set the ADH Model Control dialog (ADH | Model Control... command). It is accessed in the ADH Model Controldialog by clicking on the Solver tab.

As noted at the top of this dialog, this is an advanced feature. It is recommended to only use these options when working with the ADH development team.

Operation

The operation section contains controls to specify general operation parameters for ADH. SMS automatically writes the OP SW2 card to all ADH boundary condition files because SMS interfaces with the 2D shallow water problems simulated by ADH. The other operational parameters specified in this section include:

  • Increment memory allocation block size
The memory used when running the ADH model is allocation in blocks. The size of the block (OP INC card) can be specified here. The default value is 40 units. If the specified number is too small, running ADH may be slowed as the model will search for additional memory. If the number is too large, the model run will use excess memory not needed to complete the run.
  • Iterative solver pre-conditioner
The Iterative solver pre-conditioner parameters apply to parallel processing applications. If running ADH in single processor mode, this card has no impact.
If running ADH in parallel mode, the edit field defines how many blocks per processor are to be used in the preconditioning which subdivides the problem for each processor. Provides the following options: "One-level Additive Schwarz", "Two-level Additive Schwarz", and "Two-level Hybrid". After selecting a preconditioning scheme, specify how many blocks per processor are to be used in the preconditioner by completing the Block specification field.
  • Include vessel stress effects
This toggle instructs SMS to write the OP BTS card which includes vessel stress effects check in the simulation when checked. This calculates and outputs bed shear stresses due to vessels in dyn/cms. This currently requires use of metric units. If enabling this option, make sure there are vessel coverages in the simulation and that each boat has propellers defined.

Linear Iterations By Solver

This window includes the options to control linear iterations in ADH. The controls are similar to the controls for non-linear iterations included on the Iterations tab.

The distinction between linear and non-linear iterations are described in some detain in the ADH users manual.

Maximum Number of Iterations (IP MIT and IP FLI Cards)

In this edit field specify the maximum number of linear iterations that ADH will try for each non-linear iteration.

SMS writes either the IP MIT or IP FLI card based on the setting of the If internal linear tolerance is not satisfied radio group.

  • IP MIT card is written if the Stop the solution option is selected. (Recommended)
  • IP FLI card is written if the Proceed to the next non-linear iteration option is selected.

The IP FLI card instructs ADH to continue with the solution as if it had converged. This is not recommended.

When the Stop the solution option is selected and the solution has not converged at the maximum number of iterations have been attempted, ADH will treat the solution as diverged and the non-linear iterations will be aborted.

Related Topics