SMS:CGWAVE Model Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(fixed 2 typos)
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
[[Image:CGWAVE Model Control.jpg|thumb|500 px|''CGWAVE Model Control'' dialog]]
[[Image:CGWAVE Model Control.png|thumb|500 px|''CGWAVE Model Control'' dialog]]
The [[SMS:CGWAVE|CGWAVE]] model requires several user-specified parameters to control the  analysis. The '''Model Control''' command from the [[SMS:CGWAVE Graphical Interface#CGWAVE Menu|''CGWAVE'' menu]] opens the ''Model Control'' dialog. This dialog contains parameters that control the execution of CGWAVE. The parameter description for each field is displayed in SMS using the interactive help messages.
The [[SMS:CGWAVE|CGWAVE]] model requires several user-specified parameters to control the  analysis. The '''Model Control''' command from the [[SMS:CGWAVE Graphical Interface#CGWAVE Menu|''CGWAVE'' menu]] opens the ''Model Control'' dialog. This dialog contains parameters that control the execution of CGWAVE. The parameter description for each field is displayed in SMS using the interactive help messages.


Controls include:
Controls include:
* ''Title''
* ''Title''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::Enter the simulation name. This will be used for naming the generated datasets during the model run.
Enter the simulation name. This will be used for naming the generated datasets during the model run.
</blockquote>
* ''Incident Wave Conditions''
* ''Incident Wave Conditions''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::The ''Incident Wave Conditions'' section specifies wave  conditions to be simulated in a run. See [[SMS:CGWAVE Incident Wave Conditions|CGWAVE Incident Wave Conditions]] for more information.  
The ''Incident Wave Conditions'' section specifies wave  conditions to be simulated in a run. See [[SMS:CGWAVE Incident Wave Conditions|CGWAVE Incident Wave Conditions]] for more information. </blockquote>
* ''Open Boundary''
* ''Open Boundary''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::The ''Open Boundary'' section specifies the open boundary type.  This should match the type selected when generating the domain in the Map  Module. If the mesh has been generated using other methods, the domain shape  must match the ''Open Boundary'' type.  
The ''Open Boundary'' section specifies the open boundary type.  This should match the type selected when generating the domain in the Map  Module. If the mesh has been generated using other methods, the domain shape  must match the ''Open Boundary'' type.  
:*''Semicircular''
*''Semicircular''
:*''Circular''
*''Circular''
:*''Boundary condition:''
*''Boundary condition:''
</blockquote>
*'' 1-D Options''
*'' 1-D Options''
<blockquote style="margin-top:0px; margin-bottom:0px;">
:The 1-D section specifies the number of nodes and the nodal  spacing for the one-dimensional data that is used to distribute incident wave  data to the open boundary. The file format is described in the CGWAVE user  manual[http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=Software;21]. The '''Compute 1-d Length''' button calculates the 1-d Spacing variable such  that the specified number of nodes will extend to the limits of the bathymetry  data. This bathymetry data is defined by a scattered dataset. Therefore, a  scatter dataset must exist in order for this button to be active. If no  scatter data exists, generate an appropriate file containing the  one-dimensional depth values.
The 1-D section specifies the number of nodes and the nodal  spacing for the one-dimensional data that is used to distribute incident wave  data to the open boundary. The file format is described in the CGWAVE user  manual[http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=Software;21]. The '''Compute 1-d Length''' button calculates the 1-d Spacing variable such  that the specified number of nodes will extend to the limits of the bathymetry  data. This bathymetry data is defined by a scattered dataset. Therefore, a  scatter dataset must exist in order for this button to be active. If no  scatter data exists, generate an appropriate file containing the  one-dimensional depth values.</blockquote>
:*''Current 1D Wave Line Settings''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::* ''Spacing:''
*''Current 1D Wave Line Settings''
::* ''Length:''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::* ''Number of nodes:''
* ''Spacing:''
:*''1D Domain Extension Parameters''
* ''Length:''
::* ''Length to edge of scatter:''
* ''Number of nodes:''
::* ''Radius of domain:''
</blockquote>
::* ''Ideal 1D spacing:''
*''1D Domain Extension Parameters''
::* ''1D spacing''
<blockquote style="margin-top:0px; margin-bottom:0px;">
::* ''Num. of Nodes''
* ''Length to edge of scatter:''
::* ''Minimum 1D Depth''
* ''Radius of domain:''
::* ''Update Num. of Nodes''
* ''Ideal 1D spacing:''
::* ''Update Spacing''
* ''1D spacing''
::* ''Extract Depths''
* ''Num. of Nodes''
* ''Minimum 1D Depth''
* ''Update Num. of Nodes''
* ''Update Spacing''
* ''Extract Depths''
</blockquote></blockquote>
* ''Solver Options''
* ''Solver Options''
<blockquote style="margin-top:0px; margin-bottom:0px;">
:CGWAVE support two separate numerical solvers for robustness. Select  which solver to use via the ''Solver'' radio group. The ''Standard solver'' should be  utilized first. If CGWAVE fails to converge, the ''Modified'' method can be  utilized.
CGWAVE support two separate numerical solvers for robustness. Select  which solver to use via the ''Solver'' radio group. The ''Standard solver'' should be  utilized first. If CGWAVE fails to converge, the ''Modified'' method can be  utilized.
:*''Solver:''
*''Solver:''
:*''Convergence tolerance:''
*''Convergence tolerance:''
:*''Output echo frequency:''
*''Output echo frequency:''
:*''Maximum iterations:''
*''Maximum iterations:''
:*''Num. of bessel terms used:''
*''Num. of bessel terms used:''
</blockquote>
* ''Iteration Control''
* ''Iteration Control''
<blockquote style="margin-top:0px; margin-bottom:0px;">
:CGWAVE allows specifying the maximum number of iteration to be  performed by the numerical solver. This number is specified in the ''Maximum  Iterations'' edit field. The solver will terminate after performing the maximum  number of iterations or when the change in the solution is less than the  convergence tolerance specified in the ''Convergence Tolerance'' edit field. It is  recommended that the convergence value be between 1.0e-6 and 1.0e-9. CGWAVE will  print a progress report on the tolerance at the user specified report interval  entered in the ''Convergence Interval'' edit field.
CGWAVE allows specifying the maximum number of iteration to be  performed by the numerical solver. This number is specified in the ''Maximum  Iterations'' edit field. The solver will terminate after performing the maximum  number of iterations or when the change in the solution is less than the  convergence tolerance specified in the ''Convergence Tolerance'' edit field. It is  recommended that the convergence value be between 1.0e-6 and 1.0e-9. CGWAVE will  print a progress report on the tolerance at the user specified report interval  entered in the ''Convergence Interval'' edit field.</blockquote>
* ''General Parameters''
* ''General Parameters''
<blockquote style="margin-top:0px; margin-bottom:0px;">
:CGWAVE includes options to model bottom friction, wave breaking and nonlinear dispersion. These options may be enabled using the appropriate toggle box. See the CGWAVE user manual for more information about these parameters.
CGWAVE includes options to model bottom friction, wave breaking and nonlinear dispersion. These options may be enabled using the appropriate toggle box. See the CGWAVE user manual for more information about these parameters.
:*''Bottom friction''
*''Bottom friction''
:*''Wave breaker''
*''Wave breaker''
::*''Breaking coefficient''
<blockquote style="margin-top:0px; margin-bottom:0px;">
:*''Nonlinear dispersion relation''
*''Breaking coefficient''</blockquote>
::*''Convergence tolerance''
*''Nonlinear dispersion relation''
::*''Maximum iterations''
<blockquote style="margin-top:0px; margin-bottom:0px;">
 
*''Convergence tolerance''
*''Maximum iterations''
</blockquote></blockquote>


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

Latest revision as of 14:54, 3 July 2019

CGWAVE Model Control dialog

The CGWAVE model requires several user-specified parameters to control the analysis. The Model Control command from the CGWAVE menu opens the Model Control dialog. This dialog contains parameters that control the execution of CGWAVE. The parameter description for each field is displayed in SMS using the interactive help messages.

Controls include:

  • Title
Enter the simulation name. This will be used for naming the generated datasets during the model run.
  • Incident Wave Conditions
The Incident Wave Conditions section specifies wave conditions to be simulated in a run. See CGWAVE Incident Wave Conditions for more information.
  • Open Boundary
The Open Boundary section specifies the open boundary type. This should match the type selected when generating the domain in the Map Module. If the mesh has been generated using other methods, the domain shape must match the Open Boundary type.
  • Semicircular
  • Circular
  • Boundary condition:
  • 1-D Options
The 1-D section specifies the number of nodes and the nodal spacing for the one-dimensional data that is used to distribute incident wave data to the open boundary. The file format is described in the CGWAVE user manual[1]. The Compute 1-d Length button calculates the 1-d Spacing variable such that the specified number of nodes will extend to the limits of the bathymetry data. This bathymetry data is defined by a scattered dataset. Therefore, a scatter dataset must exist in order for this button to be active. If no scatter data exists, generate an appropriate file containing the one-dimensional depth values.
  • Current 1D Wave Line Settings
  • Spacing:
  • Length:
  • Number of nodes:
  • 1D Domain Extension Parameters
  • Length to edge of scatter:
  • Radius of domain:
  • Ideal 1D spacing:
  • 1D spacing
  • Num. of Nodes
  • Minimum 1D Depth
  • Update Num. of Nodes
  • Update Spacing
  • Extract Depths
  • Solver Options
CGWAVE support two separate numerical solvers for robustness. Select which solver to use via the Solver radio group. The Standard solver should be utilized first. If CGWAVE fails to converge, the Modified method can be utilized.
  • Solver:
  • Convergence tolerance:
  • Output echo frequency:
  • Maximum iterations:
  • Num. of bessel terms used:
  • Iteration Control
CGWAVE allows specifying the maximum number of iteration to be performed by the numerical solver. This number is specified in the Maximum Iterations edit field. The solver will terminate after performing the maximum number of iterations or when the change in the solution is less than the convergence tolerance specified in the Convergence Tolerance edit field. It is recommended that the convergence value be between 1.0e-6 and 1.0e-9. CGWAVE will print a progress report on the tolerance at the user specified report interval entered in the Convergence Interval edit field.
  • General Parameters
CGWAVE includes options to model bottom friction, wave breaking and nonlinear dispersion. These options may be enabled using the appropriate toggle box. See the CGWAVE user manual for more information about these parameters.
  • Bottom friction
  • Wave breaker
  • Breaking coefficient
  • Nonlinear dispersion relation
  • Convergence tolerance
  • Maximum iterations


Related Topics