GenCade 2.0 Model Control Dialog: Difference between revisions
mNo edit summary |
mNo edit summary |
||
(14 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{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. | 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. | *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. | |||
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== | ||
Line 18: | Line 19: | ||
*''Print Dates'' – Dates to save simulated shoreline. Use the '''Add''' button to create dates and the '''Remove''' button to delete any unwanted dates. | *''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. | *''Grid Information'' – static information about the GenCade grid including number of cells, grid angle, and length of 1d Grid. | ||
<br clear="all"> | |||
==Beach Setup Tab == | ==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]] | [[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]] | ||
Line 33: | Line 34: | ||
**''K2'' – Range should be 0.5(K1) < K2 < 1.5(K1) | **''K2'' – Range should be 0.5(K1) < K2 < 1.5(K1) | ||
**''<span style="color:red">KTIDE</span>'' – longshore transport coefficient for tide current. | **''<span style="color:red">KTIDE</span>'' – longshore transport coefficient for tide current. | ||
<br clear="all"> | |||
==Seaward BC 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]] | [[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]] | ||
Line 41: | Line 42: | ||
**''Angle Amplification Factor '' | **''Angle Amplification Factor '' | ||
**''Angle Offset '' | **''Angle Offset '' | ||
*''Wave Components to Apply'' – | *''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 number range between 11 and 101. | *''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.'' | ||
<br clear="all"> | <br clear="all"> | ||
==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]] | [[File:ModelControl Lateral.png|alt=GenCade Model Control dialog showing the Lateral BC tab|thumb|''GenCade Model Control'' dialog showing the ''Lateral BC'' tab]] | ||
Line 51: | Line 50: | ||
*''Type'' – Determines one of three boundary types: | *''Type'' – Determines one of three boundary types: | ||
**"Pinned" – Boundary will not move from the initial shoreline position. | **"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. | |||
**"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'' | ***''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" | |||
<br clear="all"> | <br clear="all"> | ||
==Adaptive Time Steps Tab== | ==Adaptive Time Steps Tab== | ||
[[File:ModelControl Adaptive.png|thumb|400x400px|''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: | ||
*'' | *''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 minimum'' | ||
**''Threshold maximum'' | **''Threshold maximum'' | ||
Line 66: | 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'' – 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'' – 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'' – 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) | |||
[[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
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
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
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
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"
- Shoreline Displacement Velocity – Shoreline can be displaced over one of the following options:
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*
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*
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*
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)