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
 
(15 intermediate revisions by the same user not shown)
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.  
{{DISPLAYTITLE:GenCade 2.0 Model Control Dialog}}
{{TOC right}}
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. <span style="color:red">New items for GenCade 2.0 added are shown in 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==
<br clear="all">
The following parameters are specified in the ''beach setup'' tab:  
==Beach Setup Tab ==
* ''Sand and Beach Data ''
[[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]]
** ''Effective Grain Size'' &ndash; Medium sediment grain size in millimeters.
The following parameters are specified in the ''beach setup'' tab:
** ''Average Berm Height'' &ndash; In meters.
*''Sand and Beach Data ''
** ''Closure Depth'' &ndash; In meters.
**''Effective Grain Size'' &ndash; Medium sediment grain size in millimeters.
* ''Longshore Sand Transport Calibration Coefficients ''
**''Average Berm Height'' &ndash; In feet or meters.
**''K1'' &ndash; 0.1<K1<1
** ''Closure Depth'' &ndash; In feet or meters.
** ''K2'' &ndash; 0.5K1<K2<1.5K1
**''<span style="color:red">Regional Sea Level Change</span>'' in mm/year.
 
**''<span style="color:red">Regional Subsidence</span>'' in mm/year.
[[Image:GenCade MC Beach.png|thumb|none|left|400 px|''GenCade Model Control'' dialog showing the ''Beach Setup'' tab]]
**''<span style="color:red">Beach Slope</span>''.
 
*''Longshore Sand Transport Calibration Coefficients ''  
==Seaward BC Tab==
**''K1'' &ndash; Range should be 0.1 < K1 <1
[[Image:GenCade MC Seaward.png|thumb|400 px|''GenCade Model Control'' dialog showing the ''Seaward BC'' tab]]
**''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.
<br clear="all">
==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]]
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; option is always "Primary (1)".
* ''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 be and '''odd''' number in the range between 11 and 101. ''If an even number is entered, GenCade will change to the next smaller odd value.''
 
<br clear="all">
==Lateral BC Tab==
==Lateral BC Tab ==
The following parameters are specified in the ''lateral boundary condition'' tab for the left and right lateral boundary condition:  
[[File:ModelControl Lateral.png|alt=GenCade Model Control dialog showing the Lateral BC tab|thumb|''GenCade Model Control'' dialog showing the ''Lateral BC'' tab]]
* ''Type'' &ndash; Determines one of three boundary types:
The following parameters are specified in the ''lateral boundary condition'' tab for the left and right lateral boundary condition:
** "Pinned" &ndash; Boundary will not move from the initial shoreline position.
*''Type'' &ndash; Determines one of three boundary types:  
** "Moving" &ndash; Represents the amount of shoreline change at a boundary over a specified period of time.  
**"Pinned" &ndash; Boundary will not move from the initial shoreline position.
*** ''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.
** "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''
*** ''Length of Groin from Shoreline to Seaward Tip''
**"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 one of the following options:
[[Image:GenCade MC Lateral.png|thumb|none|left|400 px|''GenCade Model Control'' dialog showing the ''Lateral BC'' tab]]
****"Simulation Period"
 
