WMS:GSSHA Menu: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 12: Line 12:


; Update Lake Cells
; Update Lake Cells
:  
: Updates lake cells after changes have been made to the project that would affect the lake cells (such as a change in elevation of an embankment arc crossing a stream). In order for the changes to be visible, open the [[WMS:Display Options|''Display Options'' dialog]], select "2D Grid Data" from the list on the left, and turn on the three ''Lake Cells'' options on the ''2D Grid'' tab.


; Renumber Links
; Renumber Links
: Automatically reorders and numbers links and nodes in a stream channel. See the [[WMS:GSSHA Channel Routing#Renumber Links and Nodes|GSSHA Channel Routing article]] for more details.
: Automatically reorders and numbers links and nodes in a stream channel. See the [[WMS:GSSHA Channel Routing#Renumber Links and Nodes|GSSHA Channel Routing]] article for more details.


; Renumber Storm Drains
; Renumber Storm Drains
Line 24: Line 24:
This menu is available when the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module is active.
This menu is available when the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module is active.
; Open Project File...  
; Open Project File...  
: Brings up the ''Open'' dialog. Browse to and select the desired GSSHA project file to open, then click '''Open'''. A GSSHA project file begins with the first content line either being "GSSHAPROJECT" or "CASC2DPROJECT". Once a valid project file has been identified, WMS will import all of the files needed for input to GSSHA.  
: Brings up the ''Open'' dialog. Browse to and select the desired GSSHA project file, then click '''Open'''. A GSSHA project file begins with the first content line either being "GSSHAPROJECT" or "CASC2DPROJECT". Once a valid project file has been identified, WMS will import all of the files needed for input to GSSHA.  
: Note that the channel input file is not imported. Instead, the channel input information is re-created from the WMS map file that stores the GSSHA coverage.  
: Note that the channel input file is not imported. Instead, the channel input information is re-created from the WMS map file that stores the GSSHA coverage.  
: To import a GSSHA output file, use the [[#Read Solution|''Read Solution'']] command.
: To import a GSSHA output file, use the [[#Read Solution|''Read Solution'']] command.


; Open Group...  
; Open Group...  
: Brings up the ''Open'' dialog. Browse to and select the desired GSSHA group file to open, then click '''Open'''. See the [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|GSSHA Multiple Scenarios]] for more details.
: Brings up the ''Open'' dialog. Browse to and select the desired GSSHA group file, then click '''Open'''. See the [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|GSSHA Multiple Scenarios]] article for more details.


; Save Project File...  
; Save Project File...  
: Opens a ''Save GSSHA Project File'' dialog. Browse to the desired save location, enter the desired ''File name'', and click '''Save''' to save the GSSHA project file and all associated GSSHA input files. WMS automatically uses the GSSHA project file name as a prefix for all GSSHA input files. The only exception is for index map files, which are assigned default names using the convention "id_map_##.idx", where "##" is automatically generated by WMS. All files are saved to the same directory. For long term simulations, WMS copies the HMET file from its original location to the new GSSHA project directory.
: Opens a ''Save GSSHA Project File'' dialog. Browse to the desired save location, enter the desired ''File name'', and click '''Save''' to save the GSSHA project file and all associated GSSHA input files. WMS automatically uses the GSSHA project file name as a prefix for all GSSHA input files. The only exception is for index map files, which are assigned default names using the convention "id_map_##.idx", where "##" is automatically generated by WMS. All files are saved to the same directory. For long term simulations, WMS copies the HMET file from its original location to the new GSSHA project directory.


:For more detailed management of the GSSHA input and output files names, see the [[WMS:Save GSSHA Project File|''Save GSSHA Project File'' dialog]].
:GSSHA currently supports file names (including path and file name) with lengths up to 128 characters. If GSSHA files are placed in a directory with a path that causes the combined path and file name to exceed 128 characters, then GSSHA will not run. For more detailed management of the GSSHA input and output files names, see the [[WMS:Save GSSHA Project File|''Save GSSHA Project File'' dialog]].


; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|Save Group]]
; Save Group...
: Opens the ''Save GSSHA Group File'' dialog for saving a GSSHA group file.
: Opens the [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|''Save GSSHA Group File'' dialog]] for saving a GSSHA group file.


; Job Control  
; Job Control...
: Opens the [[WMS:GSSHA Job Control|''GSSHA Job Control Parameters'']] dialog. The ''GSSHA Job Control Parameters'' dialog contains options and data for computational processes in a GSSHA simulation are specified. See [[WMS:GSSHA Job Control|GSSHA Job Control]] for more information.
: Opens the [[WMS:GSSHA Job Control|''GSSHA Job Control Parameters'']] dialog, where options and data are specified for computational processes in a GSSHA simulation.


; Clean Digital Dams  
; Clean Digital Dams  
: Runs the CleanDam algorithm. Digital dams occur where a stream leaves a cell at or near a corner. See [[WMS:GSSHA Digital Dams|GSSHA Digital Dams]] for more information.
: Runs the [[WMS:GSSHA Digital Dams#Modification|CleanDam algorithm]]. Digital dams occur where a stream leaves a cell at or near a corner.


; Precipitation  
; Precipitation...
: Opens the [[WMS:GSSHA Precipitation|''GSSHA Precipitation'']] dialog.
: Opens the [[WMS:GSSHA Precipitation|''GSSHA Precipitation''dialog]].


; Maps  
; Maps...
: Opens the [[WMS:GSSHA Maps|''GSSHA Maps'']] dialog.
: Opens the [[WMS:GSSHA Maps|''GSSHA Maps'' dialog]].


; Map Tables  
; Map Tables...
: Brings up the [[WMS:GSSHA Mapping Tables|''GSSHA Map Table Editor'']].
: Brings up the [[WMS:GSSHA Mapping Tables|''GSSHA Map Table Editor'' dialog]].


; [[WMS:GSSHA Channel Routing#Renumber Links And Nodes|Renumber Links]]
; Renumber Links
: Automatically reorders and numbers links and nodes in a stream channel.
: Automatically reorders and numbers links and nodes in a stream channel. See the [[WMS:GSSHA Channel Routing#Renumber Links and Nodes|GSSHA Channel Routing]] article for more details.


; Renumber Storm Drains  
; Renumber Storm Drains  
: Automatically reorders and numbers links and nodes in a storm drain arc.
: Automatically reorders and numbers links and nodes in a storm drain arc.


; Model Check  
; Model Check...
: [[Image:Dialog_GSSHA_Model_Check.png|thumb|350 px|''GSSHA Model Check'' dialog]] Runs through the input data for a GSSHA simulation and looks for obvious inconsistencies and problems with the model. The model checker will not identify values that are outside of plausible ranges, etc., only logical problems. For example, an index map has one or more cells whose ID is 0 (which is not allowed in GSSHA), or a specified process that has an ID with parameters whose values are 0.00 (which indicates an incomplete entry). An example of a problem that the model checker would not find is if a stream arc has a pit that pools water.
: Opens the [[WMS:GSSHA#Model Check|''GSSHA Model Check'' dialog]], which lists potential problems with the GSSHA model run.  
 
; Run GSSHA
: Launches the GSSHA model run. Select an existing GSSHA project file or specify the name and location of the GSSHA project file to be saved before running the simulation. The ''GSSHA Run Options'' include:
:* Suppress screen printing
:* Save files before running
:* Pause GSSHA window after running
:The ''Suppress screen printing'' option suppresses the output of runtime data from GSSHA at each time step, but significantly reduces the overall run time required for a GSSHA simulation.  This option also requires that the GSSHA input files be saved before running the simulation.
 
:[[Image:Dialog_GSSHA_Run_Options.png|thumb|none|left|300 px|''GSSHA Run Options'' dialog]]
 
:WMS will automatically read the GSSHA solution produced by the simulation when the '''Close''' button is clicked in the WMS Model Wrapper if the ''Read Solution on Exit'' option is toggled on.


:Note: GSSHA currently supports file names (including path and file name) with lengths less than or equal to 128 characters. If GSSHA tutorial files are placed in a directory with a path that causes the combined path and file name to exceed 128 characters, then GSSHA will not run.
; Run GSSHA...
: Opens the [[WMS:GSSHA#GSSHA Run Options|''GSSHA Run Options'' dialog]]. Launches the GSSHA model run.  


; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|Run GSSHA Group]]
; Run GSSHA Group...
: Opens the ''Save and Run GSSHA Group'' dialog to select which projects to run.
: Opens the [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|''Save and Run GSSHA Group'' dialog]] to select which projects to run.


; Read Calibration Output  
; Read Calibration Output...
:  
:  


; {{anchor|Read Solution}}Read Solution  
; {{anchor|Read Solution}}Read Solution...
: Brings up a browser to open a GSSHA solution file and all of the associated datasets.  After import, WMS lumps the solution file and all associated datasets together into a solution folder [[File:Generic Folder Locked.svg|16 px]] in the Project Explorer. All of the datasets in the folder are treated as regular datasets. Organizing the datasets into a solution allows several solutions to be in memory at the same time. Several dialogs look for solutions and the associated datasets to set up and display output graphs. Along with the regular datasets, the summary file for the project is also accessible for each solution by double-clicking the summary file project explorer item under the solution folder.
: Brings up a browser to open a GSSHA solution file and all of the associated datasets.  After import, WMS lumps the solution file and all associated datasets together into a solution folder [[File:Generic Folder Locked.svg|16 px]] in the Project Explorer. All of the datasets in the folder are treated as regular datasets. Organizing the datasets into a solution allows several solutions to be in memory at the same time. Several dialogs look for solutions and the associated datasets to set up and display output graphs. Along with the regular datasets, the summary file for the project is also accessible for each solution by double-clicking the summary file project explorer item under the solution folder.



Revision as of 00:11, 11 May 2019

The GSSHA model has two menus: one that can be accessed through Map Map Module Icon.svg module and the other through the 2D Grid 2D Grid Icon.svg module.

Map Module GSSHA Menu

This menu is available when a GSSHA coverage is the active coverage, or if WMS is switched to the Map Map Module Icon.svg module.

Smooth Stream/Pipe Arcs...
Opens the Smooth GSSHA Streams dialog.
Read Stream Elevation...
Brings up the Open dialog. Select the desired elevations file to import, then click Open.
Update Lake Cells
Updates lake cells after changes have been made to the project that would affect the lake cells (such as a change in elevation of an embankment arc crossing a stream). In order for the changes to be visible, open the Display Options dialog, select "2D Grid Data" from the list on the left, and turn on the three Lake Cells options on the 2D Grid tab.
Renumber Links
Automatically reorders and numbers links and nodes in a stream channel. See the GSSHA Channel Routing article for more details.
Renumber Storm Drains
Automatically reorders and numbers links and nodes in a storm drain arc.

2D Grid Module GSSHA Menu

This menu is available when the 2D Grid 2D Grid Icon.svg module is active.

Open Project File...
Brings up the Open dialog. Browse to and select the desired GSSHA project file, then click Open. A GSSHA project file begins with the first content line either being "GSSHAPROJECT" or "CASC2DPROJECT". Once a valid project file has been identified, WMS will import all of the files needed for input to GSSHA.
Note that the channel input file is not imported. Instead, the channel input information is re-created from the WMS map file that stores the GSSHA coverage.
To import a GSSHA output file, use the Read Solution command.
Open Group...
Brings up the Open dialog. Browse to and select the desired GSSHA group file, then click Open. See the GSSHA Multiple Scenarios article for more details.
Save Project File...
Opens a Save GSSHA Project File dialog. Browse to the desired save location, enter the desired File name, and click Save to save the GSSHA project file and all associated GSSHA input files. WMS automatically uses the GSSHA project file name as a prefix for all GSSHA input files. The only exception is for index map files, which are assigned default names using the convention "id_map_##.idx", where "##" is automatically generated by WMS. All files are saved to the same directory. For long term simulations, WMS copies the HMET file from its original location to the new GSSHA project directory.
GSSHA currently supports file names (including path and file name) with lengths up to 128 characters. If GSSHA files are placed in a directory with a path that causes the combined path and file name to exceed 128 characters, then GSSHA will not run. For more detailed management of the GSSHA input and output files names, see the Save GSSHA Project File dialog.
Save Group...
Opens the Save GSSHA Group File dialog for saving a GSSHA group file.
Job Control...
Opens the GSSHA Job Control Parameters dialog, where options and data are specified for computational processes in a GSSHA simulation.
Clean Digital Dams
Runs the CleanDam algorithm. Digital dams occur where a stream leaves a cell at or near a corner.
Precipitation...
Opens the GSSHA Precipitationdialog.
Maps...
Opens the GSSHA Maps dialog.
Map Tables...
Brings up the GSSHA Map Table Editor dialog.
Renumber Links
Automatically reorders and numbers links and nodes in a stream channel. See the GSSHA Channel Routing article for more details.
Renumber Storm Drains
Automatically reorders and numbers links and nodes in a storm drain arc.
Model Check...
Opens the GSSHA Model Check dialog, which lists potential problems with the GSSHA model run.
Run GSSHA...
Opens the GSSHA Run Options dialog. Launches the GSSHA model run.
Run GSSHA Group...
Opens the Save and Run GSSHA Group dialog to select which projects to run.
Read Calibration Output...
 
Read Solution...
Brings up a browser to open a GSSHA solution file and all of the associated datasets. After import, WMS lumps the solution file and all associated datasets together into a solution folder Generic Folder Locked.svg in the Project Explorer. All of the datasets in the folder are treated as regular datasets. Organizing the datasets into a solution allows several solutions to be in memory at the same time. Several dialogs look for solutions and the associated datasets to set up and display output graphs. Along with the regular datasets, the summary file for the project is also accessible for each solution by double-clicking the summary file project explorer item under the solution folder.
Individual solution output time series data for a cell may be viewed from the Solution Results dialog accessed from the Feature Point/Node Type dialog. This dialog will only show the output dataset time series for the cell that underlies the feature point selected. To compare the solution output at a cell with observed data, see the GSSHA Observation Points section.