GenCade Users Guide: Difference between revisions

From CIRPwiki
Jump to navigation Jump to search
No edit summary
(46 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Getting Started =
__NOTOC__
This GenCade guide was last updated in November 2010. Most of the screenshots used in this guide were created with the August 25, 2010, build of the SMS. This guide refers to GenCade_v1_070.exe as the most recent executable. Developers are constantly upgrading the SMS and GenCade executables, so the graphics in a future version may look slightly different than the visuals included in this user guide.
= 1. Getting Started =
This GenCade guide was last updated in November 2012. Most of the screenshots used in this guide were created with the August 19, 2011, build of the SMS. Developers are constantly upgrading the SMS and GenCade executables, so the graphics in a future version may look slightly different than the visuals included in this user guide.


A very simple example can be found [[GenCade_Example|here]]. This example shows all steps necessary to produce results and includes a zip file with all of the input and output files that can be used to reproduce the results on another computer.
A very simple example can be found [[GenCade_Example|here]]. This example shows all steps necessary to produce results and includes a zip file with all of the input and output files that can be used to reproduce the results on another computer.


== Setup GenCade in the SMS ==
== 1.1 Setup GenCade in the SMS ==
GenCade is 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.  
GenCade is run within the SMS 11.1 Development. SMS 11.0 and earlier versions do not have interfaces for GenCade. This section will guide a user through the process to set up the conceptual model, convert to a 1D grid, review the GenCade model, run GenCade, visualize results, and develop alternatives. It is assumed that the reader has no previous experience with GenCade.  


First, locate the GenCade executable on the machine. As of November 2010, the most recent GenCade executable is GenCade_v1_070.exe. Drop the executable into the models folder under SMS 10.1 as shown in Figure 1.
First, the GenCade executable must be identified on the machine. The GenCade executable is GenCade_v1r3.exe. If SMS 11.1 Beta is installed on the machine, the GenCade executable will be located in the models folder.


[[Image:SMS 101.jpg|400px|thumb|left|Figure 1. Models folder in SMS 10.1]]
Once SMS 11.1 is open on the machine, it is necessary to specify the location of the GenCade executable. If this is specified incorrectly or not at all, GenCade will not run. In order to indicate the location of the executable, it is necessary to click on ''Edit'', go to ''Preferences'', and click on the tab labeled ''File Locations''. The user should scroll down to ''GenCade'' under ''Model Executables'' and click on ''BROWSE''. Once the GenCade executable is selected, the path for the executable should be listed under ''Model Executables'' next to ''GenCade''. Figure 1 shows the ''File Locations'' window.
 
[[Image:fig1_def_Gen.jpg|400px|thumb|left|Figure 1. Define GenCade model executable]]
<br style="clear:both" />
<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. Enter the registration code when prompted. 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).


[[Image:gencade executable a.png|400px|thumb|left|Figure 2. Specify GenCade executable]]
== 1.2 Set the Current Projection ==
GenCade uses a real world coordinate system, so it is necessary to set up the current projection upon opening the SMS. GenCade projects may be set up in either U.S. customary units or SI units. The user may select the appropriate projection by clicking ''Edit->Projection''. The steps to set up the projection are shown in Figure 2. This ensures all shorelines, structures, wave gauges, and other important features are mapped correctly. The user may also open aerial photographs to aid in completing the conceptual model. In many cases, the files representing shorelines and other features may be georeferenced correctly without defining the current projection; however, it is a good idea to define the projection before starting a GenCade project.
 
[[Image:fig2_spec_proj.jpg|400px|thumb|left|Figure 2. Specify projection]]
<br style="clear:both" />
<br style="clear:both" />


== Set the current projection ==
== 1.3 Changing the Projection ==
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. In many cases, the file may be georeferenced correctly without defining the current projection; however, it is a good idea to define the projection in all cases.
In some cases, an aerial photograph may be defined in a different coordinate system than the shorelines. There are two ways to change the projection of the project. For a case where the user would like to convert the shoreline and the project to the same projection as the imported aerial photo, there are several steps to follow. First, go to ''Edit->Project'', specify the projection used for the shoreline, and bring in the shoreline (more information on the format of shorelines is in 2.1). Right click on the coverage including the shoreline under ''Map Data'' in the left panel and go to ''Reproject''. A warning will pop up notifying the user that the command is non-reversible. After clicking ''Yes'', the ''Reproject Object'' window will open. Check ''Set'' and change the new projection to the projection of the aerial photo (Figure 3). Go back to ''Edit->Project'' and change the projection to match the projection of the aerial photo (Figure 4). All of the units will match the projection of the aerial photo. Now the aerial photo can be opened in the SMS, and the shoreline will overlay the aerial photograph correctly (Figure 5).


[[Image:current projection.jpg|400px|thumb|left|Figure 3. Specify current projection]]
[[Image:reproject_coverage.jpg|400px|thumb|left|Figure 3. Reprojection map projection]]
<br style="clear:both" />
<br style="clear:both" />


== Reproject current projection==
[[Image:change_projection.jpg|400px|thumb|left|Figure 4. Change projection]]
In some cases, the shorelines and the aerial photo may be in different coordinate systems. A user may also wish to use a different coordinate system for GenCade than the coordinate system of the aerial photo. 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).
<br style="clear:both" />


[[Image:reproject.jpg|400px|thumb|left|Figure 4. Reproject]]
[[Image:current_projection_aerial.jpg|400px|thumb|left|Figure 5. Confirmation of change in projection]]
<br style="clear:both" />
<br style="clear:both" />


= Preparing Input Files =
It is much simpler to use the units from the shoreline shapefile or text file for the project. In this case, the aerial photograph will need to be reprojected. First, go to ''Edit->Project'' and define the projection. Then open the shoreline, right click on the coverage, and go to ''Projection (floating)'' (Figure 6). It should be confirmed that the object projection matches the projection defined under ''Edit->Project''. When the aerial photo is opened, SMS will automatically convert the aerial photo to the correct projection so that the photo matches the shorelines (Figure 7).
== 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''. In the GenCade model, the initial shoreline or regional contour must be in the *.cst format. 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. This is similar to the old GENESIS format.
[[Image:object_projection_coverage.jpg|400px|thumb|left|Figure 6. Reproject object projection]]
<br style="clear:both" />


[[Image:initial shoreline type.jpg|400px|thumb|left|Figure 5. Define coverage as GenCade and format shoreline as *.cst]]
[[Image:current_projection_shore.jpg|400px|thumb|left|Figure 7. Reproject current projection]]
<br style="clear:both" />
<br style="clear:both" />


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.
= 2. Preparing Input Files =
== 2.1 Open and Define Initial Shoreline ==
As mentioned previously, an initial shoreline is required to run GenCade. The model type must be defined as ''GenCade'' before opening any file in the SMS. This can be accomplished by selecting ''Type->Models->GenCade'' after right clicking on the default coverage under ''Map Data'' in the data tree (panel on left side of screen). If the user has a file with a list of shoreline points that is in the same projection as the project, the file may be opened in the SMS. Before the file is opened in the SMS, it is important to double check the projection of coverage under ''Map Data''.  This can be done by right clicking on the coverage and clicking on Projection. If it is necessary to convert to a new projection for the shoreline, right click on the coverage and go to ''Reproject''. A warning will pop up explaining that this is a non-reversible command; select ''Yes''. Then a new window will open allowing the user to define the ''Current projection'' and the ''New projection''. To read the file into the conceptual model correctly, the file must be in *.cst format. The *.cst format requires the x and y coordinates of every point along the shoreline. An example of the format is shown in Figure 8. In order to modify a file with x and y coordinates for a shoreline, add the first three lines shown in Figure 8 which have been carried over from the old GENESIS format. The first number on the third line represents the total number of shoreline points listed in the file. This is the only number in the first three lines that will differ from the file shown in Figure 8.


[[Image:define shoreline.jpg|400px|thumb|left|Figure 6. Define as shoreline]]
[[Image:fig4_cst.jpg|400px|thumb|left|Figure 8. Example format of *.cst file]]
<br style="clear:both" />
<br style="clear:both" />


== Regional contour or additional shorelines ==
There are many different ways to create an initial shoreline for GenCade in the SMS. If the shoreline is represented by points in a shapefile, these can be converted into a scatter set and saved as a text file. Then the text file can be modified to create the proper *.cst format and opened in the SMS.
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.
 
A GenCade initial shoreline can also be created from a polyline shapefile. Once the shapefile is opened in the SMS, it is necessary to click on ''Mapping'' and select ''Shapes->Feature Objects'' (Figure 9). This will create a ''Feature Arc''. After converting the ''Map Data'' to ''GenCade'', the arc may be selected by clicking on the ''Select Feature Arc'' button and by double-clicking. If the shapefile was converted into multiple arcs, it is necessary to connect these segments to create one arc (Figure 10). Click on the ''Create Feature Arc'' button and draw an arc connecting the existing arcs.  Click on the ''Select Feature Point'' button and select all of the nodes between the existing and the new arcs. To convert the nodes to vertices, go to ''Feature Objects'' and select ''Vertices<->Nodes''. Once all of the nodes have been converted to vertices, the shoreline is in the proper format for GenCade. When developing a shoreline in GenCade from a polyline shapefile, it is not necessary to create a *.cst file.  


[[Image:new coverage.jpg|400px|thumb|left|Figure 7. Define new coverage as GenCade]]
[[Image:fig5_convert.jpg|400px|thumb|left|Figure 9. Convert shapefile to feature objects]]
<br style="clear:both" />
<br style="clear:both" />


[[Image:regional contour.jpg|400px|thumb|left|Figure 8. Define as regional contour]]
[[Image:fig6_connect.jpg|400px|thumb|left|Figure 10. Connect segments to create one feature arc]]
<br style="clear:both" />
<br style="clear:both" />


== Merge coverages ==
Regardless of whether or not the initial shoreline is opened as a *.cst file, the initial shoreline must be defined. To define the initial shoreline, ''GenCade'' must be selected as the model type for the coverage. The feature arc representing the shoreline should be double-clicked (or right-click and select Attributes) after clicking on the ''Select Feature'' Arc button. The ''GenCade Arc Attributes'' window will open. The ''Initial Shoreline'' option should be selected under ''Arc Options''. These steps are shown in Figure 11.
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). This can be done by hitting ctrl on the keyboard and clicking on both coverages. 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?"'' The initial shoreline and regional contour will remain in the interface if no is selected. 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:merge coverages.jpg|400px|thumb|left|Figure 9. Merge coverages]]
[[Image:fig7_shoreline.jpg|400px|thumb|left|Figure 11. Define arc as initial shoreline]]
<br style="clear:both" />
<br style="clear:both" />


= Grid Setup =
== 2.2 Open and Define Regional Contour or Additional Shorelines ==
== Orientation and cell size ==
In some cases, a regional contour or additional shorelines may need to be added to the conceptual model. In order to define a second feature arc, it is necessary to right-click on ''Map Data'' and select a ''New Coverage''. This new coverage must also be defined as ''GenCade''. The user can rename the new coverage, so that it can easily be identified. It is very important to open the new arc in a new coverage. If the arc is opened in the same coverage as the initial shoreline, the two arcs will most likely overlap, and the arcs will be split into many arcs. Once the regional contour is opened in the interface, define the arc as ''Regional Contour'' in the ''GenCade Arc Attributes'' window (Figure 12). A shoreline representing the final shoreline or an additional shoreline may be defined as a ''Reference Line''.  
After merging the shoreline and regional contour into one coverage, the grid can be setup. If the grid size and orientation are known, it is advisable to setup the grid before adding any features to coverage. To manually draw the grid frame, click on the ''Create 1-D Grid Frame''. The GenCade grid frame will be purple and have an arrow at one end. If a person was walking down the grid to the arrow, the water would be to the left and the land would be to the right. For example, if the GenCade grid arrow was pointing south, the water would be to the east (left) and the land would be to the west (right). The grid can be modified by clicking the ''Select 1-D Grid Frame'' and double-clicking on the square in the center of the purple grid line. The ''Grid Frame Properties'' window will open, and the ''Origin X'', ''Origin Y'', ''Angle'', and ''I size'' can be modified (Figure 10). The I size is the length of the grid. The cell size can be constant or variable. If the user chooses to change the cell size under ''define cell sizes'', the number of cells will change accordingly.


[[Image:grid frame a.png|400px|thumb|left|Figure 10. Grid frame properties]]
[[Image:fig8_rc.jpg|400px|thumb|left|Figure 12. Define arc as regional contour]]
<br style="clear:both" />
<br style="clear:both" />


== Inlets, shoals, jetties, and dredging ==
== 2.3 Merge Coverages ==
To create an inlet, select the ''Create Feature Arc'' button and draw a line from one side of the inlet to the other (Figure 11). This is why it is helpful to have a high quality aerial in the background. Once the inlet is drawn, click on the ''Select Feature Arc'' button and double-click on the line representing the inlet. The ''GenCade Arc Attributes'' window will open. Select ''Inlet'' and click on ''Attributes''. This will open the ''Inlet Reservoir Model'' window. The inlet can be named, shoal volumes defined, and dredging added. Click on the ''Volume'' button to add the initial and equilibrium shoal volumes for the ebb, flood, left bypass, left attachment, right bypass, and right attachment. Similarly, in the ''Dredging'' window, the user can define the beginning date, the ending date, the volume, and the shoal to be mined (Figure 12). After clicking ''OK'', the line representing the inlet will turn blue.
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). This can be done by hitting ctrl on the keyboard and clicking on both coverages. After right-clicking, select ''Merge Coverages''. A window will open asking if the user would like to delete the coverages used to make the merged coverage. If no is selected, the initial shoreline and regional contour coverages will remain in the interface. It is a good idea to keep these coverages in the interface. If a problem occurs with the merged coverage, the initial shoreline and regional contour may be merged again. Figure 13 shows how coverages are merged while Figure 14 illustrates the initial shoreline and regional contour in the merged coverage.


[[Image:create inlet.jpg|400px|thumb|left|Figure 11. Create an inlet]]
[[Image:fig9_merge.jpg|400px|thumb|left|Figure 13. Merge initial shoreline and regional contour in a single coverage]]
<br style="clear:both" />
<br style="clear:both" />


[[Image:inlet reservoir model.png|400px|thumb|left|Figure 12. Define inlet properties]]
[[Image:fig10_merge.jpg|400px|thumb|left|Figure 14. Arcs for initial shoreline and regional contour defined after merging into a single coverage]]
<br style="clear:both" />
<br style="clear:both" />


