SMS:CGWAVE Model Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 5: Line 5:
* ''Title''
* ''Title''
* ''Incident Wave Conditions''
* ''Incident Wave Conditions''
<blockquote>
<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. </blockquote>
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>
<blockquote style="margin-top:0px; margin-bottom:0px;">
The ''Open Boundary'' section specifise 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 specifise 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''
Line 15: Line 15:
</blockquote>
</blockquote>
*'' 1-D Options''
*'' 1-D Options''
<blockquote>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 to in order for this button to be active. If no  scatter data exists, generate an appropriate file containing the  one-dimensional depth values.</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
<blockquote>
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 to in order for this button to be active. If no  scatter data exists, generate an appropriate file containing the  one-dimensional depth values.</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Current 1D Wave Line Settings''
*''Current 1D Wave Line Settings''
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
* ''Spacing:''
* ''Spacing:''
* ''Length:''
* ''Length:''
Line 24: Line 25:
</blockquote>
</blockquote>
*''1D Domain Extension Parameters''
*''1D Domain Extension Parameters''
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
* ''Length to edge of scatter:''
* ''Length to edge of scatter:''
* ''Radius of domain:''
* ''Radius of domain:''
Line 37: Line 38:
* ''Solver Options''
* ''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.
*: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.
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Solver:''
*''Solver:''
*''Convergence tolerance:''
*''Convergence tolerance:''
Line 45: Line 46:
</blockquote>
</blockquote>
* ''Iteration Control''
* ''Iteration Control''
<blockquote>
<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.</blockquote>
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>
<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.</blockquote>
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.</blockquote>
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Bottom friction''
*''Bottom friction''
*''Wave breaker''
*''Wave breaker''
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Breaking coefficient''</blockquote>
*''Breaking coefficient''</blockquote>
*''Nonlinear dispersion relation''
*''Nonlinear dispersion relation''
<blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">
*''Convergence tolerance''
*''Convergence tolerance''
*''Maximum iterations''
*''Maximum iterations''

Revision as of 15:46, 5 August 2016

File:CGWAVE Model Control.jpg
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
  • 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 specifise 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 to 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