GenCade 2.0 Model Control Dialog: Difference between revisions

From CIRPwiki
Jump to navigation Jump to search
(Created page with "The ''Gencade Model Control'' dialog is used to set beach conditions, lateral boundary conditions and general simulation options. This document highlights the more commonly used options. Refer to the [https://cirp.usace.army.mil/wiki/GenCade GenCade web site] for a more detailed description of how these parameters affect the model results. ==Model Setup Tab== thumb|400 px|''GenCade Model Control'' dialog showing the ''Model Setup'' tab Th...")
 
mNo edit summary
Line 1: Line 1:
The ''Gencade Model Control'' dialog is used to set beach conditions, lateral boundary conditions and general simulation options. This document highlights the more commonly used options. Refer to the [https://cirp.usace.army.mil/wiki/GenCade GenCade web site] for a more detailed description of how these parameters affect the model results.  
The ''Gencade Model Control'' dialog is used to set beach conditions, lateral boundary conditions and general simulation options. This document highlights the more commonly used options. Refer to the [[GenCade|GenCade web site]] for a more detailed description of how these parameters affect the model results
 
This dialog has been updated for use with SMS 13.3 and the new GenCade interface. New items added are in <span style="color:red">red</span>.
 
Note: At the bottom of each tab is a note shown in <span style="color:red">red</span> that tells the user whether they are using Imperial (feet and yards) or Metric values for most fields.  This determination is made based on the SMS Display Projection.  


==Model Setup Tab==
==Model Setup Tab==
[[Image:GenCade MC Setup.png|thumb|400 px|''GenCade Model Control'' dialog showing the ''Model Setup'' tab]]
[[File:ModelControl Setup.png|alt=GenCade Model Control dialog showing the Model Setup tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Model Setup'' tab]]
The following parameters are specified in the ''model setup'' tab:  
The following parameters are specified in the ''model setup'' tab:  
*''Simulation''
*''Simulation''
** ''Title'' &ndash; Title of simulation run.
**''Title'' &ndash; Title of simulation run.
** ''Full print output'' &ndash; Path and name of printed output file.
**''Full print output'' &ndash; Path and name of printed output file.
*''Computational Time''
*''Computational Time''
** ''Start Date'' &ndash; Simulation start date.
**''Start Date'' &ndash; Simulation start date.
** ''End Date'' &ndash; Simulation end date.
**''End Date'' &ndash; Simulation end date.
** ''Time Step'' &ndash; Model time step in hours.
**''Time Step'' &ndash; Model time step in hours.
** ''Recording Time Step'' &ndash; Recorded model time step in hours.
**''Recording Time Step'' &ndash; Recorded model time step in hours.
* ''Print Dates'' &ndash; Dates to save simulated shoreline. Use the '''Add''' button to create dates and the '''Remove''' button to delete any unwanted dates.
*''Print Dates'' &ndash; Dates to save simulated shoreline. Use the '''Add''' button to create dates and the '''Remove''' button to delete any unwanted dates.
*''Grid Information'' &ndash; static information about the GenCade grid including number of cells, grid angle, and length of 1d Grid.


==Beach Setup Tab==
==Beach Setup Tab ==
The following parameters are specified in the ''beach setup'' tab:  
[[File:ModelControl Beach.png|alt=GenCade Model Control dialog showing the Beach Setup tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Beach Setup'' tab]]
* ''Sand and Beach Data ''
The following parameters are specified in the ''beach setup'' tab:
** ''Effective Grain Size'' &ndash; Medium sediment grain size in millimeters.
*''Sand and Beach Data ''
** ''Average Berm Height'' &ndash; In meters.
**''Effective Grain Size'' &ndash; Medium sediment grain size in millimeters.
** ''Closure Depth'' &ndash; In meters.
**''Average Berm Height'' &ndash; In feet or meters.
* ''Longshore Sand Transport Calibration Coefficients ''
** ''Closure Depth'' &ndash; In feet or meters.
**''K1'' &ndash; 0.1<K1<1
**''<span style="color:red">Regional Sea Level Change</span>'' in mm/year.
** ''K2'' &ndash; 0.5K1<K2<1.5K1
**''<span style="color:red">Regional Subsidence</span>'' in mm/year.
**''<span style="color:red">Beach Slope</span>''.
*''Longshore Sand Transport Calibration Coefficients ''  
**''K1'' &ndash; Range should be 0.1 < K1 <1
**''K2'' &ndash; Range should be 0.5(K1)  < K2 < 1.5(K1)
**''<span style="color:red">KTIDE</span>'' &ndash; longshore transport coefficient for tide current.


[[Image:GenCade MC Beach.png|thumb|none|left|400 px|''GenCade Model Control'' dialog showing the ''Beach Setup'' tab]]
==Seaward BC Tab ==
 
[[File:ModelControl Seaward.png|alt=GenCade Model Control dialog showing the Seaward BC tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Seaward BC'' tab]]
==Seaward BC Tab==
[[Image:GenCade MC Seaward.png|thumb|400 px|''GenCade Model Control'' dialog showing the ''Seaward BC'' tab]]
The following parameters are specified in the ''seaward boundary condition'' tab:  
The following parameters are specified in the ''seaward boundary condition'' tab:  
* ''Input Wave Adjustments'' &ndash; This section contains the following options:  
* ''Input Wave Adjustments'' &ndash; This section contains the following options:  
** ''Height Amplification Factor''  
**''Height Amplification Factor''
** ''Angle Amplification Factor ''
**''Angle Amplification Factor ''
** ''Angle Offset ''
**''Angle Offset ''
* ''Wave Components to Apply'' &ndash; options include "Primary (1)" or "Primary & Secondary".  
*''Wave Components to Apply'' &ndash; options include "Primary (1)" or "Primary & Secondary".
* ''Number of Cells in Offshore contour Smoothing Window'' &ndash; Default value is 11, but it is suggested that this number range between 11 and 101.
*''Number of Cells in Offshore contour Smoothing Window'' &ndash; Default value is 11, but it is suggested that this number range between 11 and 101.
<br clear="all">


==Lateral BC Tab==
The following parameters are specified in the ''lateral boundary condition'' tab for the left and right lateral boundary condition:
* ''Type'' &ndash; Determines one of three boundary types:
** "Pinned" &ndash; Boundary will not move from the initial shoreline position.
** "Moving" &ndash; Represents the amount of shoreline change at a boundary over a specified period of time.
*** ''Shoreline Displacement Velocity'' &ndash; Shoreline can be displaced over the "Simulation Period", "Day", or "Time Step".
** "Gated" &ndash; Bounded with a groin. Requires that a groin exist and must be located in cell 1.
*** ''Length of Groin from Shoreline to Seaward Tip''
[[Image:GenCade MC Lateral.png|thumb|none|left|400 px|''GenCade Model Control'' dialog showing the ''Lateral BC'' tab]]


==Lateral BC Tab ==
[[File:ModelControl Lateral.png|alt=GenCade Model Control dialog showing the Lateral BC tab|thumb|''GenCade Model Control'' dialog showing the ''Lateral BC'' tab]]
The following parameters are specified in the ''lateral boundary condition'' tab for the left and right lateral boundary condition: 
*''Type'' &ndash; Determines one of three boundary types:
**"Pinned" &ndash; Boundary will not move from the initial shoreline position.
**"Moving" &ndash; Represents the amount of shoreline change at a boundary over a specified period of time.
***''Shoreline Displacement Velocity'' &ndash; Shoreline can be displaced over the "Simulation Period", "Day", or "Time Step".
**"Gated" &ndash; Bounded with a groin. Requires that a groin exist and must be located in cell 1. 
***''Length of Groin from Shoreline to Seaward Tip''
<br clear="all">
==Adaptive Time Steps Tab==
==Adaptive Time Steps Tab==
[[File:GenCade MC Adaptive.png|thumb|400 px|''GenCade Model Control'' dialog showing the ''Adaptive Time Steps'' tab]]
[[File:ModelControl Adaptive.png|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Adaptive Time Steps'' tab]]
The following parameters are specified in the adaptive time steps tab:
The following parameters are specified in the adaptive time steps tab:
*''Use adaptive time steps'' &ndash; If turned on, allows the option to use the default values or set custome values.
*''Use adaptive time steps'' &ndash; If turned on, allows the option to use the default values or set custome values.
Line 57: Line 66:
**''Stability minimum''
**''Stability minimum''
**''Stability maximum''
**''Stability maximum''


==Related Topics==
==Related Topics==
[[Category:GenCade Dialogs|M]]
[[Category:GenCade Dialogs|M]]
[[Category:GenCade|M]]
[[Category:GenCade|M]]

Revision as of 20:27, 26 March 2024

The Gencade Model Control dialog is used to set beach conditions, lateral boundary conditions and general simulation options. This document highlights the more commonly used options. Refer to the GenCade web site for a more detailed description of how these parameters affect the model results.

This dialog has been updated for use with SMS 13.3 and the new GenCade interface. New items added are in red.

Note: At the bottom of each tab is a note shown in red that tells the user whether they are using Imperial (feet and yards) or Metric values for most fields. This determination is made based on the SMS Display Projection.

Model Setup Tab

GenCade Model Control dialog showing the Model Setup tab
GenCade Model Control dialog showing the Model Setup tab

The following parameters are specified in the model setup tab:

  • Simulation
    • Title – Title of simulation run.
    • Full print output – Path and name of printed output file.
  • Computational Time
    • Start Date – Simulation start date.
    • End Date – Simulation end date.
    • Time Step – Model time step in hours.
    • Recording Time Step – Recorded model time step in hours.
  • Print Dates – Dates to save simulated shoreline. Use the Add button to create dates and the Remove button to delete any unwanted dates.
  • Grid Information – static information about the GenCade grid including number of cells, grid angle, and length of 1d Grid.

Beach Setup Tab

GenCade Model Control dialog showing the Beach Setup tab
GenCade Model Control dialog showing the Beach Setup tab

The following parameters are specified in the beach setup tab:

  • Sand and Beach Data
    • Effective Grain Size – Medium sediment grain size in millimeters.
    • Average Berm Height – In feet or meters.
    • Closure Depth – In feet or meters.
    • Regional Sea Level Change in mm/year.
    • Regional Subsidence in mm/year.
    • Beach Slope.
  • Longshore Sand Transport Calibration Coefficients
    • K1 – Range should be 0.1 < K1 <1
    • K2 – Range should be 0.5(K1) < K2 < 1.5(K1)
    • KTIDE – longshore transport coefficient for tide current.

Seaward BC Tab

GenCade Model Control dialog showing the Seaward BC tab
GenCade Model Control dialog showing the Seaward BC tab

The following parameters are specified in the seaward boundary condition tab:

  • Input Wave Adjustments – This section contains the following options:
    • Height Amplification Factor
    • Angle Amplification Factor
    • Angle Offset
  • Wave Components to Apply – options include "Primary (1)" or "Primary & Secondary".
  • Number of Cells in Offshore contour Smoothing Window – Default value is 11, but it is suggested that this number range between 11 and 101.



Lateral BC Tab

GenCade Model Control dialog showing the Lateral BC tab
GenCade Model Control dialog showing the Lateral BC tab

The following parameters are specified in the lateral boundary condition tab for the left and right lateral boundary condition:

  • Type – Determines one of three boundary types:
    • "Pinned" – Boundary will not move from the initial shoreline position.
    • "Moving" – Represents the amount of shoreline change at a boundary over a specified period of time.
      • Shoreline Displacement Velocity – Shoreline can be displaced over the "Simulation Period", "Day", or "Time Step".
    • "Gated" – Bounded with a groin. Requires that a groin exist and must be located in cell 1.
      • Length of Groin from Shoreline to Seaward Tip


Adaptive Time Steps Tab

GenCade Model Control dialog showing the Adaptive Time Steps tab

The following parameters are specified in the adaptive time steps tab:

  • Use adaptive time steps – If turned on, allows the option to use the default values or set custome values.
  • Use defaults – If turned on, the default values will be used. If turned off, the following can be set:
    • Threshold minimum
    • Threshold maximum
    • Number of days stable
    • Stability minimum
    • Stability maximum


Related Topics