GenCade: Difference between revisions

From CIRPwiki
Jump to navigation Jump to search
 
(156 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== GenCade ==
{{DISPLAYTITLE:GenCade - A Regional Shoreline Evolution Simulation Model}}
=Summary=
{{TOC right}}
GenCade is a one-line shoreline simulation model that combines the capabilities of regional-scale, planning-level calculations of CasCade and project-scale, engineering design-level calculations of GENESIS. GenCade computes shoreline change and wave-induced longshore and cross-shore sand transport.  It is operated within the Surface-water Modeling System (SMS) 11.1 interface and higher SMS. The model was officially released in April 2012 and SMS 11.1 was released in October 2012. Publications for GenCade, including technical reports, notes, tutorial materials (video clips and presentation slides) can be found on the [https://cirp.usace.army.mil/products/gencade.php CIRP website GenCade page].


The GenCade interface is undergoing an overhaul and is presently being developed for SMS 13.3. This new interface will be available later this year (2024) and an update to SMS 13.3.


'''POCs:''' Ashley Frey
[[Image:GENESIS_Cascade.jpg|300px|thumb|left|Figure 1. Combination of GENESIS and Cascade]]
<br\>Ashley.E.Frey@usace.army.mil  
<br style="clear:both" />
<br\>601-634-2006
 
<br\>US Army Engineer Research and Development Center (ERDC)
=Tech Transfer=
<br\>Coastal and Hydraulics Lab (CHL)
[[Image:Example_GenCade_setup.jpg|200px|thumb|right|Figure 2. Example GenCade Setup]]
 
Several workshops have been conducted over the years to instruct new users and to highlight new model features:
* February, 2011 - Jacksonville, Florida - Inaugural GenCade workshop.
* August, 2011 - San Diego, California - Full day including demonstrations and hands-on examples
* March, 2012 - Philadelphia, Pennsylvania - Full day including demonstrations and independent student activities
* October, 2012 - First GenCade webinar - 3 days of instruction divided into 2-hour daily sessions.  Included model setup using SMS.
* November, 2018 - Detroit, Michigan - 1 day hands-on for GenCade as part of CMS/GenCade training to the Detroit District.
* May, 2019 - Tampa/St. Pete, Florida - Full day training workshop during the 9th International Conference on Coastal Sediments
* November, 2020 - GenCade webinar - Tutorials and example files can be found at
::[https://cirp.usace.army.mil/techtransfer/webinars/FY21/18Nov2020-webinar.php https://cirp.usace.army.mil/techtransfer/webinars/FY21/18Nov2020-webinar.php].
* September, 2022 - Mobile, Alabama - Full day workshop highlighting new cross-shore transport feature and Monte Carlo simulations.
* June, 2023 - Los Angeles, California - Full day workshop highlighting new cross-shore transport feature and Monte Carlo simulations.
* Planned May 2024 Workshop in Chicago, Illinois.


<br\>Nick Kraus
<br\>Nicholas.C.Kraus@usace.army.mil
<br\>601-634-2016
<br\>US Army Engineer Research and Development Center (ERDC)
<br\>Coastal and Hydraulics Lab (CHL)


<!-----------POC----------------------->
{|style="width:50%; border-spacing:8px;"
|class="MainPageBG" style="width:100%; border:1px solid #cedff2; background:#234B7C ; vertical-align:top; color:#000;"|
{|width="100%" cellpadding="2" cellspacing="5" style="vertical-align:top; background:#f5faff;"
!{{POC|Yan Ding|Yan.Ding@usace.army.mil}}
|-
|style="color:#000;"|
U.S. Army Engineer Research and Development Center (ERDC)
Coastal and Hydraulics Lab (CHL)
For any questions, please contact [mailto://Yan.Ding@usace.army.mil Yan Ding].
|-
|}
|}


GenCade is a 1D model that combines GENESIS with Cascade. It is operated within the Surface-water Modeling System (SMS) interface. The first open release of GenCade is expected to occur in December 2010. A user guide, examples of simple cases, and applications will be posted here.
= GenCade Documentation =
{|class=main width=99%
|style=vertical-align:top;width:33% |  <!-- Left Column Portal -->
===Technical Documentation===
----
'''Model Theory'''
:*[[GenCade:Basic Assumptions|Basic Assumptions]]
:*[[GenCade:Model Capabilities|Model Capabilities]]
:*[[GenCade:Basic Governing Equations|Governing Equations]]
:*[[GenCade:Sand Transport Rates|Sand Transport Rates]]
:*[[GenCade:Empirical Parameters|Empirical Parameters]]
'''Wave Model'''
:*[[GenCade:Wave Calculation|Wave Calculation]]
:*[[GenCade:Internal Wave Transformation|Internal Wave Transformation]]
'''Model Structure'''
:*[[GenCade:Grid System|Grid System]]
:*[[GenCade:Boundary Conditions|Boundary Conditions]]
:*[[GenCade:Numerical Stability|Numerical Stability]]
:*[[GenCade:Representation of Inlets|Representation of Inlets]]
:*[[GenCade:Structures|Structures]]
:*[[GenCade:Sediment Sources and Sinks|Sediment Sources and Sinks]]


= User Guide =
*'''[[GenCade_Tech_Documentation|Technical Documentation]]'''
== Getting Started ==
This guide of GenCade was developed in September 2010. Most of the screenshots used in this guide were created with the July 29, 2010, build of the SMS. The August 25, 2010, build was used to create the screenshots for the Developing Alternatives and Time-dependent Wave Transmission sections. This guide refers to GenCade_v1_066.exe as the most recent executable. Developers are constantly upgrading the SMS and GenCade executables, so a future version may look slightly different from this user guide.
|style=vertical-align:top;width:33%;border-left:1px solid #aaa;padding-left:1em| <!-- Middle Column Portal -->
=== Setup GenCade in the SMS ===


GenCade is one model available in the SMS (Surface-water Modeling System) interface. To use GenCade, a working version of SMS 10.1 and executable for SMS 11.0 Development are necessary. The SMS 11.0 Development executable is copyrighted, so a registration code is necessary before using.
===Interface and User Guide===
----
*[[GenCade_Users_Guide | User Guide]]
'''Getting Started'''
:*[[GenCade_Users_Guide#Preparing_Input_Files | Input]]
:*[[GenCade_Users_Guide#Development_of_a_Conceptual_Model | Conceptual Model]]
:*[[GenCade_Users_Guide#1D_Grid_Setup | Grid Setup]]
:*[[GenCade_Wave_Input | Wave Input]]
:*[[GenCade_Parameters | Parameters]]
:*[[GenCade_Boundary_Conditions | Boundary Conditions]]
:*[[GenCade Input Files| Input Files and Formats]]
:*[[GenCade_Output_Files | Output Files and Formats]]


First, locate the GenCade executable on your machine. Drop the executable into the models folder under SMS 10.1 as shown in Figure 1.
*[[GenCade_Calibration | Model Calibration]]


[[Image:SMS 101.jpg|400px|thumb|left|Figure 1. Models folder in SMS 10.1]]
*[[GenCade_Users_Guide#Developing_Alternatives | Developing Alternatives]]
<br style="clear:both" />
 
Once again, the capabilities of GenCade are only available in SMS 11.0 Development. If SMS 10.1 is already installed on the computer and a registration code for SMS 11.0 Development has been obtained, simply drag the SMS 11.0 executable into the SMS 10.1 folder (most likely in Program Files). Double-click on the SMS 11.0 executable to open SMS 11.0 Development. At this time, a prompt will open asking for the registration code. Before beginning to work in GenCade, go to Edit->Preferences. Select the tab File Locations and scroll down to GenCade under Model Executables. Click the button under Executable located directly to the right of GenCade. If GenCade has not been used previously, the button will most likely say BROWSE. After selecting this button, find the latest GenCade executable on the computer and select. The row to the right will specify the location of the executable which will be used to run GenCade (Figure 2).
*[[GenCade_Example | GenCade Tutorial/Example]]


[[Image:GenCade executable.jpg|400px|thumb|left|Figure 2. Specify GenCade executable]]
*[[GenCade_FAQs | Frequently Asked Questions]]
<br style="clear:both" />


=== Set the current projection ===
===Releases===
GenCade uses a real world coordinate system, so it is necessary to set up the current projection upon opening the SMS. Aerial photos, shorelines, and other georeferenced files can be opened in the SMS. Go to Edit->Projection and define the current projection (Figure 3). This will ensure all shorelines, structures, wave gages, and other important features are mapped correctly.
----


[[Image:current projection.jpg|400px|thumb|left|Figure 3. Specify current projection]]
*[[GenCadeReleases|GenCade Model Releases]]
<br style="clear:both" />
=== Reproject current projection===
In some cases, the shorelines and the aerial photo may be in different coordinate systems. To change the projection, go to Edit->Reproject. A new window will open where the current projection and new projection can be specified (Figure 4).


[[Image:reproject.jpg|400px|thumb|left|Figure 4. Reproject]]
|style=vertical-align:top;width:33%;border-left:1px solid #aaa;padding-left:1em| <!-- Right Column Portal -->
<br style="clear:both" />


== Preparing Input Files ==
===Model Validation & Benchmark Cases===
=== Initial shoreline ===
----
Before dragging a file into the SMS interface, right click on default coverage under Map Data in the left panel. Select Type->Models->GenCade. To bring in a shoreline or regional contour as a *.cst, the original text file must be modified. See Figure 5 for the required format. The first number in the third row represents the number of points in the file. The other numbers in the first three rows will remain the same.


[[Image:initial shoreline type.jpg|400px|thumb|left|Figure 5. Define coverage as GenCade and format shoreline as *.cst]]
*[[GenCade_Val:LSTF|LSTF Laboratory Cases]]
<br style="clear:both" />
*[[GenCade_Val:Benchmark Cases|Benchmark Cases]]
*[[GenCade_Val:Genesis Validation - Jucar River|GenCade Validation to Jucar River, Cullera, Spain]]


Once the shoreline is represented in the interface, click the Select Feature Arc button and double-click on the shoreline. The GenCade Arc Attributes will open. Select Initial Shoreline and click OK (Figure 6). Now the shoreline is defined.
===Examples===
----


[[Image:define shoreline.jpg|400px|thumb|left|Figure 6. Define as shoreline]]
*[[GenCade_Applications|GenCade Applications]]
<br style="clear:both" />


=== Regional contour or additional shorelines ===
*[[GenCade_Applications_USACE Districts Previous Projects | USACE Districts]]
In some cases, it may be necessary to include a regional contour or additional shorelines. Right-click on Map Data and select New Coverage. A window will open; scroll down and select GenCade as the coverage type (Figure 7). Open the regional contour in the interface, and click on the Select Feature Arc button. After double-clicking on the regional contour, select Regional Contour as the Arc Option in the GenCade Arc Attributes window (Figure 8). Additional shorelines can be added in a similar fashion.


[[Image:new coverage.jpg|400px|thumb|left|Figure 7. Define new coverage as GenCade]]
*[[GenCade_Applications_CIRP Projects Previous Projects | CIRP Led Projects]]
<br style="clear:both" />


[[Image:regional contour.jpg|400px|thumb|left|Figure 8. Define as regional contour]]
'''Private Sector'''
<br style="clear:both" />
:*[[GenCade_Applications_Private Sector U.S. Previous Projects|United States]]
:*[[GenCade_Applications_Private Sector International Previous Projects|International]]


=== Merge coverages ===
*[[GenCade_Lessons_Learned|GenCade Lessons Learned]]
After the initial shoreline and regional contour have been loaded and defined in the SMS interface, it is necessary to merge the two lines in a single coverage. All structures, inlets, wave gages, and other features will be created in this single coverage. Highlight both the default coverage (initial shoreline) and the new coverage (regional contour). Right-click and select Merge Coverages (Figure 9). A window will open asking "Do you want to delete the coverages used to make the merged coverage?" By selecting no, the initial shoreline and regional contour will remain in the interface and if a problem occurs, these coverages can be merged again. It may be necessary to redefine the shoreline and regional contour in this new coverage.


[[Image:regional contour.jpg|400px|thumb|left|Figure 9. Merge coverages]]
===Tools & Links===
<br style="clear:both" />
----
*[[Statistics| Goodness-of-Fit Statistics]]
*[[GenCade References| GenCade References]]

Latest revision as of 14:17, 28 March 2024

Summary


GenCade is a one-line shoreline simulation model that combines the capabilities of regional-scale, planning-level calculations of CasCade and project-scale, engineering design-level calculations of GENESIS. GenCade computes shoreline change and wave-induced longshore and cross-shore sand transport. It is operated within the Surface-water Modeling System (SMS) 11.1 interface and higher SMS. The model was officially released in April 2012 and SMS 11.1 was released in October 2012. Publications for GenCade, including technical reports, notes, tutorial materials (video clips and presentation slides) can be found on the CIRP website GenCade page.

The GenCade interface is undergoing an overhaul and is presently being developed for SMS 13.3. This new interface will be available later this year (2024) and an update to SMS 13.3.

Figure 1. Combination of GENESIS and Cascade


Tech Transfer

Figure 2. Example GenCade Setup

Several workshops have been conducted over the years to instruct new users and to highlight new model features:

  • February, 2011 - Jacksonville, Florida - Inaugural GenCade workshop.
  • August, 2011 - San Diego, California - Full day including demonstrations and hands-on examples
  • March, 2012 - Philadelphia, Pennsylvania - Full day including demonstrations and independent student activities
  • October, 2012 - First GenCade webinar - 3 days of instruction divided into 2-hour daily sessions. Included model setup using SMS.
  • November, 2018 - Detroit, Michigan - 1 day hands-on for GenCade as part of CMS/GenCade training to the Detroit District.
  • May, 2019 - Tampa/St. Pete, Florida - Full day training workshop during the 9th International Conference on Coastal Sediments
  • November, 2020 - GenCade webinar - Tutorials and example files can be found at
https://cirp.usace.army.mil/techtransfer/webinars/FY21/18Nov2020-webinar.php.
  • September, 2022 - Mobile, Alabama - Full day workshop highlighting new cross-shore transport feature and Monte Carlo simulations.
  • June, 2023 - Los Angeles, California - Full day workshop highlighting new cross-shore transport feature and Monte Carlo simulations.
  • Planned May 2024 Workshop in Chicago, Illinois.


POC: Yan Ding, Yan.Ding@usace.army.mil

U.S. Army Engineer Research and Development Center (ERDC) Coastal and Hydraulics Lab (CHL) For any questions, please contact Yan Ding.

GenCade Documentation

Technical Documentation

Model Theory

Wave Model

Model Structure

Interface and User Guide

Getting Started

Releases

Model Validation & Benchmark Cases

Examples

Private Sector

Tools & Links
Retrieved from "https://cirpwiki.info/index.php?title=GenCade&oldid=14521"