WMS:GSSHA Menu: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
(7 intermediate revisions by the same user not shown)
Line 4: Line 4:
{{anchor|GSSHA Coverage Menu}}
{{anchor|GSSHA Coverage Menu}}
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...''' – Opens the [[WMS:GSSHA Stream Arcs#Stream Smoothing|''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''' –
*'''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.
*'''Renumber Storm Drains''' – Automatically reorders and numbers links and nodes in a storm drain arc.


==2D Grid Module GSSHA Menu==
; Smooth Stream/Pipe Arcs...
{{anchor|GSSHA Grid Menu}}
: Opens the [[WMS:Smooth GSSHA Streams#Stream Smoothing|''Smooth GSSHA Streams'' dialog]].
This menu is available when the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module 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.
; Read Stream Elevation...
: Brings up the ''Open'' dialog. Select the desired elevations file to import, then click '''Open'''.


; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|Open Group]] : Brings up a browser to open a GSSHA group file.
; 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.


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


:For long term simulations WMS copies the HMET file from its original location to the new GSSHA project directory.
; Renumber Storm Drains
: Automatically reorders and numbers links and nodes in a storm drain arc.


: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.
==2D Grid Module GSSHA Menu==
{{anchor|GSSHA Grid Menu}}
This menu is available when the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] 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|''Read Solution'']] command.


; [[WMS:GSSHA Multiple Scenarios#GSSHA Groups|Save Group]] : Opens the ''Save GSSHA Group File'' dialog for saving 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.


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


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


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


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


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


; [[WMS:GSSHA Channel Routing#Renumber Links And Nodes|Renumber Links]] : Automatically reorders and numbers links and nodes in a stream channel.
; Precipitation...
: Opens the [[WMS:GSSHA Precipitation|''GSSHA Precipitation''dialog]].


; Renumber Storm Drains : Automatically reorders and numbers links and nodes in a storm drain arc.
; Maps...
: Opens the [[WMS:GSSHA Maps|''GSSHA Maps'' dialog]].


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


; 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:
; Renumber Links
:* Suppress screen printing
: 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.
:* 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]]
; Renumber Storm Drains
: Automatically reorders and numbers links and nodes in a storm drain arc.


: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.
; Model Check...
: Opens the [[WMS:GSSHA#Model Check|''GSSHA Model Check'' dialog]], which lists potential problems with the GSSHA model run.  


: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]] : Opens the ''Save and Run GSSHA Group'' dialog to select which projects to run.
; Run GSSHA Group...
: Opens the [[WMS:GSSHA Multiple Simulations#GSSHA Groups|''Save and Run GSSHA Group'' dialog]] to select which projects to run.


; Read Calibration Output :
; 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 [[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.
; {{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.


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





Revision as of 22:00, 21 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 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 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...
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.