A jetty can be drawn at the inlet after selecting the ''Create Feature Arc'' button. After drawing the jetty, click on the ''Select Feature Arc'' and double-click on the line representing the jetty. When the ''GenCade Arc Attributes'' window opens, select either ''Left Jetty on Inlet'' or ''Right Jetty on Inlet'' (remember the left jetty is to the left of a person standing on land facing the ocean) and click on ''Attributes''. A new window will open where the permeability can be chosen, the jetty can be defined as diffracting or non-diffracting, and a seaward depth can be added (Figure 13). The line representing a jetty will also turn blue.
= 3. Grid Setup =
== 3.1 Create Inlets, Shoals, Dredging Events, and Jetties ==
The inlet name, inlet shoal volumes, dredging events, and bypassing coefficients may be defined when an inlet is created. To do this, select the ''Create Feature Arc'' button and draw a line from one side of the inlet to the other. When creating inlets and other features, a high quality aerial photo is very helpful. After the inlet is created, click on the ''Select Feature Arc'' button and double-click on the arc representing the inlet. This can also be accomplished by a single click, followed by a right click. The ''GenCade Arc Attributes'' window will open. Select ''Inlet'' and click on ''Attributes''. The ''Inlet Reservoir Model'' window will open. The inlet can be named, shoal volumes can be defined, and dredging events can be added. The initial and equilibrium shoal volumes for the ebb, flood, left bypass, left attachment, right bypass, and right attachment can be defined after clicking on the ''Volume'' button. Similarly, after clicking on ''Dredging'', the ''Dredging Events'' window will open and the user can specify the beginning and ending date, the volume, and the shoal to be mined for each dredging event. The user also has the option to modify the left and right bypassing coefficients when jetties are present. Both the left and right bypassing coefficients have a default value of 1. This value will always be zero or larger. However, due to the measured distances included in the bypassing coefficient equation, it is highly unlikely that the bypassing coefficient will be larger than 100. Inlets that do not have jetties will not have a bypassing coefficient. After the inlet information is specified, the arc representing the inlet will turn blue. All of the steps create an inlet and add shoal volumes and dredging events are shown in Figure 15.


[[Image:jetty.jpg|400px|thumb|left|Figure 13. Define jetty properties]]
[[Image:fig11_inlets.jpg|400px|thumb|left|Figure 15. Create and define an inlet, shoal volumes, and dredging events]]
<br style="clear:both" />
<br style="clear:both" />


== Beach fills ==
A jetty can be created at the inlet after selecting the ''Create Feature Arc'' button. The arc representing the jetty should not intersect with the arc representing the inlet, regional contour, or initial shoreline. If this occurs, either the arc representing the jetty or the regional contour or initial shoreline will be split into two separate arcs. To remedy the problem of splitting arcs; the user should delete the arc representing the jetty, convert the newly created node to a vertex, and redefine the formerly split arc. After drawing the jetty, the user should click on the ''Select Feature Arc'' and double-click on the line representing the jetty. When the ''GenCade Arc Attributes'' window opens, the ''Left Jetty on Inlet'' or ''Right Jetty on Inlet'' should be selected. The left jetty is to the left of a person standing on land looking at the ocean. After ''Attributes'' is selected, a new window will open where the ''Permeability'' can be specified, ''Diffracting'' can be checked or unchecked, and a seaward depth can be added. The default value for ''Permeability'' is 0. Although ''Diffracting'' is unchecked as a default option, the user should check this box in most cases. The line representing a jetty will also turn blue once all of required jetty information is provided. Figure 16 shows how to create a jetty.
Beach fills can be drawn in the same way as inlets. Select the ''Create Feature Arc'' button to draw the beach fill. Beach fills can be drawn directly on the shoreline or slightly offshore. If there are many beach fills in one location during the simulation, each beach fill should be placed slightly offshore so they do not overlap. After each beach fill is drawn, click on the ''Select Feature Arc'' and double-click on the line representing the beach fill. Select the ''Beach Fill Event'' after the ''GenCade Arc Attributes'' window opens. For each beach fill, add the starting and end dates and the added berm width (Figure 14). After selecting ''OK'' in the ''GenCade Arc Attributes'' window, the line representing the beach fill will turn green.


[[Image:beach fill.jpg|400px|thumb|left|Figure 14. Define beach fill properties]]
[[Image:fig12_jetty.jpg|400px|thumb|left|Figure 16. Create and define a jetty]]
<br style="clear:both" />
<br style="clear:both" />


== Groins ==
Once the grid is converted to GenCade, the bypassing associated with an inlet is defaulted to the one cell immediately adjacent to either side of the inlet. However, the size and location may be defined in the conceptual model by selecting the ''Create Feature Arc'' button and drawing the arc. Double-click on the arc after creating to open the ''GenCade Arc Attributes'' window. The arc should be defined as an ''Attachment Bar'' (Figure 17). The attachment bar is also represented by a blue line.
Once the location for a groin is chosen, select the ''Create Feature Arc'' button. In most cases, the arc representing the groin will cross the regional contour and initial shoreline. Do not draw either end of the groin near the regional contour or initial shoreline. When this occurs, the node from the groin will connect to the initial shoreline or regional contour. This will divide the regional contour or initial shoreline into two separate arcs, where only one of the arcs will be considered the regional contour or initial shoreline. At this point, GenCade does not have the capability to identify multiple arcs for the initial shoreline or regional contour. The best way to prevent this (at this time) is to save often, reopen the project, and redo the steps that were not saved. After drawing the feature arc for the groin, click on the ''Select Feature Arc'' button. The ''GenCade Arc Attributes'' window will open. Select groin in the ''Arc Options'' menu and click on ''Attributes''. The window for groins includes the permeability and seaward depth (in the user specified units). The user may also decide "Diffracting" or "Non-diffracting" for the groin.


[[Image:groin.jpg|400px|thumb|left|Figure 15. Define groin properties]]
[[Image:fig13_attach.jpg|400px|thumb|left|Figure 17. Create and define an attachment bar]]
<br style="clear:both" />
<br style="clear:both" />


== Detached Breakwaters ==
== 3.2 Seawalls ==
A detached breakwater is created by selecting the ''Create Feature Arc'' button and drawing the arc representing the detached breakwater. Click on the ''Select Feature Arc button'' and double-click on the detached breakwater. The ''GenCade Arc Attributes'' window will open. Scroll down to ''Breakwater'' and click on ''Attributes''. The depth at each end of the detached breakwater can be entered in the ''Detached Breakwater'' window. There is a pull-down window for wave transmission which includes constant transmission and three equations for time-dependent wave transmission: Ahrens, Seabrook and Hall, and d'Angremond.
To draw a seawall, first the ''Create Feature Arc'' button should be selected. The seawall must be drawn landward of the shoreline. If the user attempts to draw the seawall directly on top of the initial shoreline, an error will occur. The seawall drawn by the user should resemble the shape of the real seawall as closely as possible. If the user is not meticulous in drawing the seawall, the shape of the seawall in the GenCade model may not resemble the actual seawall. Additionally, since cell numbers are used in the GenCade model, the seawall shape may look different after converting from the conceptual model. After the seawall is drawn, the user should click on the Select Feature Arc button and click on the seawall. The ''GenCade Arc Attributes'' window will open. ''Seawall'' should be selected in ''Arc Options''. The seawall will turn blue. When the model is converted to a 1D grid, an error message referring to the seawall may pop up. This message should be ignored; GenCade will modify the cells defined for the seawall. The user should review the seawall in the GenCade model. If the seawall does not resemble the actual seawall, the cell numbers and distances from the grid should be revised. A smaller cell size near the seawall may also be helpful. The process to create a seawall is shown in Figure 18.
 
[[Image:fig14_seawall.jpg|400px|thumb|left|Figure 18. Create and define a seawall]]
<br style="clear:both" />


=== Constant Transmission ===
== 3.3 Beach Fills ==
Under the ''Transmission'' bar, select constant. The last column in the detached breakwaters window is ''coeff/perm/atts''. For constant transmission, this represents the permeability of the detached breakwater. Once all necessary information is entered, click ''OK''. The detached breakwater will turn blue.
Beach fills can be created in the same way as inlets and seawalls. One should select the ''Create Feature Arc'' button to draw the beach fill. Beach fills should be drawn slightly offshore. If there are many beach fills in one location during the simulation, draw the beach fills carefully so they do not connect or intersect. After each beach fill is drawn, click on the ''Select Feature Arc'' and double-click on the line representing the beach fill. Select the ''Beach Fill Event'' after the ''GenCade Arc Attributes'' window opens. For each beach fill, add the ''Begin Date'' and ''End Date'' and the ''Added Berm Width''. After selecting ''OK'' in the ''GenCade Arc Attributes'' window, the line representing the beach fill will turn green. Figure 19 demonstrates the steps to create and define beach fill events.


[[Image:constant_transmission.jpg|400px|thumb|left|Figure 16. Constant Transmission]]
[[Image:fig15_beach_fill.jpg|400px|thumb|left|Figure 19. Create and define a beach fill]]
<br style="clear:both" />
<br style="clear:both" />


=== Time-dependent Wave Transmission ===
== 3.4 Bypass Event ==
==== Ahrens ====
 
After selecting ''Ahrens'' under ''Transmission'' in the ''Detached Breakwater'' window, the final column (''coeff/perm/atts'') can be selected. Once the mouse clicks on this box, the ''Breakwater Attributes'' window will open. For Ahrens, the required values include freeboard to MSL, width, seaward side slope, shoreward side slope, and the D50 of the armor stone. Click OK, and the detached breakwater should turn blue.
Another option in GenCade is a bypass event. The user should select the ‘’Create Feature Arc’’ button and draw the bypass event in the desired location. After the event is created, the user should click on the ‘’Select Feature Arc’’ button and double-click on the arc representing the bypass event. Once ‘’Bypass Event’’ is selected in the ‘’GenCade Arc Attributes’’ window, the ‘’Bypassing’’ window will open. A ‘’Begin Date’’, ‘’End Date’’, and ‘’Bypass Rate’’ can be specified. If the project projection is in USCS, the bypass rate is cubic yards per hour. Likewise, the bypass rate is cubic meters per hour when SI units are used. Figure 20 demonstrates the steps to create and define bypass events.


[[Image:ahrens_transmission.jpg|400px|thumb|left|Figure 17. Ahrens]]
[[Image:bypass_event.jpg|400px|thumb|left|Figure 20. Create and define a bypass event]]
<br style="clear:both" />
<br style="clear:both" />


==== d'Angremond ====
== 3.5 Detached Breakwaters ==
Another equation that can be used for time-dependent wave transmission is d'Angremond. Similarly to selecting Ahrens, click on the final column of the ''Detached Breakwaters'' window which should now say ''Atts''. For d'Angremond, the freeboard to MSL, width, seaward side slope, shoreward side slope, and permeability are required.
A detached breakwater is created by selecting the ''Create Feature Arc'' button and drawing the arc representing the detached breakwater. The user should click on the ''Select Feature Arc'' button and double-click on the detached breakwater. The ''GenCade Arc Attributes'' window will open. Scroll down to ''Breakwater'' and click on ''Attributes''. The depth at each end of the detached breakwater can be entered in the ''Detached Breakwater'' window. There is a pull-down window for wave transmission which includes constant transmission and three equations for time-dependent wave transmission: Ahrens, Seabrook and Hall, and d'Angremond.
 
=== 3.5.1 Constant Transmission ===
Under the ''Transmission'' bar, select ''Constant''. The last column in the detached breakwaters window is ''Coeff/Perm/Atts''. For constant transmission, this represents the permeability of the detached breakwater. Once all necessary information is entered, click ''OK''. The detached breakwater will turn orange. A detached breakwater with constant transmission is shown in Figure 21.


