WMS:GSSHA Menu: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The GSSHA model has two menus: one that can be accessed through '''Map''' [[File:Map Module Icon.svg|16px]] module and the other through the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module.
The GSSHA model has two menus: one that can be accessed through '''Map Module''' [[File:Map Module Icon.svg|16px]] and the other through the '''2-D Grid Module''' [[File:2D Grid Icon.svg|14px]].


==Map Module GSSHA Menu==
==Map Module GSSHA Menu==
Line 5: Line 5:
This menu is available when a GSSHA coverage is the active coverage, or if WMS is switched to the '''Map''' [[File:Map Module Icon.svg|16px]] module.
This menu is available when a GSSHA coverage is the active coverage, or if WMS is switched to the '''Map''' [[File:Map Module Icon.svg|16px]] module.


;Smooth Stream/Pipe Arcs...
; Smooth Stream/Pipe Arcs...
:Opens the [[WMS:GSSHA Stream Arcs#Stream Smoothing|''Smooth GSSHA Streams'' dialog]].
: Opens the [[WMS:Smooth GSSHA Streams#Stream Smoothing|''Smooth GSSHA Streams'' dialog]].


;Read Stream Elevation...
; Read Stream Elevation...
:Brings up the ''Open'' dialog. Select the desired elevations file to import, then click '''Open'''.
: Brings up the ''Open'' dialog. Select the desired elevations file to import, then click '''Open'''.


;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
:Automatically reorders and numbers links and nodes in a storm drain arc.
: Automatically reorders and numbers links and nodes in a storm drain arc.


==2D Grid Module GSSHA Menu==
==2-D Grid Module GSSHA Menu==
{{anchor|GSSHA Grid Menu}}
{{anchor|GSSHA Grid Menu}}
This menu is available when the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module is active.
This menu is available when the '''2-D Grid Module''' [[File:2D Grid Icon.svg|14px]] is active.
; Open Project File : Brings up a browser to open a GSSHA project file. This browser will look for a GSSHA project file. A GSSHA project file begins with the first line either being GSSHAPROJECT or CASC2DPROJECT. Once a valid project file has been identified, WMS will read in all of the files needed for input to GSSHA. The channel input file is not read in but instead the channel input information is re-created from the WMS map file that stores the GSSHA coverage. GSSHA output files are not read in by the '''Open Project File''' command but instead are read by the '''Read Solution''' command.
; 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|''Read Solution'']] command.


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


; Save Project File : Opens the ''Save GSSHA Project File'' dialog for saving a GSSHA project file. Specify the GSSHA project file name and location in the ''Save GSSHA Project File'' dialog. Select ''Save'' to save the GSSHA project file and all other GSSHA input files. WMS automatically uses the GSSHA project file name as a prefix for all GSSHA input files (file extensions are used to differentiate between GSSHA input files), except for the index map files, which are assigned default names using the convention id_map_##.idx, where ## is generated by WMS. All files are written to the same directory according to the specified location.
; 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.


: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 [[WMS:Save GSSHA Project File|''Save GSSHA Project File'' dialog]].


:It is also possible to manage all of the GSSHA input and output files names using the ''Manage files'' option in the [[WMS:GSSHA Job Control|''GSSHA Job Control Parameters'']] dialog.
; Save Group...
: Opens the [[WMS:GSSHA Multiple Simulations#GSSHA Groups|''Save GSSHA Group File'' dialog]] for saving a GSSHA group file.


; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|Save Group]] : Opens the ''Save GSSHA Group File'' dialog for saving a GSSHA group file.
; Job Control...
: Opens the [[WMS:GSSHA Job Control|''GSSHA Job Control Parameters'']] dialog, where options and data are specified for computational processes in a GSSHA simulation.


; 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.
; Clean Digital Dams...
: Runs the [[WMS:GSSHA Digital Dams#Modification|CleanDam algorithm]]. Digital dams occur where a stream leaves a cell at or near a corner.


; 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.
; Precipitation...
: Opens the [[WMS:GSSHA Precipitation|''GSSHA Precipitation'' dialog]].


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


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


; Map Tables : Brings up the [[WMS:GSSHA Mapping Tables|''GSSHA Map Table Editor'']].
; 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.


; [[WMS:GSSHA Channel Routing#Renumber Links And Nodes|Renumber Links]] : Automatically reorders and numbers links and nodes in a stream channel.
; Renumber Storm Drains
: Automatically reorders and numbers links and nodes in a storm drain arc.


; Renumber Storm Drains : Automatically reorders and numbers links and nodes in a storm drain arc.
; Model Check...
: Opens the [[WMS:GSSHA#Model Check|''GSSHA Model Check'' dialog]], which lists potential problems with the GSSHA model run.  


; 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.
; Run GSSHA...
: Opens the [[WMS:GSSHA#GSSHA Run Options|''GSSHA Run Options'' dialog]]. Launches 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:
; Run GSSHA Group...
:* Suppress screen printing
: Opens the [[WMS:GSSHA Multiple Simulations#GSSHA Groups|''Save and Run GSSHA Group'' dialog]] to select which projects to run.
:* 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]]
; Read Calibration Output...
: Import calibration output files into the current project.


: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.
; {{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.


: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.
: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 [[WMS:GSSHA Observations|GSSHA Observations]] section.
 
; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|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 [[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.
 
: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 [[WMS:GSSHA Observation Points|GSSHA Observation Points]] section.





Latest revision as of 16:44, 23 July 2024

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

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.

2-D Grid Module GSSHA Menu

This menu is available when the 2-D Grid Module 2D Grid Icon.svg 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 Simulations 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 Precipitation dialog.
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...
Import calibration output files into the current project.
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 Observations section.