****"Day"
****"Time Step"
<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.
*''Enable adaptive time steps'' &ndash; If turned on, allows the option to use the default values or set custom values.
*''Use defaults'' &ndash; If turned on, the default values will be used. If turned off, the following can be set:
*Once enabled, the following 5 values will have defaults. They can be changed based on user preference. 
**''Threshold minimum''
**''Threshold minimum''
**''Threshold maximum''
**''Threshold maximum''
Line 57: Line 68:
**''Stability minimum''
**''Stability minimum''
**''Stability maximum''
**''Stability maximum''
<br clear="all">
==<span style="color:red">Cross Shore Tab</span> ''*NEW*''==
[[File:ModelControl XShore.png|alt=GenCade Model Control dialog showing the Cross Shore tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Cross Shore'' tab]]
The following parameters are specified in the cross shore tab:
*''Enable cross-shore transport'' &ndash; If turned on, enables GenCade to include cross shore transport in sediment transport calculations.
*''Cross-shore scaling parameter''
*''Onshore transport rate (mm/yr)''
*''Enable variable berm height with SLC''
*''Enable varying slope with shoreline position''
==<span style="color:red">Monte Carlo Tab</span> ''*NEW*''==
[[File:ModelControl MCarlo.png|alt=GenCade Model Control dialog showing the Monte Carlo tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Monte Carlo'' tab]]
The following parameters are specified in the Monte Carlo tab:
*''Enable Monte Carlo transport'' &ndash; If turned on, enables run multiple GenCade simulations dependent on several criteria.
*''Probability Function''
**''Rayleigh Distribution''
**''Rayleigh + Weibull Distribution''
**''User Defined (still under development)''
*''Number of MC simulations''
*''Mean Wave Angle (deg)''
*''Angle Standard Deviation''
*''Maximum Absolute Wave Angle (deg)''
*''Enable Beach Fill''
**''Beach Fill Std. Dev. percentage''
*''Wave Height Threshold (m)''
*''Min Wave Height''
*''Max Wave Height''
*''Mean Wave Height''
*''Wave Interval''
*If "Rayleigh + Weibull Distribution" selected, the following additional parameters are required:
**''Weibull A Parameter''
**''Weibull B Parameter''
**''Weibull K Parameter''
==<span style="color:red">Water Level Tab</span> ''*NEW*''==
[[File:ModelControl WLevel.png|alt=GenCade Model Control dialog showing the Water Level tab|thumb|400x400px|''GenCade Model Control'' dialog showing the ''Water Level'' tab]]
The following parameters are specified in the Water Level tab:
* ''Enable Water Level Forcing'' &ndash; If turned on, enables the user to enter times and values into a table which will be used to provide additional forcing for the GenCade simulation.
* Water Level Table &ndash; Use the '''Add''' button to create dates and the '''Remove''' button to delete any unwanted dates.
** ''Date/Time''
** ''Water Level'' (ft or m)


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

Latest revision as of 20:49, 3 December 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 for GenCade 2.0 added are shown 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 – option is always "Primary (1)".
  • Number of Cells in Offshore contour Smoothing Window – Default value is 11, but it is suggested that this be and odd number in the range between 11 and 101. If an even number is entered, GenCade will change to the next smaller odd value.


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.
    • "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
    • "Moving" – Represents the amount of shoreline change at a boundary over a specified period of time.
      • Shoreline Displacement Velocity – Shoreline can be displaced over one of the following options:
        • "Simulation Period"
        • "Day"
        • "Time Step"


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:

  • Enable adaptive time steps – If turned on, allows the option to use the default values or set custom values.
  • Once enabled, the following 5 values will have defaults. They can be changed based on user preference.
    • Threshold minimum
    • Threshold maximum
    • Number of days stable
    • Stability minimum
    • Stability maximum


Cross Shore Tab *NEW*

GenCade Model Control dialog showing the Cross Shore tab
GenCade Model Control dialog showing the Cross Shore tab

The following parameters are specified in the cross shore tab:

  • Enable cross-shore transport – If turned on, enables GenCade to include cross shore transport in sediment transport calculations.
  • Cross-shore scaling parameter
  • Onshore transport rate (mm/yr)
  • Enable variable berm height with SLC
  • Enable varying slope with shoreline position



Monte Carlo Tab *NEW*

GenCade Model Control dialog showing the Monte Carlo tab
GenCade Model Control dialog showing the Monte Carlo tab

The following parameters are specified in the Monte Carlo tab:

  • Enable Monte Carlo transport – If turned on, enables run multiple GenCade simulations dependent on several criteria.
  • Probability Function
    • Rayleigh Distribution
    • Rayleigh + Weibull Distribution
    • User Defined (still under development)
  • Number of MC simulations
  • Mean Wave Angle (deg)
  • Angle Standard Deviation
  • Maximum Absolute Wave Angle (deg)
  • Enable Beach Fill
    • Beach Fill Std. Dev. percentage
  • Wave Height Threshold (m)
  • Min Wave Height
  • Max Wave Height
  • Mean Wave Height
  • Wave Interval
  • If "Rayleigh + Weibull Distribution" selected, the following additional parameters are required:
    • Weibull A Parameter
    • Weibull B Parameter
    • Weibull K Parameter

Water Level Tab *NEW*

GenCade Model Control dialog showing the Water Level tab
GenCade Model Control dialog showing the Water Level tab

The following parameters are specified in the Water Level tab:

  • Enable Water Level Forcing – If turned on, enables the user to enter times and values into a table which will be used to provide additional forcing for the GenCade simulation.
  • Water Level Table – Use the Add button to create dates and the Remove button to delete any unwanted dates.
    • Date/Time
    • Water Level (ft or m)