[[Image:dangremond_transmission.jpg|400px|thumb|left|Figure 18. d'Angremond]]
[[Image:fig16_breakwater.jpg|400px|thumb|left|Figure 21. Create and define a breakwater with constant transmission]]
<br style="clear:both" />
<br style="clear:both" />


==== Seabrook and Hall ====
=== 3.5.2 Time-dependent Wave Transmission ===
Seabrook and Hall can also be used for time-dependent wave transmission. After selecting Seabrook and Hall in the ''Detached Breakwaters'' window, click on ''Atts'' in the final column. The ''Breakwater Attributes'' window will open, and the freeboard to MSL, width, seaward side slope, shoreward side slope, and D50 of the armor stone can be entered.  
==== 3.5.2.1 Ahrens ====
After selecting Ahrens under ''Transmission'' in the ''Detached Breakwater'' window, the final column (''Coeff/Perm/Atts'') can be selected. Clicking this box will open the ‘’Breakwater Attributes’’ window. For Ahrens, the required values include freeboard to MSL, width, seaward side slope, shoreward side slope, and the D50 of the armor stone (Figure 22). Click ''OK'', and the detached breakwater should turn orange.


[[Image:seabrook_transmission.jpg|400px|thumb|left|Figure 19. Seabrook and Hall]]
==== 3.5.2.2 d'Angremond  ====
Another equation that can be used for time-dependent wave transmission is d'Angremond. Similarly to the option for ''Ahrens'', click on the final column of the ''Detached Breakwaters'' window which should now say ''Atts''. For d'Angremond, the freeboard to MSL, width, seaward side slope, shoreward side slope, and permeability are required (Figure 23).
 
==== 3.5.2.3 Seabrook and Hall ====
Seabrook and Hall can also be used for time-dependent wave transmission. After selecting Seabrook and Hall in the ''Detached Breakwaters'' window, click on ''Atts'' in the final column. The ''Breakwater Attributes'' window will open, and the freeboard to MSL, width, seaward side slope, shoreward side slope, and D50 of the armor stone can be entered (Figure 24).
 
[[Image:fig17_ahrens.jpg|400px|thumb|left|Figure 22. Define breakwater using Ahren’s method for transmission]]
<br style="clear:both" />
<br style="clear:both" />


==== Water Level File ====
[[Image:fig18_dangremond.jpg|400px|thumb|left|Figure 23. Define breakwater using d’Angremond method for transmission]]
Regardless of the equation used for time-dependent wave transmission, water level data is required. Once attributes for the breakwaters are assigned and the conceptual model is completed, convert to 1D grid. In the ''GenCade'' menu, go to ''Edit Water Level'' Data. This window includes two columns: the date and water level. The date needs to be entered in the same format as for wave information ([[GenCade_Users_Guide#Wave_Data|section 3.6]]). The best way to develop the water level file is to use Excel or a computer program, and paste the list of events into GenCade.
<br style="clear:both" />


[[Image:water_level.jpg|400px|thumb|left|Figure 20. Enter Water Level Events]]
[[Image:fig19_seabrook_hall.jpg|400px|thumb|left|Figure 24. Define breakwater using Seabrook and Hall method for transmission]]
<br style="clear:both" />
<br style="clear:both" />


After saving the project, the water level file (*.wl) will appear in the same folder as all of the other input files. The *.gen file will include this as an input file. The detached breakwaters section of the *.gen will include all of the variables entered for the detached breakwater.
== 3.6 Groins ==
Once the location for a groin is chosen, select the ''Create Feature Arc'' button. In many cases, the arc representing the groin will cross the regional contour and initial shoreline. Do not draw either end of the groin near the regional contour or initial shoreline. When this occurs, the node from the groin will connect to the initial shoreline or regional contour. This will divide the regional contour or initial shoreline into two separate arcs, where only one of the arcs will still be defined as the regional contour or initial shoreline.  To remedy this, delete the arc that was created to represent the groin. Highlight the node that divides the initial shoreline into two segments. Under Feature ''Objects'', select ''Vertices<->Nodes''. The node will become a vertex, and the initial shoreline will once again be a single arc. After drawing the feature arc for the groin, click on the ''Select Feature Arc'' button. The ''GenCade Arc Attributes'' window will open. Select ''Groin'' in the ''Arc Options'' menu and click on ''Attributes''. The window for groins is very similar to the window for jetties. The window for groins includes the ''Permeability'' and ''Seaward Depth'' (in the user specified units). The user may also define the groin as ''Diffracting'' or ''Non-diffracting''. When the ''Diffracting'' option is checked, a ''Seaward Depth'' must be specified. Figure 25 illustrates the various windows associated with creating a groin.


== Wave Data ==
[[Image:fig20_groin.jpg|400px|thumb|left|Figure 25. Define and create a groin]]
There are several ways to represent wave gages in the conceptual model. If the coordinates for the wave gages are in the same coordinate system as the conceptual model, it is very easy to bring in the location of the gages. Drag the file with the coordinates representing the wave gages into the SMS interface. The ''Open File Format'' window will open. Select ''Use Import Wizard'' and click ''OK''. Follow the directions for the ''File Import Wizard'' and select ''OK''. The wave gage locations will be represented as scatter data. Simply select the ''Create Feature Point'' button in the conceptual model and draw a feature point directly on top of each point. Now the wave gage locations are represented in the model.
<br style="clear:both" />


If the coordinates for the wave gages are in a different coordinate system than the GenCade conceptual model, the process to bring in the locations representing the gages is slightly different. Go to ''Single Point Projection'' under the ''Edit'' menu. The ''Reproject Single Point'' window will open. In the ''Convert from'' section, choose the projection of the wave gage. In the ''Convert to'' section, specify the projection of the GenCade conceptual model. At the bottom of the window, enter the coordinates of the wave gage and check create feature point. Once the window is closed, the location of the wave gage will become a feature point in the GenCade conceptual model. This process will need to be repeated for each wave gage.  
== 3.7 T-Groins ==
While a T-groin is not an option in the ''GenCade Attributes'' window, a detached breakwater and a groin can be combined to form a T-groin. If a T-groin is required, the user should first create a detached breakwater and fill in all of the information necessary for a detached breakwater in the ''GenCade Arc Attributes'' window. Then the user should create a groin that attaches to the detached breakwater. Once the conceptual model is converted to a 1D grid, it is necessary to double-check the T-groin to ensure that the shape has been retained. It is possible that the groin or detached breakwater has moved to an adjacent cell number and no longer retains the shape the user defined. The user may modify the cells for the detached breakwater or groin in the GenCade model under ''Edit Breakwaters'' or ''Edit Groins'' in the ''GenCade'' menu. If the shape of the T-groin is significantly altered, the user may want to consider decreasing the cell size for the entire grid or utilizing variable grid resolution. An example of a T-groin is shown in Figure 26.  


[[Image:reproject_point.jpg|400px|thumb|left|Figure 21. Reproject single point for wave gage]]
[[Image:fig21_tgroin.jpg|400px|thumb|left|Figure 26. Create a T-groin]]
<br style="clear:both" />
<br style="clear:both" />


Once the wave gages are represented in the conceptual model as feature points, click on the ''Select Feature Point'' button and double click on the point representing the wave gage. In the ''Refine Point'' window, check wave gage and click on ''options''. The ''Wave Gages'' window will open and the depth of the wave gage can be specified. After clicking ''Data'', the ''Wave Events'' window will open. There are four columns in this window: Date (month, day, year, and time), Ho (the wave height is always in meters), Period (in seconds), and Direction (in degrees). The direction is shore (grid) normal. In most cases, it will be necessary to convert to grid normal outside of the SMS interface. It is expected that the ability to input wave data in meteorological, oceanographic, or local coordinates will added to the SMS interface during this Fiscal Year.
== 3.8 Orientation, Cell Size, and Variable Grid Resolution ==
After defining the shorelines and any necessary structures, the grid should be set up. To manually draw the grid frame, click on the ''Create 1-D Grid Frame''. The GenCade grid frame is purple and has an arrow at one end. If a person followed the grid from the end to the arrow, the water should always be to the left and the land should always be to the right. For example, if the GenCade grid was oriented from north to south, the water would be to the east (left) and the land would be to the west (right). The grid can be modified by clicking the ''Select 1-D Grid Frame'' and double-clicking on the square in the center of the purple grid line. Alternately, the grid options can be changed by selecting the grid frame and right-clicking Properties. The ‘’Grid Frame Properties’’ window will open, and the ''Origin X'', ''Origin Y'', ''Angle'', and ''I size'' can be modified. The ''I size'' is the length of the grid. ''Angle'' refers to the sign convention in the conceptual model which is degrees counterclockwise from the x axis. This is different from the GenCade model convention (degrees clockwise from north). Therefore, once the map is converted to a 1D grid, the ''Azimuth'' for the grid will be a different value. The cell size can be constant or variable. If the user chooses to change the cell size under ''Define cell sizes'', the number of cells will change accordingly. The grid frame set up is shown in Figure 27.


[[Image:wave_gages.jpg|400px|thumb|left|Figure 22. Add wave gage information]]
[[Image:fig22_grid_frame.jpg|400px|thumb|left|Figure 27. Create and define the grid frame]]
<br style="clear:both" />
<br style="clear:both" />


For the SMS to read the wave information correctly, the information
A constant grid resolution is reasonable for most projects. However, there are some large scale projects that would benefit from variable grid resolution. Variable grid resolution can give more detail at specific locations of interest while having coarser resolution in other areas of the grid. By utilizing variable grid resolution, the simulation will run much more quickly than a grid with a constant, finer resolution. When the map is converted to a 1D grid, one of the options under ''I Cell Options'' is ''Use refine points''. This option refers to variable grid resolution.
must be copied and pasted in a specific format. The easiest way to do
 
this is to bring the wave information into Microsoft Excel. The first
First, it is necessary to determine which part of the grid needs a finer resolution. There are two ways to set up finer grid resolution. The user can decide to use one point or two points. For both of these options, click the ''Create Feature Point'' button. If only one feature point is created, put the point at the location of interest. Click on the ''Select Feature Point'' button and double-click on the point. The ''Refine Point'' window will open (Figure 28). Check the ''Refine grid in I direction'' and specify a base cell size. The base cell size is the size of the cells nearest to the refine point. This will be the smallest cell size in this location of the grid. Once the refine point is specified, right click on the coverage under ''Map Data'' and convert ''Map->1D Grid''. The ''Map->1D Grid'' window will open (Figure 29). Under I Cell Options, click the button to specify the ''Use refine points'' option. Type the maximum cell size and the maximum bias. The maximum cell size represents the largest cell size in the grid. Moving out from the one refine point, the cells will grow in size until a cell reaches the maximum cell size. The remaining cells in the grid will also be the maximum cell size. The maximum bias represents the amount each adjacent cell grows. For example, the default value is 1.10. This means each cell will grow 10%, so in a case with a base cell size of 10, the adjacent cells will have a size of 11. The cells will continue growing at this rate until a cell reaches the maximum cell size. In a case with only one refine point, do not select the ''Use inner growth'' option.
column will include the month, day, year, and time. The date must be in
 
the format of 1/1/1997 0:00. The wave height is column two, the period is column three, and the direction is column four. An example of this format is shown in Figure 23. Before copying the wave information to GenCade in the SMS interface,it is necessary to clean the information. Since the waves are read in as shore (grid) normal, the wave direction must be between -90 and +90 degrees. If wave direction is coming from shore in the raw wave data, it is necessary to make the wave height and direction zero for GenCade.
[[Image:fig23_variable.jpg|400px|thumb|left|Figure 28. Refine the grid for variable resolution]]
<br style="clear:both" />


[[Image:samplewave.jpg|400px|thumb|left|Figure 23. Sample setup for wave information]]
[[Image:use_refine_points.bmp|400px|thumb|left|Figure 29. Use refine points]]
<br style="clear:both" />
<br style="clear:both" />


== Convert to 1-D Grid ==
It is also possible to have a finer, constant resolution for a certain section within the grid. A groin field is a good example where a finer, constant resolution could be beneficial. For this case, select the ''Create Feature Point'' button and create points on either side of the desired finer resolution area. Click on the ''Select Feature Point'' button, double-click on each point, check the ''refine grid in I direction'' option, and choose a base cell size (make this number the same for both refine points). Once again, convert to 1D grid and select the use refine points options. Follow the same procedure as the case with only one refine point for the maximum cell size and maximum bias. If the ‘’Use inner growth’’ option is left unchecked, the cells between each refine point will be constant (at the same cell size as specified for each refine point). The cells outside of the two refine points will continue to grow up to the specified maximum bias number. If the ''Use inner growth'' option is selected, the cells will also grow between the two refine points. If the two refine points are close together, the cell size most likely will not reach the maximum cell size, but the cells between the two refine points will be larger than the base cell size.
Once all of the inlets, structures, beach fills, wave gages, etc. have been added to the conceptual model, go to the merged coverage (location where all arcs were added), right click on the name, click on ''convert'', and select ''Map->1D Grid''. A window will open which shows the origin and orientation of the GenCade grid and the different cell options. This is the same window used when manually drawing and modifying the grid frame. In many cases, a constant cell size will be sufficient to give reasonable results. Either the cell size or number of cells can be changed. The other blank will change based on the total length of the grid (I size). The default cell size is 10 ft, but a cell size of at least 15 to 20 feet is suggested to reduce instabilities. In other cases where one specific region of the GenCade grid needs more refinement, variable grid resolution is available ([[GenCade_Users_Guide#Variable_Grid_Resolution|section 5.6]]).  


[[Image:convert_to_1D.jpg|400px|thumb|left|Figure 24. Convert to 1D grid window]]
Once the ''Use refine points'' option is chosen in the ''Map->1D Grid'' window, the resulting GenCade grid will have variable resolution. After saving the project, the *.shdx file is also created. This file lists the size of each cell in the grid. This file is needed to make shoreline change or transport plots outside of SMS in cases where variable grid resolution is utilized.
 
== 3.9 Convert to 1-D Grid ==
Once all of the shorelines, inlets, structures, and refine points have been added to the conceptual model, select the merged coverage, right click on the name, click on ''Convert'', and select ''Map->1D Grid'' (Figure 30). A window will open showing the origin and orientation of the GenCade grid and the different cell options. This is the same window that was opened when the grid frame was created. Once the map has been converted to a 1D grid, the data tree in the SMS will show ''GenCade Data'' and ''GenCade Grid''. If the user highlights ''GenCade Data'', the GenCade menu at the top of the interface will appear.  The newly developed GenCade grid can be seen in the viewing window.
 
[[Image:fig25_constant_cell.jpg|400px|thumb|left|Figure 30. Convert to GenCade grid with constant cell size]]
<br style="clear:both" />
<br style="clear:both" />


= GenCade Files, Menu, Model Setup, and Execution =
== 3.10 Wave Data ==
== GenCade Input Files ==
In general, wave gauges should be defined after converting from the conceptual model to the GenCade model. After the GenCade grid has been created, highlight the coverage under ''Map Data'' to return to the conceptual model. Wave gauge data may be entered in GenCade in four conventions: shore normal, meteorological, oceanographic, and cartesian. Regardless of the convention, wave directions will be converted to shore normal convention in the *.wave files. If the waves are in meteorological or oceanographic convention, the user may define the wave gauges before converting from the conceptual model to the GenCade model. However, the shore normal option will be unavailable since the grid has not been created yet. This is the reason it is recommended that the user define the wave gauge after converting from the conceptual model to the GenCade model.
There are several input files necessary to run GenCade. These will be created once the GenCade project is saved. The minimum files necessary to run GenCade are the *.gen, *.shi, and *.wave files. The *.gen is the control file. This file records all of the information for structures, inlets, beach fills, boundary conditions, wave gages, and model setup. While this file can be opened, it is recommended that the user not make any changes directly to the *.gen file. The *.shi represents the initial shoreline (initial shoreline distance from the baseline at each cell). The *.wave files include all of the wave information. There will be one *.wave file for each wave gage. Some additional files that may be created include the *.shr, *.shdx, and *.wl files. The *.shr is in the same format as the *.shi file. The *.shr gives the distance from the baseline to the regional contour. If a regional contour was not created, this file will not exist. The *.shdx file is only created when variable grid resolution is used. This file lists the size of each cell in the grid. The *.wl is the water level file which is only created when time-dependent wave transmission is needed. More information about the input files in GenCade can be found [[GenCade_Input_Files|here]].


[[Image:input_files.jpg|400px|thumb|left|Figure 25. Sample input files]]
There are two ways to represent wave gauges in the conceptual model. In both cases, the user needs to create and select the feature point. If the coordinates of the wave gauges are in the same coordinate system as the conceptual model, it is very easy to create a point at the location of each gauge. Drag the file with the coordinates representing the wave gauges into the SMS interface. The ''Open File Format'' window will open. Select ''Use Import Wizard'' and click ''OK''. Follow the directions for the ''File Import Wizard'' and select ''OK''. The wave gauges will be represented as scatter data. Simply select the ''Create Feature Point'' button in the conceptual model and draw a feature point directly on top of each point. Now the wave gauge locations are represented in the conceptual model. Instead of defining the feature point as a refine point, check ''Wave Gage''. The ''Options'' button will open a window where the water depth may be defined. Click on ''Data'' to open the ''Wave Events'' window (Figure 31). This window will allow the user to copy and paste data or import the wave information from a text file.  Regardless of the format of the wave information, the user first needs to define the coordinate convention under ''Angle Settings''. Depending on the source, the wave information will likely be in meteorological and oceanographic convention.
 
[[Image:fig26_wave_gauge.jpg|400px|thumb|left|Figure 31. Create and define wave gauge]]
<br style="clear:both" />
<br style="clear:both" />


== GenCade Menu ==
Before importing the wave information, double check to make sure there is no missing or incorrect data. In previous versions of the interface, the SMS could not handle wave directions from land; however, this has been corrected.
After the conceptual model is converted to the 1-D grid, the ''GenCade'' menu will appear (between Data and Web in the menu). This menu can be used to make minor changes to the project. An example of a minor change to make in GenCade is modifying the cells representing left and right bypassing under the ''Edit Inlets'' menu. If the user is calibrating the model, it is best to return to the conceptual model to make changes. Changes made in the conceptual model can be applied to multiple projects, changes made to the grid itself cannot.


== Model Control ==
If the wave information is in Microsoft Excel or a similar format, it may be easiest to directly copy and paste.  There are four columns of information necessary to paste the data correctly (Figure 32). The first column represents the date (month, day, year, and time), the second is the wave height, the third column is the wave period, and the fourth column is wave direction. The date must be in MM/DD/YYYY HH:MM format. If the information is copied from a text file, the time and date must be separated by a space. If a tab is used, the SMS will read the information in five columns and the information will not be pasted correctly. Regardless of the units used in the conceptual model, Ho must be in meters. The reason the grid must be created before adding the wave information is due to the shore normal convention. It is important to note that the conceptual model and GenCade model use different sign conventions. To import the correct wave directions in shore normal coordinates, the user should go to ''GenCade->Edit Grid'' when in the GenCade Model. The ''Azimuth'' is the correct angle to determine shore normal coordinates. The ''Angle'' in the ''Grid Frame Properties'' window will list a different value since the sign convention for the conceptual model is different from the GenCade model. If the value for ''Angle'' is used to determine shore normal coordinates, the wave directions will be incorrect. After pasting the information in the ‘’Wave Events’’ window, click ‘’OK’’ in all of the open windows. Then convert to the 1D grid. To double-check the pasted wave information, go to ‘’Edit Wave Data’’ in the newly created ‘’GenCade’’ menu. The wave gauge is now assigned a cell and the water depth is listed. Click on ‘’Data’’ to open the ‘’Wave Events’’ window. All of the information in this window should be identical to the information pasted. The convention used to define the direction should be the same as the user defined. Once the project is saved, the SMS will output the *.wave files in shore normal convention. The wave directions will be converted if the information was defined in a different convention. However, if the project is reopened after saving, the user should note that regardless of the defined convention in the conceptual model, the ‘’Wave Events’’ window under ‘’Edit GenCade’’ will now list direction in shore normal convention. The ‘’Wave Events’’ window in the conceptual model will not change. For example, if the user defined the direction in meteorological convention, the directions in the ‘’Wave Events’’ window in the conceptual model will still be relative to meteorological convention.
''Model Control'' for GenCade is located under the GenCade menu. After clicking ''Model Control'', a window will open with four tabs: ''Model Setup'', ''Beach Setup'', ''Seaward BC'', and ''Lateral BC''.


The simulation name and computational time is located under the ''Model Setup'' tab. The title of the simulation can be changed from SMS Simulation. Also, the start date, end date, time step, and recording time step can be specified.
[[Image:copy_paste.png|400px|thumb|left|Figure 32. Format for wave gauge data using copy/paste]]
<br style="clear:both" />


[[Image:model_control_setup.png|400px|thumb|left|Figure 26. Model setup]]
A second way to enter the wave information is by clicking ''Import'' at the bottom of the ''Wave Events'' window. The ''Import'' function allows the user to find the text file with the wave information. Text files must have five columns representing the wave information (Figure 33). The last three columns are in the same format as the copy and paste option (wave height, wave period, and wave direction). The first column lists the date in YYYYMMDD format. The second column lists the time in HHMM format.  Once the file is read by the SMS, each column must be identified (Figures 34 and 35). Once ''Finish'' is clicked, a ''Direction Angle Convention'' window should open (Figure 36). The angle convention should be the same as the projection identified under ''Angle Settings''. After pushing ''OK'', the wave information should be in the proper format under ''Wave Events''. Once all of the wave gauges are populated, the user may convert to the 1D grid. After the project is saved, the *.wave files will be created. Regardless of the specified projection, the directions in the wave file will be in shore normal convention. As with the copy/paste wave information option, the wave information in the conceptual model will remain in the specified convention.
 
[[Image:fig28_import_wave.jpg|400px|thumb|left|Figure 33. Format for imported wave gauge data]]
<br style="clear:both" />
<br style="clear:both" />


''Sand and Beach Data'' and ''Longshore Sand Transport Calibration Coefficients'' are included in the ''Beach Setup'' tab. The ''Sand and Beach Data'' includes the effective grain size, average berm height and closure depth. K1 (primary calibration coefficient) and K2 (secondary calibration coefficient) are the longshore sand transport calibration coefficients. The K2 term is only active when there are strong wave height gradients. In most cases, K2 should be greater than K1. However, a sensitivity analysis for K1 and K2 should be conducted.
[[Image:fig29_import_wizard1.jpg|400px|thumb|left|Figure 34. Step one of file import wizard]]
<br style="clear:both" />


[[Image:model_control_beach.png|400px|thumb|left|Figure 27. Beach setup]]
[[Image:fig30_import_wizard2.jpg|400px|thumb|left|Figure 35. Step two of file import wizard]]
<br style="clear:both" />
<br style="clear:both" />


The ''Seaward BC'' tab includes the ''Input Wave Adjustments'' and ''Other Options''. The ''Input Wave Adjustments'' include ''Height Amplification Factor'', ''Angle Amplification Factor'', and ''Angle Offset''. The ''Other Options'' include ''Wave Components to Apply'' and ''Number of Cells in Offshore Contour Smoothing Window'' (''ISMOOTH''). Similar to K1 and K2, the value of ''ISMOOTH'' needs to be adjusted through a sensitivity analysis. Although 11 is the default for ''ISMOOTH'', there is no recommended value. ''ISMOOTH'' needs to be large enough so that the local shoreline undulations are not reflected back on the shape of the offshore contour. Using an ''ISMOOTH'' value about 2-3 time the length of the detached breakwaters or about twice the between groins in a groin system is a good place to start.
[[Image:fig31_define_angle.jpg|400px|thumb|left|Figure 36. Define angle convention]]
<br style="clear:both" />
 
= 4. GenCade Files, Menu, Model Setup, and Execution =
== 4.1 GenCade Input Files ==
There are three input files required to run GenCade. The GenCade control file (*.gen) lists all information related to the GenCade simulation. This file records the details for structures, inlets, dredging events, beach fills, boundary conditions, wave gauges, and the model setup. This file also defines the paths for each of the input files and one of the output files, the *.prt file. Although the *.gen file can be opened, it is recommended that the user refrain from making any changes. The initial shoreline (*.shi) and wave file(s) (*.wave) are also necessary to run even the simplest GenCade simulations. A separate wave file is created for each wave gauge. The regional contour file (*.shr), water level file (*.wl), and variable resolution file (*.shdx) are optional input files. The water level file is only created when time-dependent wave transmission is necessary.
 
== 4.2 GenCade Menu ==
Once the conceptual model is converted to the 1D grid, the ''GenCade'' menu will appear between ''Data'' and ''Web'' in the menu bar (Figure 37). This menu can be used to make minor changes to the project and to double-check that all features defined in the conceptual model are represented in the grid. An example of a minor change to make in the GenCade model is modifying the cells representing the left and right bypassing under the ''Edit Inlets'' menu. If the user is calibrating the model, it is best to return to the conceptual model to make any changes. Changes made in the conceptual model may be applied to multiple projects, but changes made to the grid itself cannot.


[[Image:model_control_seaward.png|400px|thumb|left|Figure 28. Seaward BC]]
[[Image:fig32_GenCade_menu.jpg|400px|thumb|left|Figure 37. GenCade menu in GenCade model]]
<br style="clear:both" />
<br style="clear:both" />


Left and right lateral boundary conditions can be specified under the ''Lateral BC'' tab. Presently, GenCade has three boundary conditions available: pinned, moving, and gated. Go to [[GenCade_Boundary_Conditions]] for more information and examples for each of the boundary conditions.
== 4.3 GenCade Model Setup ==
Once the user has determined that all of the features defined in the conceptual model have been retained in the GenCade grid, the user should begin to set up the model. This is accomplished by selecting ''Model Control'' under the ''GenCade'' menu. The first tab in the ''GenCade Model Control'' window is the ''Model Setup'' (Figure 38). It is in this window that the user may specify the starting and ending date of the simulation, the time step, and the recording time step. The simulation time step must be equal to or less than the wave time step. If the wave time step is smaller than the simulation time step, an error will occur and GenCade will not run. The default time step is 1.0 hour, and the default recording time step is 168.0 hours. The user may also give the simulation a title. The bottom right of the menu states ''Print Dates''. In some cases, the user may be interested in the shoreline at a specific date not normally written in the print file (shoreline and transport information are only recorded yearly).  Additional dates of interest may be added under ''Print Dates''.


[[Image:model_control_lateral.png|400px|thumb|left|Figure 29. Lateral BC]]
[[Image:fig33_model_setup.jpg|400px|thumb|left|Figure 38. Model setup window]]
<br style="clear:both" />
<br style="clear:both" />


== Running GenCade ==
== 4.4 Beach Setup ==
Once all of information is set up in the GenCade grid and all of the parameters in ''Model Control'' have been updated, GenCade can be run. Please remember to save the project before running GenCade. If the project is not saved, the *.gen file will not be saved accordingly. To run GenCade, go to the GenCade menu and select Run GenCade. A window will open that will describe the simulation. This window will notify the user if an error has occurred. Although there is no time bar stating the amount of time left in the simulation, the window will show when GenCade has finished calculating each year in the time simulation. The window will alert the user when the model is finished and prompt to exit. With a 0.5 hour time step, it should take less than a minute to run each year in the simulation. If the time step is significantly less than 0.5 hour, the model will take about five minutes for each year in the simulation.
The second tab under ''GenCade Model Control'' is the ''Beach Setup'' tab (Figure 39). The first section under this tab refers to the ''Sand and Beach Data''. Here the user may enter the ''Effective Grain Size'' (always in mm), the ''Average Berm Height'', and the ''Closure Depth''. The default ''Effective Grain Size'' is 0.2 mm. Depending on the specified units, the default ''Average Berm Height'' is 1.0 ft or 1.0 m and the default ''Closure Depth'' is 10.0 ft or 10.0 m. ''Longshore Sand Transport Calibration Coefficients'' can also be found under ''Beach Setup''. The defaults values for ''K1'' and ''K2'' are 0.5 and 0.25, respectively. These values should be adjusted during the calibration process.


[[Image:run_gencade.jpg|400px|thumb|left|Figure 30. Run GenCade]]
[[Image:fig34_beach_setup.jpg|400px|thumb|left|Figure 39. Beach setup window]]
<br style="clear:both" />
<br style="clear:both" />


== GenCade Output Files ==
== 4.5 Seaward BC ==
During the GenCade simulation, three files will be created in the assigned directory. These three files are the *.prt, *.slo, and *.qtr. The *.prt (print file) includes all information saved during the simulation. This file includes the shoreline position,shoreline change, breaking wave angle, offshore wave angle to the x-axis, and transport volume to the left and right after each year. The *.slo is the shoreline change file. Once this file is opened in SMS, the calculated shoreline can be viewed in the graphical window for each time step. The *.qrt file includes longshore sand transport in each cell for each time step. Additional information about GenCade output files can be found [[GenCade_Output_Files|here]].
The next tab under ''GenCade Model Control'' is the ''Seaward BC'' (or Boundary Condition) tab (Figure 40). The two main options in this tab are the ''Input Wave Adjustments'' section and the ''Other Options'' section. Under ''Input Wave Adjustments'', the user may modify the ''Height Amplification Factor'', ''Angle Amplification Factor'', and ''Angle Offset''. In the ''Other Options'' section, the user may define the ''Number of Cells in Offshore Contour Smoothing Window''. The default ''ISMOOTH'' value is 11, but it is suggested that this number range between 11 and 101. This is another value that must be adjusted during the calibration stage.
 
[[Image:fig35_seaward_bc.jpg|400px|thumb|left|Figure 40. Seaward boundary condition window]]
<br style="clear:both" />


== Visualizing Results ==
== 4.6 Lateral BC ==
As mentioned in the previous section, the *.slo file can be opened in SMS. Once the file has been opened in SMS, a box with the header "Time steps" will appear. An arc representing the calculated shoreline should appear in the grid window. The default color and size of the calculated shoreline may be difficult to view. Go to ''Display->Display Options''. Click on ''1D Grid'', and change the size and color of the shoreline. On some computers, the time steps listed for the calculated shoreline are in relative time. To view the dates used in the simulation, right click on the words ''Time steps'' and select ''Time Settings''. Change the zero time to represent the first date in the simulation. Under time display, change relative time to absolute time/date. Each time step in the simulation can now be viewed.  
The final tab under ''GenCade Model Control'' is the ''Lateral BC'' (or Boundary Condition) tab. There are three options for the ''Left Lateral BC'' and ''Right Lateral BC'': Pinned, Gated, and Moving.
 
=== 4.6.1 Pinned Boundary Condition ===
The pinned boundary condition is the default and should be used in most cases. A boundary specified as pinned will not move from the initial shoreline. When the pinned boundary condition is selected, all other options under ''Lateral BC'' will be grayed out. The pinned lateral boundary condition is shown in Figure 41.
 
[[Image:fig36_pinned_bc.jpg|400px|thumb|left|Figure 41.  Pinned lateral boundary condition window]]
<br style="clear:both" />
 
=== 4.6.2 Moving Boundary Condition ===
If a moving boundary condition is selected (Figure 42), the boundary will move a certain distance over a time period entered by the user. When a moving boundary is selected, the ''Length of Groin from Shoreline to Seaward Tip'' will still be grayed out, but the ''Shoreline Displacement Velocity'' will be active. Under ''Shoreline Displacement Velocity'', the user should enter the shoreline displacement in the same units used to set up the grid. This shoreline displacement may occur over the entire simulation period, a day, or a time step. Shoreline displacement over the entire simulation is the most common input for a moving boundary condition, because many users have shorelines for the beginning and end of a simulation. If the user chooses to specify the shoreline displacement per time step, it should be noted that this number should be very small. For example, in an example with a time step of 0.5 hr and a shoreline displacement of 0.5 ft per time step, the total shoreline displacement during a two year simulation would be 17,520 ft.
 
[[Image:fig37_moving_bc.jpg|400px|thumb|left|Figure 42. Moving lateral boundary condition window]]
<br style="clear:both" />


Plots can now be viewed in SMS. Under ''Display'', click on ''Plot Wizard''. In the first window, select ''Shoreline'' as the plot type. Keep the ''Active dataset'' under ''Dataset'' and ''Active time step'' under ''Time step'' selected and click ''Finish''. A new window will appear showing the shoreline for the selected time step. The same process can be followed to view plots for shoreline change and rate of change.  
=== 4.6.3 Gated Boundary Condition ===
The final boundary condition available in GenCade is a gated boundary condition (Figure 43). A gated boundary condition is bounded with a groin, so this is beneficial in cases where a groin or a jetty is located near the boundary. In the case of a gated boundary condition, it is also necessary to create and define a groin at the left or right boundary in the conceptual model. If the right lateral boundary is defined as a gated boundary, the groin should have a cell number of N+1. For example, if the grid has 100 cells, the groin should be located at cell number 101. After a gated boundary condition is selected, the ''Length of Groin from Shoreline to Seaward Tip'' will be active.  


[[Image:plot_wizard.jpg|400px|thumb|left|Figure 31. Plot Wizard]]
[[Image:fig38_gated_bc.jpg|400px|thumb|left|Figure 43. Gated lateral boundary condition window]]
<br style="clear:both" />
<br style="clear:both" />


Some users may want to plot shoreline change in Microsoft Excel or something similar. All of the information collected during the simulation was saved in the *.prt file. After opening this file, find the shoreline change after X years (X being the total number of years in the simulation). Although the shoreline change is not in column format, the format can easily be changed with a simple code. If the case uses constant resolution, the user can type in the distance alongshore. In the case of variable resolution, there is an additional input file: *.shdx. Each number in this file represents the size of each grid cell. The numbers in the file can be converted to column format using Matlab or a similar programming language. Once the distance alongshore and the shoreline change are in Excel, then the shoreline change can be plotted.  
== 4.7 Running GenCade ==
Once the GenCade grid and all of the parameters in ''Model Control'' have been updated, it is possible to run GenCade. Please remember to save the project before running GenCade. If the project is not saved prior to running GenCade, the most recent additions to the grid will not be written in the *.gen file. To run GenCade, go to the ''GenCade'' menu and select ''Run GenCade'' (Figure 44). A window will open that will describe the simulation. This window will notify the user if an error has occurred. Although there is no time bar stating the amount of time left in the simulation, the window will show when GenCade has finished calculating each year in the time simulation. The window will alert the user when the model is finished and will prompt to exit. Generally, it does not take very long to run GenCade. For an example with a 300 ft cell size, 635 cells, and a time step of 0.1 hour, it takes only about a minute to run each year of the simulation.  A smaller cell size will significantly slow down the simulation, but it should still take less than 10 minutes to run for each year in the simulation. Multiple inlets, dredging events, and beach fill can also increase the run time.
 
[[Image:fig39_run_GenCade.jpg|400px|thumb|left|Figure 44. Run GenCade]]
<br style="clear:both" />


It is also possible to use Excel to plot longshore transport and compare a calculated shoreline to a measured shoreline. In the *.prt file, longshore transport can be find by searching for "mean net annual transport." Please make a note of the units listed in the *.prt file. The longshore transport can be plotted in Excel in the same way as shoreline change. The SMS interface will soon support longshore transport as a plotting option. It is slightly more difficult to compare the calculated shoreline to a measured shoreline. First, save as a new project. Drag in the measured shoreline to SMS and name it either initial shoreline or regional contour (for this new saved project). Convert to 1-D grid again and save. This will save the measured shoreline as the regional contour or initial shoreline. Both the measured and calculated shoreline will need to be compared to the initial shoreline. The *.shi will list the distance the initial shoreline is offset from the grid. The calculated shoreline can be found in the *.prt by searching for shoreline position after the total number of years in the simulation. These numbers will represent the distance offset from the GenCade grid. By saving the measured shoreline as the initial shoreline or regional contour, this allows SMS to produce an input file for this shoreline in the same format as the initial shoreline and calculated shoreline. All of these shorelines can be converted to column format and pasted into Excel. Then subtract the measured and calculated shorelines from the initial shoreline to get shoreline change for the measured and calculated shorelines. At this time, comparing a measured shoreline to a calculated shoreline is not supported in the SMS interface.
Once a GenCade grid is created, the user can choose to run the simulation outside of the SMS. Open the command prompt and move to the proper directory. The correct format to run GenCade is


= Developing Alternatives =
GenCade_v1r3.exe project.gen
There are several ways to begin developing alternatives. While calibrating the model, it may be necessary to refine the grid. Some examples of modifications necessary to develop alternatives include changing a small section of the regional contour, changing the initial shoreline, and adding new structures.


== Minor Changes to Regional Contour or Initial Shoreline ==
== 4.8 GenCade Output Files ==
After setting up and running the model and looking at the results, it may become necessary to make a minor modification to the regional contour or initial shoreline. For example, the initial shoreline may need to be smoothed near an unstructured inlet or the regional contour may need to be changed to account for a large ebb shoal.
Following a GenCade simulation, at least seven output files will be created in the assigned directory. The print file (*.prt) saves all of the information related to the simulation including wave heights, shorelines, and transport rates. The shoreline position output file (*.slo) documents the shoreline position for each time step for every cell in the grid. The net transport rate file (*.qtr) prints the net transport rate for each cell at every time step. The inlet shoal volume file (*.irv) lists volumes for each inlet shoal for every time step. A separate inlet shoal volume file is created for each inlet represented in the simulation. If the grid does not include an inlet, the *.irv file will not be created. All of the files except the print file may be opened and viewed in the SMS. The aforementioned files contain the majority of the information a user would need to evaluate the results of a simulation. The mean net annual transport files (*.mqn [mean annual net transport], *.mql [mean transport to the left], and *.mqr [mean transport to the right]) list the transport for each cell for each time step. The offshore contour for each time step for each cell is included in the offshore contour file (*.off). Additional information about GenCade output files can be found [[GenCade Output Files|here]].


To make changes to the regional contour or initial shoreline, return to the merged coverage with all of the shorelines, structures, and wave gages under ''Map Data''. Click on ''Select Feature Vertex'' and drag each node to the desired location. It is also possible to add new nodes by clicking the ''Create Feature Vertex'' button, adding nodes, and moving to the selected location. Extra nodes can be deleted are they are selected. Once the required updates to the regional contour or initial shoreline are made, right click on the merged coverage and convert Map to 1D Grid. Click on the new GenCade grid. The original initial shoreline or regional contour should be replaced with the new one.
== 4.9 Visualizing Results ==
Following a simulation, several output files will be created. These were listed in the previous section. Many of these files may be opened in the SMS for visualization. The first of these files is the *.slo file, or shoreline change file. Once this file is opened in the SMS, a box with the header ''Time Steps'' will appear. An arc representing the calculated shoreline should appear in the grid window. The default color and size of the calculated shoreline may be difficult to view. Go to ''Display->Display Options'' and click on ''1D Grid'' to change the size and color of the calculated shoreline (Figure 45). The size and color of the initial shoreline, regional contour, and structures can also be changed. The default time under ''Time Steps'' is ''Relative Time''. To view the simulated dates, right click on the words ''Time Steps'' and select ''Time Settings''. Change the zero time to represent the first date in the simulation. Under ''Time Display'', change ''Relative Time'' to ''Absolute Time/Date''. The user can view the calculated shoreline at any date during the simulation and compare it with the initial shoreline or other reference line (Figure 46).  


[[Image:drag_shoreline_point.jpg|400px|thumb|left|Figure 32. Edit Shoreline]]
[[Image:fig40_display_options.jpg|400px|thumb|left|Figure 45. Display options window]]
<br style="clear:both" />
<br style="clear:both" />


== Modify Existing Structures or Beach Fills ==
[[Image:fig41_view_results.jpg|400px|thumb|left|Figure 46. Initial and calculated shorelines with regional contour]]
For some alternatives, extending a structure or enlarging a beach fill may be required. To extend a structure, click on ''Select Feature Point''. Click on the node at the end of the structure and extend it to the desired length. Beach fills can be modified in the same way. Right click on the merged coverage and convert Map to 1D Grid.
<br style="clear:both" />


== Replace Initial Shoreline or Regional Contour ==
Plots can also be viewed in SMS. Under ''Display'', click on ''Plot Wizard'' (Figure 47). In the first window, select ''GenCade Shoreline'' as the plot type. Keep the ''Active dataset'' under ''Dataset'' and ''Active time step'' under ''Time step'' selected and click ''Finish''. A new window will appear showing the shoreline for the selected time step (Figure 48). Once the plot has been created, simply highlight ''Rate of Change'' or ''Shoreline'' under ''GenCade Grid'' in the data tree to change the plot.
Some projects may require analysis for several different time periods which would require multiple initial shorelines. If the structures exist during multiple time periods and the wave gage data spans many decades, it may be easiest to replace the initial shoreline in the conceptual model. The same process can be used if a new regional contour is necessary. Do not delete the existing GenCade grid. Right click on ''Map Data'', click ''New Coverage'', and select ''GenCade''. It is best to give the new coverage an identifiable name. Right click on this new coverage, scroll down to ''Type->Models->GenCade''. Open the new shoreline or regional contour in the new coverage ([[GenCade_Users_Guide#Initial_Shoreline|Sections 2.1 and 2.2]]). Click on the ''Select Feature Arc'' button and define the arc. Right click on the new coverage and convert Map to 1D Grid. The new initial shoreline or regional contour will replace the original.


[[Image:open_new_shoreline.jpg|400px|thumb|left|Figure 33. Open New Initial Shoreline or Regional Contour]]
[[Image:fig42_shorelines_plotwizard.jpg|400px|thumb|left|Figure 47. Plot wizard for GenCade shorelines]]
<br style="clear:both" />
<br style="clear:both" />


[[Image:replace_shoreline.jpg|400px|thumb|left|Figure 34. Replace Initial Shoreline or Regional Contour]]
[[Image:fig43_shoreline_plot.jpg|400px|thumb|left|Figure 48. Shoreline plot in the SMS]]
<br style="clear:both" />
<br style="clear:both" />


== Add Structures or Beach Fills ==
The inlet shoal volumes over the entire simulation may also be viewed in the SMS. Go to ''Display'' to ''Plot Wizard''. Under ''Plot Type'', select ''GenCade Inlet TS'' and click ''Next'' (Figure 49). The user may select any of the inlets included in the project and may choose the entire simulation or only a few years. The user may select one shoal or many shoals. After selecting the inlet, time, and corresponding shoals, click ''Finish''. A new window with the shoal volumes over the course of the selected dates will open (Figure 50).
When a project has many different alternatives, it may be necessary to add new structures. Instead of developing a new grid for each alternative, features can be modified or added to a base grid (with the initial shoreline, regional contour, wave gages, basic structures and beach fills). Right click on ''Map Data'' and select ''GenCade'' under ''New Coverage''. Right click on this coverage and confirm that the model type is ''GenCade''. In this new coverage, add new structures and beach fills by selecting the ''Create Feature Arc'' button. Specify the type of arc. Once all the new structures are included, right click on the new coverage and convert Map to 1D grid. The new arcs will be included in the GenCade grid. Additional structures or beach fills can also be added directly to the merged coverage (with the other arcs).


[[Image:add_structure.jpg|400px|thumb|left|Figure 35. Add Structure]]
[[Image:fig44_inlet_shoal_plot.jpg|400px|thumb|left|Figure 49. Plot wizard for inlet shoal volumes]]
<br style="clear:both" />
<br style="clear:both" />


== Modify Wave Gages ==
[[Image:fig45_inlet_shoal_plot2.jpg|400px|thumb|left|Figure 50. Inlet shoal volumes plot in the SMS]]
The instructions above regarding adding new features apply to adding new wave gages. However, sometimes the wave gage data needs to be modified. In reviewing the wave gage information, a user may find that a few of the dates or values may be incorrect. If only a few values need to be modified, click on the merged coverage and select the wave gage by clicking on the ''Select Feature Point'' and double-clicking on the point representing the wave gage. Click on ''Options'' and click on ''Data''. Manually updated the incorrect wave information. Once finished, convert the Map to 1D Grid. The wave gage will now include the correct wave information.
[[Image:gage_change_minor.jpg|400px|thumb|left|Figure 36. Modify Individual Wave Events]]
<br style="clear:both" />
<br style="clear:both" />


A user may also determine that an entire set of wave gage information maybe incorrect. This can occur by selecting the wrong wave gage when pasting values or incorrectly transforming the waves to shore-normal coordinates (grid-normal). This can be remedied by replacing the wave information.
Some users may want to plot shoreline change in Microsoft Excel or similar software. All of the information collected during the simulation was saved in the *.prt file (Figure 51). The shoreline change after each year in the simulation is located in this file. Although the shoreline change is not in column format, the format can easily be changed with a simple code. If the case uses constant resolution, the size of each cell is known and this information can easily be added to a spreadsheet. In the case of variable resolution, there is an additional input file: *.shdx. Each number in this file represents the grid cell size. The numbers in the file can also be converted to column format. Once the distance alongshore and the shoreline change have been added to Microsoft Excel or other spreadsheet software, then the shoreline change can be plotted.  


[[Image:gage_change_modify.jpg|400px|thumb|left|Figure 37. Replace Wave Gage Information]]
[[Image:fig46_results_prt.jpg|400px|thumb|left|Figure 51. Shoreline change in *.prt]]
<br style="clear:both" />
<br style="clear:both" />


== Variable Grid Resolution ==
It is also possible to use Microsoft Excel to plot longshore transport. In the *.prt file, longshore transport can be found by searching for ''“mean net annual transport”''. This section of the *.prt file is shown in Figure 52. Please make a note of the units for transport listed in the *.prt file. The longshore transport can be plotted in Microsoft Excel in the same way as shoreline change.
A constant grid resolution is reasonable for most projects. However, there are some large scale projects that would benefit from variable grid resolution. The finer grid resolution can give more detail at certain locations in the grid like near an engineering structure. When the map is converted to a 1D grid, one of the options under ''I Cell Options'' is ''Use refine points''. This section refers to variable grid resolution.
 
[[Image:fig47_results_prt2.jpg|400px|thumb|left|Figure 52. Mean net annual transport in *.prt]]
<br style="clear:both" />


First, it is necessary to determine which part of the grid needs a finer resolution. There are two ways to set up the finer grid resolution. The user can decide to user one point or two points. For both of these options, click the ''Create Feature Point'' button. If only one feature point is created, put the point at the location of interest. Click on the ''Select Feature Point'' button and double-click on the point. The ''Refine Point'' window will open (please note this is the same window used to specify a wave gage). Check the ''Refine grid in I direction'' and specify a base cell size. The base cell size is the the size of the cells near the refine point. This will be the smallest cell size in this location of the grid. Once the refine point is specified, right click on the coverage under map data and convert the map to a 1D grid. The ''Map->1D Grid'' window will open. Under ''I Cell Options'', click the button to specify the ''Use refine points'' option. Type the maximum cell size and the maximum bias. The maximum cell size represents the largest cell size in the grid. Moving out from the one refine point, the cells will grow in size until a cell reaches the maximum cell size. The remaining cells will also be the maximum cell size. The maximum bias represents the amount each adjacent cell grows. For example, the default value is 1.10. This means each cell will grow 10%, so in a case with a base cell size of 10, the adjacent cells will have a size of 11. The cells will continue growing at this rate until a cell reaches the maximum cell size. In a case with only one refine point, do not select the ''Use inner growth'' option.
It is slightly more difficult to compare the calculated shoreline to a measured shoreline. First, save as a new project. Open the measured shoreline in the SMS and define it as the initial shoreline (for this new saved project). Convert to 1-D grid again and save as a new project. This will save the measured shoreline as the initial shoreline. Both the measured and calculated shoreline will need to be compared to the initial shoreline. The values in the *.shi file represent the distance from the initial shoreline to the grid for each cell. The calculated shoreline can be found in the *.prt by searching for shoreline position after the total number of years in the simulation. These numbers will represent the distance offset from the GenCade grid. Shoreline change after each year in the simulation can also be found in the *.prt file. By saving the measured shoreline as the initial shoreline, this allows SMS to produce an input file for this shoreline in the same format as the initial shoreline and calculated shoreline. All of these shorelines can be converted to column format and pasted into Microsoft Excel. Subtract the initial shoreline from the measured shoreline and the calculated shoreline to get shoreline change for the measured and calculated shorelines.


It is also possible to have a finer, constant resolution for a certain location within the grid. A groin field is a good example of a location on a grid that a finer, constant resolution could be beneficial. For this case, select the ''Create Feature Point'' button and create points on either side of the desired finer resolution area. Click on the ''Select Feature Point'' button, double-click on each point, check the ''refine grid in I direction'' option, and choose a base cell size (make this number the same for both refine points). Once again, convert to 1D grid and select the use refine points options. Follow the same procedure as the case with only one refine point for the maximum cell size and maximum bias. If the use inner growth option is left unchecked, the cells between each refine point will be constant (at the same cell size as specified for each refine point). The cells outside of the two refine points will continue to grow up to the specified maximum bias number. If the use inner growth option is selected, the cells will also grow between the two refine points. If the two refine points are close together, the cell size most likely will not reach the maximum cell size, but the cells between the two refine points will be larger than the base cell size.
= 5. Developing Alternatives =
There are several reasons that a user may need to modify a GenCade grid. While calibrating the model, it may be necessary to refine the grid. Some examples of modifications necessary to develop alternatives include changing a small section of the regional contour, changing the initial shoreline, or adding new structures.


[[Image:refine_point.jpg|400px|thumb|left|Figure 38. Refine Point Attributes]]
== 5.1 Minor Changes to the Regional Contour or Initial Shoreline ==
After setting up and running the model and looking at results, it may become necessary to make a minor modification to the regional contour or initial shoreline. For example, the initial shoreline may need to be smoothed near an unstructured inlet or the regional contour may need to be adjusted to account for a large ebb shoal.
 
To make changes to the regional contour or initial shoreline, return to the merged coverage with all of the shorelines, structures, and wave gauges under ''Map Data''. Click ''Select Feature Vertex'' and drag each vertex to the desired location (Figure 53). It is also possible to add vertices by clicking ''Create Feature Vertex'', adding the vertex, and moving it to the selected location. Extra vertices can be deleted after they are selected. Once the required updates to the regional contour or the initial shoreline are made, right click on the merged coverage and convert ''Map->1D Grid''.  The initial shoreline or regional contour must be selected by clicking on the ''Select Feature Arc''. If the arc is not selected and highlighted, the old regional contour or initial shoreline will not be replaced. It should also be mentioned that only minor changes should be made to the regional contour or initial shoreline. The user should not modify the regional contour during model calibration.
 
[[Image:fig48_modify_rc.jpg|400px|thumb|left|Figure 53. Modify the shape of the regional contour]]
<br style="clear:both" />
<br style="clear:both" />


[[Image:use_refine_points.jpg|400px|thumb|left|Figure 39. Refine Points Under I Cell Options]]
== 5.2 Modify Existing Structures or Beach Fills ==
For some alternatives, a beach fill or structure may need to be extended. To extend a structure, click on ''Select Feature Point''. Click on the node at the end of the structure and extend it to the desired length. Beach fills can be modified in the same way. Right click on the merged coverage and convert ''Map->1D Grid''. The modified structure must be selected (by clicking on ''Select Feature Point'') for the changes to be noted in the GenCade model.
 
== 5.3 Replace Initial Shoreline or Regional Contour ==
Some projects may require analysis for several different time periods. If the structures exist during multiple time periods and the wave gauge data span many decades, it may be easiest to replace the initial shoreline in the conceptual model. The same process can be used if a new regional contour is necessary. Do not delete the existing GenCade grid. Right click on ''Map Data'', click ''New Coverage'', and select ''GenCade''. It is best to give the new coverage a specific name that can be identified easily. Right click on this new coverage and scroll down to ''Type->Models->GenCade''. Open the new shoreline or regional contour in the new coverage. Click on ''Select Feature Arc'' and define the arc. Right click on the new coverage and convert ''Map->1D Grid''. The new initial shoreline or regional contour will replace the original.
 
== 5.4 Add Structures or Beach Fills ==
When a project has many different alternatives, it may be necessary to add new structures. Instead of developing a new grid for each alternative, features can be modified or added to a base grid that already has the initial shoreline, regional contour, wave gauges, and basic structures and beach fills. Right click on ''Map Data'' and select ''GenCade'' under ''New Coverage''. Right click on this coverage and confirm that the model type is ''GenCade''. In this new coverage, add new structures and beach fills by selecting the ''Create Feature Arc'' button. Specify the type of arc. Once all the new structures are included, right click on the new coverage and convert ''Map->1D Grid''. The new arcs will be added in the GenCade grid. Additional structures or beach fills can also be added directly to the merged coverage that already has the initial shoreline, regional contour, and existing structures.
 
== 5.5 Modify Wave Gauges ==
The instructions above regarding adding new features can also apply to adding new wave gauges. However, sometimes the wave gauge data need to be modified. In reviewing the wave gauge information, a user may find that a few of the dates or values may be incorrect. If only a few values need to be modified, click on the merged coverage and select the wave gauge by clicking on ''Select Feature Point'' and double-click on the point representing the wave gauge. Click on ''Options'' and click on ''Data''. Manually update the incorrect wave information. Once finished, convert ''Map->1D Grid''. The wave gauge will now include the correct wave information. The steps to modify a wave gauge are shown in Figure 54.
 
[[Image:fig49_modify_specific_wave.jpg|400px|thumb|left|Figure 54. Modify specific wave events]]
<br style="clear:both" />
<br style="clear:both" />


Once the use refine points option (variable grid resolution) is chosen in the ''Map->1D Grid'' window, the resulting GenCade grid will have variable resolution. After saving the project, the *.shdx file is also created. This file lists the size of each cell in the grid. This file is needed to make shoreline change or transport plots outside of SMS.
A user may also determine that an entire set of wave gauge information may be incorrect. This can occur by selecting the wrong wave gauge when pasting values or by incorrectly manually transforming waves. This can be remedied by deleting the existing wave gauge, creating a new wave gauge, and following the steps to add information to the wave gauge.


Return to [[GenCade|GenCade Main Page.]]
Return to [[GenCade|GenCade Main Page.]]

Revision as of 19:35, 1 November 2012

1. Getting Started

This GenCade guide was last updated in November 2012. Most of the screenshots used in this guide were created with the August 19, 2011, build of the SMS. Developers are constantly upgrading the SMS and GenCade executables, so the graphics in a future version may look slightly different than the visuals included in this user guide.

A very simple example can be found here. This example shows all steps necessary to produce results and includes a zip file with all of the input and output files that can be used to reproduce the results on another computer.

1.1 Setup GenCade in the SMS

GenCade is run within the SMS 11.1 Development. SMS 11.0 and earlier versions do not have interfaces for GenCade. This section will guide a user through the process to set up the conceptual model, convert to a 1D grid, review the GenCade model, run GenCade, visualize results, and develop alternatives. It is assumed that the reader has no previous experience with GenCade.

First, the GenCade executable must be identified on the machine. The GenCade executable is GenCade_v1r3.exe. If SMS 11.1 Beta is installed on the machine, the GenCade executable will be located in the models folder.

Once SMS 11.1 is open on the machine, it is necessary to specify the location of the GenCade executable. If this is specified incorrectly or not at all, GenCade will not run. In order to indicate the location of the executable, it is necessary to click on Edit, go to Preferences, and click on the tab labeled File Locations. The user should scroll down to GenCade under Model Executables and click on BROWSE. Once the GenCade executable is selected, the path for the executable should be listed under Model Executables next to GenCade. Figure 1 shows the File Locations window.

Figure 1. Define GenCade model executable


1.2 Set the Current Projection

GenCade uses a real world coordinate system, so it is necessary to set up the current projection upon opening the SMS. GenCade projects may be set up in either U.S. customary units or SI units. The user may select the appropriate projection by clicking Edit->Projection. The steps to set up the projection are shown in Figure 2. This ensures all shorelines, structures, wave gauges, and other important features are mapped correctly. The user may also open aerial photographs to aid in completing the conceptual model. In many cases, the files representing shorelines and other features may be georeferenced correctly without defining the current projection; however, it is a good idea to define the projection before starting a GenCade project.

Figure 2. Specify projection


1.3 Changing the Projection

In some cases, an aerial photograph may be defined in a different coordinate system than the shorelines. There are two ways to change the projection of the project. For a case where the user would like to convert the shoreline and the project to the same projection as the imported aerial photo, there are several steps to follow. First, go to Edit->Project, specify the projection used for the shoreline, and bring in the shoreline (more information on the format of shorelines is in 2.1). Right click on the coverage including the shoreline under Map Data in the left panel and go to Reproject. A warning will pop up notifying the user that the command is non-reversible. After clicking Yes, the Reproject Object window will open. Check Set and change the new projection to the projection of the aerial photo (Figure 3). Go back to Edit->Project and change the projection to match the projection of the aerial photo (Figure 4). All of the units will match the projection of the aerial photo. Now the aerial photo can be opened in the SMS, and the shoreline will overlay the aerial photograph correctly (Figure 5).

Figure 3. Reprojection map projection


Figure 4. Change projection


Figure 5. Confirmation of change in projection


It is much simpler to use the units from the shoreline shapefile or text file for the project. In this case, the aerial photograph will need to be reprojected. First, go to Edit->Project and define the projection. Then open the shoreline, right click on the coverage, and go to Projection (floating) (Figure 6). It should be confirmed that the object projection matches the projection defined under Edit->Project. When the aerial photo is opened, SMS will automatically convert the aerial photo to the correct projection so that the photo matches the shorelines (Figure 7).

Figure 6. Reproject object projection


Figure 7. Reproject current projection


2. Preparing Input Files

2.1 Open and Define Initial Shoreline

As mentioned previously, an initial shoreline is required to run GenCade. The model type must be defined as GenCade before opening any file in the SMS. This can be accomplished by selecting Type->Models->GenCade after right clicking on the default coverage under Map Data in the data tree (panel on left side of screen). If the user has a file with a list of shoreline points that is in the same projection as the project, the file may be opened in the SMS. Before the file is opened in the SMS, it is important to double check the projection of coverage under Map Data. This can be done by right clicking on the coverage and clicking on Projection. If it is necessary to convert to a new projection for the shoreline, right click on the coverage and go to Reproject. A warning will pop up explaining that this is a non-reversible command; select Yes. Then a new window will open allowing the user to define the Current projection and the New projection. To read the file into the conceptual model correctly, the file must be in *.cst format. The *.cst format requires the x and y coordinates of every point along the shoreline. An example of the format is shown in Figure 8. In order to modify a file with x and y coordinates for a shoreline, add the first three lines shown in Figure 8 which have been carried over from the old GENESIS format. The first number on the third line represents the total number of shoreline points listed in the file. This is the only number in the first three lines that will differ from the file shown in Figure 8.

Figure 8. Example format of *.cst file


There are many different ways to create an initial shoreline for GenCade in the SMS. If the shoreline is represented by points in a shapefile, these can be converted into a scatter set and saved as a text file. Then the text file can be modified to create the proper *.cst format and opened in the SMS.

A GenCade initial shoreline can also be created from a polyline shapefile. Once the shapefile is opened in the SMS, it is necessary to click on Mapping and select Shapes->Feature Objects (Figure 9). This will create a Feature Arc. After converting the Map Data to GenCade, the arc may be selected by clicking on the Select Feature Arc button and by double-clicking. If the shapefile was converted into multiple arcs, it is necessary to connect these segments to create one arc (Figure 10). Click on the Create Feature Arc button and draw an arc connecting the existing arcs. Click on the Select Feature Point button and select all of the nodes between the existing and the new arcs. To convert the nodes to vertices, go to Feature Objects and select Vertices<->Nodes. Once all of the nodes have been converted to vertices, the shoreline is in the proper format for GenCade. When developing a shoreline in GenCade from a polyline shapefile, it is not necessary to create a *.cst file.

Figure 9. Convert shapefile to feature objects


Figure 10. Connect segments to create one feature arc


Regardless of whether or not the initial shoreline is opened as a *.cst file, the initial shoreline must be defined. To define the initial shoreline, GenCade must be selected as the model type for the coverage. The feature arc representing the shoreline should be double-clicked (or right-click and select Attributes) after clicking on the Select Feature Arc button. The GenCade Arc Attributes window will open. The Initial Shoreline option should be selected under Arc Options. These steps are shown in Figure 11.

Figure 11. Define arc as initial shoreline


2.2 Open and Define Regional Contour or Additional Shorelines

In some cases, a regional contour or additional shorelines may need to be added to the conceptual model. In order to define a second feature arc, it is necessary to right-click on Map Data and select a New Coverage. This new coverage must also be defined as GenCade. The user can rename the new coverage, so that it can easily be identified. It is very important to open the new arc in a new coverage. If the arc is opened in the same coverage as the initial shoreline, the two arcs will most likely overlap, and the arcs will be split into many arcs. Once the regional contour is opened in the interface, define the arc as Regional Contour in the GenCade Arc Attributes window (Figure 12). A shoreline representing the final shoreline or an additional shoreline may be defined as a Reference Line.

Figure 12. Define arc as regional contour


2.3 Merge Coverages

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). This can be done by hitting ctrl on the keyboard and clicking on both coverages. After right-clicking, select Merge Coverages. A window will open asking if the user would like to delete the coverages used to make the merged coverage. If no is selected, the initial shoreline and regional contour coverages will remain in the interface. It is a good idea to keep these coverages in the interface. If a problem occurs with the merged coverage, the initial shoreline and regional contour may be merged again. Figure 13 shows how coverages are merged while Figure 14 illustrates the initial shoreline and regional contour in the merged coverage.

Figure 13. Merge initial shoreline and regional contour in a single coverage


Figure 14. Arcs for initial shoreline and regional contour defined after merging into a single coverage


3. Grid Setup

3.1 Create Inlets, Shoals, Dredging Events, and Jetties

The inlet name, inlet shoal volumes, dredging events, and bypassing coefficients may be defined when an inlet is created. To do this, select the Create Feature Arc button and draw a line from one side of the inlet to the other. When creating inlets and other features, a high quality aerial photo is very helpful. After the inlet is created, click on the Select Feature Arc button and double-click on the arc representing the inlet. This can also be accomplished by a single click, followed by a right click. The GenCade Arc Attributes window will open. Select Inlet and click on Attributes. The Inlet Reservoir Model window will open. The inlet can be named, shoal volumes can be defined, and dredging events can be added. The initial and equilibrium shoal volumes for the ebb, flood, left bypass, left attachment, right bypass, and right attachment can be defined after clicking on the Volume button. Similarly, after clicking on Dredging, the Dredging Events window will open and the user can specify the beginning and ending date, the volume, and the shoal to be mined for each dredging event. The user also has the option to modify the left and right bypassing coefficients when jetties are present. Both the left and right bypassing coefficients have a default value of 1. This value will always be zero or larger. However, due to the measured distances included in the bypassing coefficient equation, it is highly unlikely that the bypassing coefficient will be larger than 100. Inlets that do not have jetties will not have a bypassing coefficient. After the inlet information is specified, the arc representing the inlet will turn blue. All of the steps create an inlet and add shoal volumes and dredging events are shown in Figure 15.

Figure 15. Create and define an inlet, shoal volumes, and dredging events


A jetty can be created at the inlet after selecting the Create Feature Arc button. The arc representing the jetty should not intersect with the arc representing the inlet, regional contour, or initial shoreline. If this occurs, either the arc representing the jetty or the regional contour or initial shoreline will be split into two separate arcs. To remedy the problem of splitting arcs; the user should delete the arc representing the jetty, convert the newly created node to a vertex, and redefine the formerly split arc. After drawing the jetty, the user should click on the Select Feature Arc and double-click on the line representing the jetty. When the GenCade Arc Attributes window opens, the Left Jetty on Inlet or Right Jetty on Inlet should be selected. The left jetty is to the left of a person standing on land looking at the ocean. After Attributes is selected, a new window will open where the Permeability can be specified, Diffracting can be checked or unchecked, and a seaward depth can be added. The default value for Permeability is 0. Although Diffracting is unchecked as a default option, the user should check this box in most cases. The line representing a jetty will also turn blue once all of required jetty information is provided. Figure 16 shows how to create a jetty.

Figure 16. Create and define a jetty


Once the grid is converted to GenCade, the bypassing associated with an inlet is defaulted to the one cell immediately adjacent to either side of the inlet. However, the size and location may be defined in the conceptual model by selecting the Create Feature Arc button and drawing the arc. Double-click on the arc after creating to open the GenCade Arc Attributes window. The arc should be defined as an Attachment Bar (Figure 17). The attachment bar is also represented by a blue line.

Figure 17. Create and define an attachment bar


3.2 Seawalls

To draw a seawall, first the Create Feature Arc button should be selected. The seawall must be drawn landward of the shoreline. If the user attempts to draw the seawall directly on top of the initial shoreline, an error will occur. The seawall drawn by the user should resemble the shape of the real seawall as closely as possible. If the user is not meticulous in drawing the seawall, the shape of the seawall in the GenCade model may not resemble the actual seawall. Additionally, since cell numbers are used in the GenCade model, the seawall shape may look different after converting from the conceptual model. After the seawall is drawn, the user should click on the Select Feature Arc button and click on the seawall. The GenCade Arc Attributes window will open. Seawall should be selected in Arc Options. The seawall will turn blue. When the model is converted to a 1D grid, an error message referring to the seawall may pop up. This message should be ignored; GenCade will modify the cells defined for the seawall. The user should review the seawall in the GenCade model. If the seawall does not resemble the actual seawall, the cell numbers and distances from the grid should be revised. A smaller cell size near the seawall may also be helpful. The process to create a seawall is shown in Figure 18.

Figure 18. Create and define a seawall


3.3 Beach Fills

Beach fills can be created in the same way as inlets and seawalls. One should select the Create Feature Arc button to draw the beach fill. Beach fills should be drawn slightly offshore. If there are many beach fills in one location during the simulation, draw the beach fills carefully so they do not connect or intersect. After each beach fill is drawn, click on the Select Feature Arc and double-click on the line representing the beach fill. Select the Beach Fill Event after the GenCade Arc Attributes window opens. For each beach fill, add the Begin Date and End Date and the Added Berm Width. After selecting OK in the GenCade Arc Attributes window, the line representing the beach fill will turn green. Figure 19 demonstrates the steps to create and define beach fill events.

Figure 19. Create and define a beach fill


3.4 Bypass Event

Another option in GenCade is a bypass event. The user should select the ‘’Create Feature Arc’’ button and draw the bypass event in the desired location. After the event is created, the user should click on the ‘’Select Feature Arc’’ button and double-click on the arc representing the bypass event. Once ‘’Bypass Event’’ is selected in the ‘’GenCade Arc Attributes’’ window, the ‘’Bypassing’’ window will open. A ‘’Begin Date’’, ‘’End Date’’, and ‘’Bypass Rate’’ can be specified. If the project projection is in USCS, the bypass rate is cubic yards per hour. Likewise, the bypass rate is cubic meters per hour when SI units are used. Figure 20 demonstrates the steps to create and define bypass events.

Figure 20. Create and define a bypass event


3.5 Detached Breakwaters

A detached breakwater is created by selecting the Create Feature Arc button and drawing the arc representing the detached breakwater. The user should click on the Select Feature Arc button and double-click on the detached breakwater. The GenCade Arc Attributes window will open. Scroll down to Breakwater and click on Attributes. The depth at each end of the detached breakwater can be entered in the Detached Breakwater window. There is a pull-down window for wave transmission which includes constant transmission and three equations for time-dependent wave transmission: Ahrens, Seabrook and Hall, and d'Angremond.

3.5.1 Constant Transmission

Under the Transmission bar, select Constant. The last column in the detached breakwaters window is Coeff/Perm/Atts. For constant transmission, this represents the permeability of the detached breakwater. Once all necessary information is entered, click OK. The detached breakwater will turn orange. A detached breakwater with constant transmission is shown in Figure 21.

Figure 21. Create and define a breakwater with constant transmission


3.5.2 Time-dependent Wave Transmission

3.5.2.1 Ahrens

After selecting Ahrens under Transmission in the Detached Breakwater window, the final column (Coeff/Perm/Atts) can be selected. Clicking this box will open the ‘’Breakwater Attributes’’ window. For Ahrens, the required values include freeboard to MSL, width, seaward side slope, shoreward side slope, and the D50 of the armor stone (Figure 22). Click OK, and the detached breakwater should turn orange.

3.5.2.2 d'Angremond

Another equation that can be used for time-dependent wave transmission is d'Angremond. Similarly to the option for Ahrens, click on the final column of the Detached Breakwaters window which should now say Atts. For d'Angremond, the freeboard to MSL, width, seaward side slope, shoreward side slope, and permeability are required (Figure 23).

3.5.2.3 Seabrook and Hall

Seabrook and Hall can also be used for time-dependent wave transmission. After selecting Seabrook and Hall in the Detached Breakwaters window, click on Atts in the final column. The Breakwater Attributes window will open, and the freeboard to MSL, width, seaward side slope, shoreward side slope, and D50 of the armor stone can be entered (Figure 24).

Figure 22. Define breakwater using Ahren’s method for transmission


Figure 23. Define breakwater using d’Angremond method for transmission


Figure 24. Define breakwater using Seabrook and Hall method for transmission


3.6 Groins

Once the location for a groin is chosen, select the Create Feature Arc button. In many cases, the arc representing the groin will cross the regional contour and initial shoreline. Do not draw either end of the groin near the regional contour or initial shoreline. When this occurs, the node from the groin will connect to the initial shoreline or regional contour. This will divide the regional contour or initial shoreline into two separate arcs, where only one of the arcs will still be defined as the regional contour or initial shoreline. To remedy this, delete the arc that was created to represent the groin. Highlight the node that divides the initial shoreline into two segments. Under Feature Objects, select Vertices<->Nodes. The node will become a vertex, and the initial shoreline will once again be a single arc. After drawing the feature arc for the groin, click on the Select Feature Arc button. The GenCade Arc Attributes window will open. Select Groin in the Arc Options menu and click on Attributes. The window for groins is very similar to the window for jetties. The window for groins includes the Permeability and Seaward Depth (in the user specified units). The user may also define the groin as Diffracting or Non-diffracting. When the Diffracting option is checked, a Seaward Depth must be specified. Figure 25 illustrates the various windows associated with creating a groin.

Figure 25. Define and create a groin


3.7 T-Groins

While a T-groin is not an option in the GenCade Attributes window, a detached breakwater and a groin can be combined to form a T-groin. If a T-groin is required, the user should first create a detached breakwater and fill in all of the information necessary for a detached breakwater in the GenCade Arc Attributes window. Then the user should create a groin that attaches to the detached breakwater. Once the conceptual model is converted to a 1D grid, it is necessary to double-check the T-groin to ensure that the shape has been retained. It is possible that the groin or detached breakwater has moved to an adjacent cell number and no longer retains the shape the user defined. The user may modify the cells for the detached breakwater or groin in the GenCade model under Edit Breakwaters or Edit Groins in the GenCade menu. If the shape of the T-groin is significantly altered, the user may want to consider decreasing the cell size for the entire grid or utilizing variable grid resolution. An example of a T-groin is shown in Figure 26.

Figure 26. Create a T-groin


3.8 Orientation, Cell Size, and Variable Grid Resolution

After defining the shorelines and any necessary structures, the grid should be set up. To manually draw the grid frame, click on the Create 1-D Grid Frame. The GenCade grid frame is purple and has an arrow at one end. If a person followed the grid from the end to the arrow, the water should always be to the left and the land should always be to the right. For example, if the GenCade grid was oriented from north to south, the water would be to the east (left) and the land would be to the west (right). The grid can be modified by clicking the Select 1-D Grid Frame and double-clicking on the square in the center of the purple grid line. Alternately, the grid options can be changed by selecting the grid frame and right-clicking Properties. The ‘’Grid Frame Properties’’ window will open, and the Origin X, Origin Y, Angle, and I size can be modified. The I size is the length of the grid. Angle refers to the sign convention in the conceptual model which is degrees counterclockwise from the x axis. This is different from the GenCade model convention (degrees clockwise from north). Therefore, once the map is converted to a 1D grid, the Azimuth for the grid will be a different value. The cell size can be constant or variable. If the user chooses to change the cell size under Define cell sizes, the number of cells will change accordingly. The grid frame set up is shown in Figure 27.

Figure 27. Create and define the grid frame


A constant grid resolution is reasonable for most projects. However, there are some large scale projects that would benefit from variable grid resolution. Variable grid resolution can give more detail at specific locations of interest while having coarser resolution in other areas of the grid. By utilizing variable grid resolution, the simulation will run much more quickly than a grid with a constant, finer resolution. When the map is converted to a 1D grid, one of the options under I Cell Options is Use refine points. This option refers to variable grid resolution.

First, it is necessary to determine which part of the grid needs a finer resolution. There are two ways to set up finer grid resolution. The user can decide to use one point or two points. For both of these options, click the Create Feature Point button. If only one feature point is created, put the point at the location of interest. Click on the Select Feature Point button and double-click on the point. The Refine Point window will open (Figure 28). Check the Refine grid in I direction and specify a base cell size. The base cell size is the size of the cells nearest to the refine point. This will be the smallest cell size in this location of the grid. Once the refine point is specified, right click on the coverage under Map Data and convert Map->1D Grid. The Map->1D Grid window will open (Figure 29). Under I Cell Options, click the button to specify the Use refine points option. Type the maximum cell size and the maximum bias. The maximum cell size represents the largest cell size in the grid. Moving out from the one refine point, the cells will grow in size until a cell reaches the maximum cell size. The remaining cells in the grid will also be the maximum cell size. The maximum bias represents the amount each adjacent cell grows. For example, the default value is 1.10. This means each cell will grow 10%, so in a case with a base cell size of 10, the adjacent cells will have a size of 11. The cells will continue growing at this rate until a cell reaches the maximum cell size. In a case with only one refine point, do not select the Use inner growth option.

Figure 28. Refine the grid for variable resolution


Figure 29. Use refine points


It is also possible to have a finer, constant resolution for a certain section within the grid. A groin field is a good example where a finer, constant resolution could be beneficial. For this case, select the Create Feature Point button and create points on either side of the desired finer resolution area. Click on the Select Feature Point button, double-click on each point, check the refine grid in I direction option, and choose a base cell size (make this number the same for both refine points). Once again, convert to 1D grid and select the use refine points options. Follow the same procedure as the case with only one refine point for the maximum cell size and maximum bias. If the ‘’Use inner growth’’ option is left unchecked, the cells between each refine point will be constant (at the same cell size as specified for each refine point). The cells outside of the two refine points will continue to grow up to the specified maximum bias number. If the Use inner growth option is selected, the cells will also grow between the two refine points. If the two refine points are close together, the cell size most likely will not reach the maximum cell size, but the cells between the two refine points will be larger than the base cell size.

Once the Use refine points option is chosen in the Map->1D Grid window, the resulting GenCade grid will have variable resolution. After saving the project, the *.shdx file is also created. This file lists the size of each cell in the grid. This file is needed to make shoreline change or transport plots outside of SMS in cases where variable grid resolution is utilized.

3.9 Convert to 1-D Grid

Once all of the shorelines, inlets, structures, and refine points have been added to the conceptual model, select the merged coverage, right click on the name, click on Convert, and select Map->1D Grid (Figure 30). A window will open showing the origin and orientation of the GenCade grid and the different cell options. This is the same window that was opened when the grid frame was created. Once the map has been converted to a 1D grid, the data tree in the SMS will show GenCade Data and GenCade Grid. If the user highlights GenCade Data, the GenCade menu at the top of the interface will appear. The newly developed GenCade grid can be seen in the viewing window.

Figure 30. Convert to GenCade grid with constant cell size


3.10 Wave Data

In general, wave gauges should be defined after converting from the conceptual model to the GenCade model. After the GenCade grid has been created, highlight the coverage under Map Data to return to the conceptual model. Wave gauge data may be entered in GenCade in four conventions: shore normal, meteorological, oceanographic, and cartesian. Regardless of the convention, wave directions will be converted to shore normal convention in the *.wave files. If the waves are in meteorological or oceanographic convention, the user may define the wave gauges before converting from the conceptual model to the GenCade model. However, the shore normal option will be unavailable since the grid has not been created yet. This is the reason it is recommended that the user define the wave gauge after converting from the conceptual model to the GenCade model.

There are two ways to represent wave gauges in the conceptual model. In both cases, the user needs to create and select the feature point. If the coordinates of the wave gauges are in the same coordinate system as the conceptual model, it is very easy to create a point at the location of each gauge. Drag the file with the coordinates representing the wave gauges into the SMS interface. The Open File Format window will open. Select Use Import Wizard and click OK. Follow the directions for the File Import Wizard and select OK. The wave gauges will be represented as scatter data. Simply select the Create Feature Point button in the conceptual model and draw a feature point directly on top of each point. Now the wave gauge locations are represented in the conceptual model. Instead of defining the feature point as a refine point, check Wave Gage. The Options button will open a window where the water depth may be defined. Click on Data to open the Wave Events window (Figure 31). This window will allow the user to copy and paste data or import the wave information from a text file. Regardless of the format of the wave information, the user first needs to define the coordinate convention under Angle Settings. Depending on the source, the wave information will likely be in meteorological and oceanographic convention.

Figure 31. Create and define wave gauge


Before importing the wave information, double check to make sure there is no missing or incorrect data. In previous versions of the interface, the SMS could not handle wave directions from land; however, this has been corrected.

If the wave information is in Microsoft Excel or a similar format, it may be easiest to directly copy and paste. There are four columns of information necessary to paste the data correctly (Figure 32). The first column represents the date (month, day, year, and time), the second is the wave height, the third column is the wave period, and the fourth column is wave direction. The date must be in MM/DD/YYYY HH:MM format. If the information is copied from a text file, the time and date must be separated by a space. If a tab is used, the SMS will read the information in five columns and the information will not be pasted correctly. Regardless of the units used in the conceptual model, Ho must be in meters. The reason the grid must be created before adding the wave information is due to the shore normal convention. It is important to note that the conceptual model and GenCade model use different sign conventions. To import the correct wave directions in shore normal coordinates, the user should go to GenCade->Edit Grid when in the GenCade Model. The Azimuth is the correct angle to determine shore normal coordinates. The Angle in the Grid Frame Properties window will list a different value since the sign convention for the conceptual model is different from the GenCade model. If the value for Angle is used to determine shore normal coordinates, the wave directions will be incorrect. After pasting the information in the ‘’Wave Events’’ window, click ‘’OK’’ in all of the open windows. Then convert to the 1D grid. To double-check the pasted wave information, go to ‘’Edit Wave Data’’ in the newly created ‘’GenCade’’ menu. The wave gauge is now assigned a cell and the water depth is listed. Click on ‘’Data’’ to open the ‘’Wave Events’’ window. All of the information in this window should be identical to the information pasted. The convention used to define the direction should be the same as the user defined. Once the project is saved, the SMS will output the *.wave files in shore normal convention. The wave directions will be converted if the information was defined in a different convention. However, if the project is reopened after saving, the user should note that regardless of the defined convention in the conceptual model, the ‘’Wave Events’’ window under ‘’Edit GenCade’’ will now list direction in shore normal convention. The ‘’Wave Events’’ window in the conceptual model will not change. For example, if the user defined the direction in meteorological convention, the directions in the ‘’Wave Events’’ window in the conceptual model will still be relative to meteorological convention.

Error creating thumbnail: File missing
Figure 32. Format for wave gauge data using copy/paste


A second way to enter the wave information is by clicking Import at the bottom of the Wave Events window. The Import function allows the user to find the text file with the wave information. Text files must have five columns representing the wave information (Figure 33). The last three columns are in the same format as the copy and paste option (wave height, wave period, and wave direction). The first column lists the date in YYYYMMDD format. The second column lists the time in HHMM format. Once the file is read by the SMS, each column must be identified (Figures 34 and 35). Once Finish is clicked, a Direction Angle Convention window should open (Figure 36). The angle convention should be the same as the projection identified under Angle Settings. After pushing OK, the wave information should be in the proper format under Wave Events. Once all of the wave gauges are populated, the user may convert to the 1D grid. After the project is saved, the *.wave files will be created. Regardless of the specified projection, the directions in the wave file will be in shore normal convention. As with the copy/paste wave information option, the wave information in the conceptual model will remain in the specified convention.

Figure 33. Format for imported wave gauge data


Figure 34. Step one of file import wizard


Figure 35. Step two of file import wizard


Figure 36. Define angle convention


4. GenCade Files, Menu, Model Setup, and Execution

4.1 GenCade Input Files

There are three input files required to run GenCade. The GenCade control file (*.gen) lists all information related to the GenCade simulation. This file records the details for structures, inlets, dredging events, beach fills, boundary conditions, wave gauges, and the model setup. This file also defines the paths for each of the input files and one of the output files, the *.prt file. Although the *.gen file can be opened, it is recommended that the user refrain from making any changes. The initial shoreline (*.shi) and wave file(s) (*.wave) are also necessary to run even the simplest GenCade simulations. A separate wave file is created for each wave gauge. The regional contour file (*.shr), water level file (*.wl), and variable resolution file (*.shdx) are optional input files. The water level file is only created when time-dependent wave transmission is necessary.

4.2 GenCade Menu

Once the conceptual model is converted to the 1D grid, the GenCade menu will appear between Data and Web in the menu bar (Figure 37). This menu can be used to make minor changes to the project and to double-check that all features defined in the conceptual model are represented in the grid. An example of a minor change to make in the GenCade model is modifying the cells representing the left and right bypassing under the Edit Inlets menu. If the user is calibrating the model, it is best to return to the conceptual model to make any changes. Changes made in the conceptual model may be applied to multiple projects, but changes made to the grid itself cannot.

Figure 37. GenCade menu in GenCade model


4.3 GenCade Model Setup

Once the user has determined that all of the features defined in the conceptual model have been retained in the GenCade grid, the user should begin to set up the model. This is accomplished by selecting Model Control under the GenCade menu. The first tab in the GenCade Model Control window is the Model Setup (Figure 38). It is in this window that the user may specify the starting and ending date of the simulation, the time step, and the recording time step. The simulation time step must be equal to or less than the wave time step. If the wave time step is smaller than the simulation time step, an error will occur and GenCade will not run. The default time step is 1.0 hour, and the default recording time step is 168.0 hours. The user may also give the simulation a title. The bottom right of the menu states Print Dates. In some cases, the user may be interested in the shoreline at a specific date not normally written in the print file (shoreline and transport information are only recorded yearly). Additional dates of interest may be added under Print Dates.

Figure 38. Model setup window


4.4 Beach Setup

The second tab under GenCade Model Control is the Beach Setup tab (Figure 39). The first section under this tab refers to the Sand and Beach Data. Here the user may enter the Effective Grain Size (always in mm), the Average Berm Height, and the Closure Depth. The default Effective Grain Size is 0.2 mm. Depending on the specified units, the default Average Berm Height is 1.0 ft or 1.0 m and the default Closure Depth is 10.0 ft or 10.0 m. Longshore Sand Transport Calibration Coefficients can also be found under Beach Setup. The defaults values for K1 and K2 are 0.5 and 0.25, respectively. These values should be adjusted during the calibration process.

Figure 39. Beach setup window


4.5 Seaward BC

The next tab under GenCade Model Control is the Seaward BC (or Boundary Condition) tab (Figure 40). The two main options in this tab are the Input Wave Adjustments section and the Other Options section. Under Input Wave Adjustments, the user may modify the Height Amplification Factor, Angle Amplification Factor, and Angle Offset. In the Other Options section, the user may define the Number of Cells in Offshore Contour Smoothing Window. The default ISMOOTH value is 11, but it is suggested that this number range between 11 and 101. This is another value that must be adjusted during the calibration stage.

Figure 40. Seaward boundary condition window


4.6 Lateral BC

The final tab under GenCade Model Control is the Lateral BC (or Boundary Condition) tab. There are three options for the Left Lateral BC and Right Lateral BC: Pinned, Gated, and Moving.

4.6.1 Pinned Boundary Condition

The pinned boundary condition is the default and should be used in most cases. A boundary specified as pinned will not move from the initial shoreline. When the pinned boundary condition is selected, all other options under Lateral BC will be grayed out. The pinned lateral boundary condition is shown in Figure 41.

Figure 41. Pinned lateral boundary condition window


4.6.2 Moving Boundary Condition

If a moving boundary condition is selected (Figure 42), the boundary will move a certain distance over a time period entered by the user. When a moving boundary is selected, the Length of Groin from Shoreline to Seaward Tip will still be grayed out, but the Shoreline Displacement Velocity will be active. Under Shoreline Displacement Velocity, the user should enter the shoreline displacement in the same units used to set up the grid. This shoreline displacement may occur over the entire simulation period, a day, or a time step. Shoreline displacement over the entire simulation is the most common input for a moving boundary condition, because many users have shorelines for the beginning and end of a simulation. If the user chooses to specify the shoreline displacement per time step, it should be noted that this number should be very small. For example, in an example with a time step of 0.5 hr and a shoreline displacement of 0.5 ft per time step, the total shoreline displacement during a two year simulation would be 17,520 ft.

Figure 42. Moving lateral boundary condition window


4.6.3 Gated Boundary Condition

The final boundary condition available in GenCade is a gated boundary condition (Figure 43). A gated boundary condition is bounded with a groin, so this is beneficial in cases where a groin or a jetty is located near the boundary. In the case of a gated boundary condition, it is also necessary to create and define a groin at the left or right boundary in the conceptual model. If the right lateral boundary is defined as a gated boundary, the groin should have a cell number of N+1. For example, if the grid has 100 cells, the groin should be located at cell number 101. After a gated boundary condition is selected, the Length of Groin from Shoreline to Seaward Tip will be active.

Figure 43. Gated lateral boundary condition window


4.7 Running GenCade

Once the GenCade grid and all of the parameters in Model Control have been updated, it is possible to run GenCade. Please remember to save the project before running GenCade. If the project is not saved prior to running GenCade, the most recent additions to the grid will not be written in the *.gen file. To run GenCade, go to the GenCade menu and select Run GenCade (Figure 44). A window will open that will describe the simulation. This window will notify the user if an error has occurred. Although there is no time bar stating the amount of time left in the simulation, the window will show when GenCade has finished calculating each year in the time simulation. The window will alert the user when the model is finished and will prompt to exit. Generally, it does not take very long to run GenCade. For an example with a 300 ft cell size, 635 cells, and a time step of 0.1 hour, it takes only about a minute to run each year of the simulation. A smaller cell size will significantly slow down the simulation, but it should still take less than 10 minutes to run for each year in the simulation. Multiple inlets, dredging events, and beach fill can also increase the run time.

Figure 44. Run GenCade


Once a GenCade grid is created, the user can choose to run the simulation outside of the SMS. Open the command prompt and move to the proper directory. The correct format to run GenCade is

GenCade_v1r3.exe project.gen

4.8 GenCade Output Files

Following a GenCade simulation, at least seven output files will be created in the assigned directory. The print file (*.prt) saves all of the information related to the simulation including wave heights, shorelines, and transport rates. The shoreline position output file (*.slo) documents the shoreline position for each time step for every cell in the grid. The net transport rate file (*.qtr) prints the net transport rate for each cell at every time step. The inlet shoal volume file (*.irv) lists volumes for each inlet shoal for every time step. A separate inlet shoal volume file is created for each inlet represented in the simulation. If the grid does not include an inlet, the *.irv file will not be created. All of the files except the print file may be opened and viewed in the SMS. The aforementioned files contain the majority of the information a user would need to evaluate the results of a simulation. The mean net annual transport files (*.mqn [mean annual net transport], *.mql [mean transport to the left], and *.mqr [mean transport to the right]) list the transport for each cell for each time step. The offshore contour for each time step for each cell is included in the offshore contour file (*.off). Additional information about GenCade output files can be found here.

4.9 Visualizing Results

Following a simulation, several output files will be created. These were listed in the previous section. Many of these files may be opened in the SMS for visualization. The first of these files is the *.slo file, or shoreline change file. Once this file is opened in the SMS, a box with the header Time Steps will appear. An arc representing the calculated shoreline should appear in the grid window. The default color and size of the calculated shoreline may be difficult to view. Go to Display->Display Options and click on 1D Grid to change the size and color of the calculated shoreline (Figure 45). The size and color of the initial shoreline, regional contour, and structures can also be changed. The default time under Time Steps is Relative Time. To view the simulated dates, right click on the words Time Steps and select Time Settings. Change the zero time to represent the first date in the simulation. Under Time Display, change Relative Time to Absolute Time/Date. The user can view the calculated shoreline at any date during the simulation and compare it with the initial shoreline or other reference line (Figure 46).

Figure 45. Display options window


Figure 46. Initial and calculated shorelines with regional contour


Plots can also be viewed in SMS. Under Display, click on Plot Wizard (Figure 47). In the first window, select GenCade Shoreline as the plot type. Keep the Active dataset under Dataset and Active time step under Time step selected and click Finish. A new window will appear showing the shoreline for the selected time step (Figure 48). Once the plot has been created, simply highlight Rate of Change or Shoreline under GenCade Grid in the data tree to change the plot.

Figure 47. Plot wizard for GenCade shorelines


Figure 48. Shoreline plot in the SMS


The inlet shoal volumes over the entire simulation may also be viewed in the SMS. Go to Display to Plot Wizard. Under Plot Type, select GenCade Inlet TS and click Next (Figure 49). The user may select any of the inlets included in the project and may choose the entire simulation or only a few years. The user may select one shoal or many shoals. After selecting the inlet, time, and corresponding shoals, click Finish. A new window with the shoal volumes over the course of the selected dates will open (Figure 50).

Figure 49. Plot wizard for inlet shoal volumes


Figure 50. Inlet shoal volumes plot in the SMS


Some users may want to plot shoreline change in Microsoft Excel or similar software. All of the information collected during the simulation was saved in the *.prt file (Figure 51). The shoreline change after each year in the simulation is located in this file. Although the shoreline change is not in column format, the format can easily be changed with a simple code. If the case uses constant resolution, the size of each cell is known and this information can easily be added to a spreadsheet. In the case of variable resolution, there is an additional input file: *.shdx. Each number in this file represents the grid cell size. The numbers in the file can also be converted to column format. Once the distance alongshore and the shoreline change have been added to Microsoft Excel or other spreadsheet software, then the shoreline change can be plotted.

Figure 51. Shoreline change in *.prt


It is also possible to use Microsoft Excel to plot longshore transport. In the *.prt file, longshore transport can be found by searching for “mean net annual transport”. This section of the *.prt file is shown in Figure 52. Please make a note of the units for transport listed in the *.prt file. The longshore transport can be plotted in Microsoft Excel in the same way as shoreline change.

Figure 52. Mean net annual transport in *.prt


It is slightly more difficult to compare the calculated shoreline to a measured shoreline. First, save as a new project. Open the measured shoreline in the SMS and define it as the initial shoreline (for this new saved project). Convert to 1-D grid again and save as a new project. This will save the measured shoreline as the initial shoreline. Both the measured and calculated shoreline will need to be compared to the initial shoreline. The values in the *.shi file represent the distance from the initial shoreline to the grid for each cell. The calculated shoreline can be found in the *.prt by searching for shoreline position after the total number of years in the simulation. These numbers will represent the distance offset from the GenCade grid. Shoreline change after each year in the simulation can also be found in the *.prt file. By saving the measured shoreline as the initial shoreline, this allows SMS to produce an input file for this shoreline in the same format as the initial shoreline and calculated shoreline. All of these shorelines can be converted to column format and pasted into Microsoft Excel. Subtract the initial shoreline from the measured shoreline and the calculated shoreline to get shoreline change for the measured and calculated shorelines.

5. Developing Alternatives

There are several reasons that a user may need to modify a GenCade grid. While calibrating the model, it may be necessary to refine the grid. Some examples of modifications necessary to develop alternatives include changing a small section of the regional contour, changing the initial shoreline, or adding new structures.

5.1 Minor Changes to the Regional Contour or Initial Shoreline

After setting up and running the model and looking at results, it may become necessary to make a minor modification to the regional contour or initial shoreline. For example, the initial shoreline may need to be smoothed near an unstructured inlet or the regional contour may need to be adjusted to account for a large ebb shoal.

To make changes to the regional contour or initial shoreline, return to the merged coverage with all of the shorelines, structures, and wave gauges under Map Data. Click Select Feature Vertex and drag each vertex to the desired location (Figure 53). It is also possible to add vertices by clicking Create Feature Vertex, adding the vertex, and moving it to the selected location. Extra vertices can be deleted after they are selected. Once the required updates to the regional contour or the initial shoreline are made, right click on the merged coverage and convert Map->1D Grid. The initial shoreline or regional contour must be selected by clicking on the Select Feature Arc. If the arc is not selected and highlighted, the old regional contour or initial shoreline will not be replaced. It should also be mentioned that only minor changes should be made to the regional contour or initial shoreline. The user should not modify the regional contour during model calibration.

Figure 53. Modify the shape of the regional contour


5.2 Modify Existing Structures or Beach Fills

For some alternatives, a beach fill or structure may need to be extended. To extend a structure, click on Select Feature Point. Click on the node at the end of the structure and extend it to the desired length. Beach fills can be modified in the same way. Right click on the merged coverage and convert Map->1D Grid. The modified structure must be selected (by clicking on Select Feature Point) for the changes to be noted in the GenCade model.

5.3 Replace Initial Shoreline or Regional Contour

Some projects may require analysis for several different time periods. If the structures exist during multiple time periods and the wave gauge data span many decades, it may be easiest to replace the initial shoreline in the conceptual model. The same process can be used if a new regional contour is necessary. Do not delete the existing GenCade grid. Right click on Map Data, click New Coverage, and select GenCade. It is best to give the new coverage a specific name that can be identified easily. Right click on this new coverage and scroll down to Type->Models->GenCade. Open the new shoreline or regional contour in the new coverage. Click on Select Feature Arc and define the arc. Right click on the new coverage and convert Map->1D Grid. The new initial shoreline or regional contour will replace the original.

5.4 Add Structures or Beach Fills

When a project has many different alternatives, it may be necessary to add new structures. Instead of developing a new grid for each alternative, features can be modified or added to a base grid that already has the initial shoreline, regional contour, wave gauges, and basic structures and beach fills. Right click on Map Data and select GenCade under New Coverage. Right click on this coverage and confirm that the model type is GenCade. In this new coverage, add new structures and beach fills by selecting the Create Feature Arc button. Specify the type of arc. Once all the new structures are included, right click on the new coverage and convert Map->1D Grid. The new arcs will be added in the GenCade grid. Additional structures or beach fills can also be added directly to the merged coverage that already has the initial shoreline, regional contour, and existing structures.

5.5 Modify Wave Gauges

The instructions above regarding adding new features can also apply to adding new wave gauges. However, sometimes the wave gauge data need to be modified. In reviewing the wave gauge information, a user may find that a few of the dates or values may be incorrect. If only a few values need to be modified, click on the merged coverage and select the wave gauge by clicking on Select Feature Point and double-click on the point representing the wave gauge. Click on Options and click on Data. Manually update the incorrect wave information. Once finished, convert Map->1D Grid. The wave gauge will now include the correct wave information. The steps to modify a wave gauge are shown in Figure 54.

Figure 54. Modify specific wave events


A user may also determine that an entire set of wave gauge information may be incorrect. This can occur by selecting the wrong wave gauge when pasting values or by incorrectly manually transforming waves. This can be remedied by deleting the existing wave gauge, creating a new wave gauge, and following the steps to add information to the wave gauge.

Return to GenCade Main Page.