WMS:GSSHA: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{TOC right}}
Gridded Surface Subsurface Hydrologic Analysis (GSSHA) is a two-dimensional finite difference rainfall/runoff model. A finite difference grid is used to establish the computational domain and parameters for surface runoff. The GSSHA model is fully coupled with hydraulic stream flow/routing models. Parameters for stream channels are defined using arcs and then mapped to the appropriate underlying grid cells.
Gridded Surface Subsurface Hydrologic Analysis (GSSHA) is a two-dimensional finite difference rainfall/runoff model. A finite difference grid is used to establish the computational domain and parameters for surface runoff. The GSSHA model is fully coupled with hydraulic stream flow/routing models. Parameters for stream channels are defined using arcs and then mapped to the appropriate underlying grid cells.


Line 7: Line 8:
==GSSHA Menus==
==GSSHA Menus==
There are two ''GSSHA'' menus in WMS:
There are two ''GSSHA'' menus in WMS:
*When in the '''Map''' [[File:Map Module Icon.svg|16px]] module, the ''GSSHA'' menu is available when a GSSHA coverage is selected. See [[WMS:GSSHA Menu#GSSHA Coverage Menu]] for more details.
*When in the '''Map Module''' [[File:Map Module Icon.svg|16px]], the ''GSSHA'' menu is available when a GSSHA coverage is selected. See [[WMS:GSSHA Menu#GSSHA Coverage Menu|here]] for more details.
*When in the '''2D Grid''' [[File:2D Grid Icon.svg|16px]] module, the main ''GSSHA'' menu is available. See [[WMS:GSSHA Menu#GSSHA Grid Menu]] for more details.
*When in the '''2-D Grid Module''' [[File:2D Grid Icon.svg|16px]], the main ''GSSHA'' menu is available. See [[WMS:GSSHA Menu#GSSHA Grid Menu|here]] for more details.


==GSSHA File Types==
==Cell Properties==
The following are files types used in GSSHA. Many of the output files can also be used as input files.
The 2D grid cell properties include an ''I,J'' location and a scalar or index map value. The scalar or index map value is associated with the currently selected dataset in the Project Explorer and can be edited in the Properties Window. The ''I,J'' location can be viewed but not edited in the Properties Window. The 2D grid contours are a way of visualizing the spatial variation of the scalar or index map values for the selected dataset.
 
;AQE
:GSSHA lower extent of the aquifer file
 
;CDP
:GSSHA channel flow depth output file in link/node format


;CDQ
==GSSHA Model Check==
:GSSHA channel discharge output file in link/node format
{{anchor|Model Check}}[[File:Dialog GSSHA Model Check.png|thumb|right|380px|''GSSHA Model Check'' dialog]]
The ''GSSHA Model Check'' dialog lists potential problems with the GSSHA model. It is accessed by selecting ''GSSHA'' | '''Model Check...''' while in the '''2-D Grid Module''' [[File:2D Grid Icon.svg|14px]]. The model check runs through the input data for a GSSHA simulation and looks for obvious inconsistencies and problems with the model. The model check will find logical problems, but will not identify values that are outside of plausible ranges.


;CIF
An example of a problem that the model checker would not find is if a stream arc has a pit that pools water. Examples of potential problems that will be identified by the model check:
:GSSHA channel input file
*An index map has one or more cells whose ID is "0" (which is not allowed in GSSHA).
*A specified process that has an ID with parameters whose values are "0.00" (which indicates an incomplete entry).


;CMT
Clicking on a specific warning or error will open a dialog that will allow the potential problem to be fixed, if needed.
:GSSHA area property mapping table file


;CST
At the bottom of the dialog are three buttons:
:GSSHA channel stage output file in link/node format
*'''Help''' – Opens this article in a web browser.
*'''Done''' – Closes the ''GSSHA Model Check'' dialog.
*'''Print''' – Opens a ''Choose name of output file'' dialog. Enter the desired ''File name'' and click '''Save''' to export the model check information to a text file.


;CVT
==GSSHA Run Options==
:GSSHA channel velocity output file in link/node format
{{anchor|Run Options}}
[[File:Dialog GSSHA Run Options.png|thumb|right|280 px|''GSSHA Run Options'' dialog]]
The ''GSSHA Run Options'' dialog lists options for running the GSSHA model. It is accessed by selecting ''GSSHA'' | '''Run GSSHA...''' while in the '''2-D Grid Module''' [[File:2D Grid Icon.svg|14px]].


;DEP
The following sections and options are found in this dialog:
:GSSHA overland flow depth maps file
*''Location'' section – Lists the GSSHA project file that will be run. Click [[File:Open Macro.svg|16px]] to open a ''Save GSSHA Project File'' dialog. Select the desired project, or enter a new ''File name'' and click '''Save''' to close the ''Save GSSHA Project File'' dialog.
*''Options'' section – The following options can be turned on or off:
**''Suppress screen printing'' – Suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation. This option requires that the ''Save file before running'' be turned on.
**''Save file before running'' – Instructs GSSHA to save the project file prior to running GSSHA.
**''Pause GSSHA window after running''


;DHT
At the bottom of the dialog are the following buttons:
:GSSHA channel depth hot start file
*'''OK''' – Saves the changes and opens the [[WMS:Model Wrapper|Model Wrapper]].
*'''Cancel''' – Cancels the GSSHA model run and closes the ''GSSHA Run Options'' dialog.


;DIK
==Read GSSHA Solution==
:GSSHA file containing no-flow embankments between overland grid cells
{{anchor|Read Solution}}[[File:WMS Read GSSHA Solution dialog.png|thumb|right|280 px|''Read GSSHA Solution'' dialog]]
The ''Read GSSHA Solution'' dialog allows previously saved GSSHA solutions to be imported into a GSSHA project. The dialog contains the following information:
*''Simulation'' – The selected GSSHA project file name containing solution data.
*''Path'' – The file path to the selected GSSHA project file.
*'''Select Simulation...''' – Brings up an ''Open'' dialog, allowing browsing to and selection of the desired GSSHA project file.
*''Solution file''' – Indicates whether the selected GSSHA project file contains solution data.


;DRN
At the bottom of the dialog are the following buttons:
:GSSHA rainfall rate as it is being applied
*'''Help''' – Opens this article in a web browser.
 
*'''OK''' – Saves and changes, closes the ''Read GSSHA Solution'' dialog, and imports the solution data. The solution data will be within a [[File:Generic Folder Locked.svg|14px]] GSSHA solutions folder.
;DSC
*'''Cancel''' – Discards and changes and closes the ''Read GSSHA Solution'' dialog.
:GSSHA overland discharge output file
 
;ELE
:GSSHA surface grid/cell elevation file
 
;EXT
:GSSHA replacement parameter or value file
 
;FGD
:GSSHA maximum water depth on the overland grid output file
 
;FST
:GSSHA maximum water depth on the stream network output file
 
;GAG
:GSSHA gaged or radar precip data input file
 
;GST
:GSSHA grid/stream file
 
;GWH
:GSSHA groundwater heads file
 
;IDP
:GSSHA infiltration depth file
 
;IDX
:GSSHA cell index file
 
;IHL
:GSSHA hydrograph output locations file
 
;ITH
:GSSHA soil moisture output locations file
 
;LSP
:GSSHA file containing low spots for overtopping on the embankments
 
;MAP
:WMS map file
 
;MSK
:GSSHA watershed delineation mask file
 
;OAL
:GSSHA gridded output file of overland algal mass and concentration
 
;OCB
:GSSHA gridded output file of overland CBOD mass and concentration
 
;ODO
:GSSHA gridded output file of overland DO mass and concentration
 
;ODP
:GSSHA gridded output overland depths file, written at the end of the simulation
 
;OHL
:GSSHA hydrograph output file
 
;ON2
:GSSHA gridded output file of overland NO2 mass and concentration
 
;ON3
:GSSHA gridded output file of overland NO3 mass and concentration
 
;ON4
:GSSHA gridded output file of overland NH4 mass and concentration
 
;OON
:GSSHA gridded output file of overland ON mass and concentration
 
;OOP
:GSSHA gridded output file of overland OP mass and concentration
 
;OP4
:GSSHA gridded output file of overland PO4 mass and concentration
 
;OPT
:GSSHA values of event peak flow and event volume for use by external optimization methods output file
 
;OTH
:GSSHA soils moisture time series output file
 
;OTL
:GSSHA outlet hydrograph time series discharge file
 
;OUT
:GSSHA output summary file
 
;OVN
:GSSHA roughness file
 
;PRJ
:GSSHA project file
 
;PRO
:GSSHA projection file
 
;QHT
:GSSHA channel flow hot start file
 
;SMO
:GSSHA soil moisture output file
 
;SMT
:GSSHA streams mapping table file
 
;SRC
:GSSHA point and non-point loadings file
 
;STO
:WMS stochastic information file
 
;SUM
:GSSHA summary output file
 
;TON
:GSSHA gridded output file of total N mass and concentration
 
;TOP
:GSSHA gridded output file of total P mass and concentration
 
;TRE
:WMS tree file
 
;TS
:GSSHA time series input file
 
;WTE
:GSSHA initial water table elevation file
 
==Cell Properties==
The 2D grid cell properties include an ''I,J'' location and a scalar or index map value. The scalar or index map value is associated with the currently selected dataset in the Project Explorer and can be edited in the Properties Window. The ''I,J'' location can be viewed but not dited in the Properties Window. The 2D grid contours are a way of visualizing the spatial variation of the scalar or index map values for the selected dataset.


==References==
==References==

Latest revision as of 23:05, 13 May 2021


Gridded Surface Subsurface Hydrologic Analysis (GSSHA) is a two-dimensional finite difference rainfall/runoff model. A finite difference grid is used to establish the computational domain and parameters for surface runoff. The GSSHA model is fully coupled with hydraulic stream flow/routing models. Parameters for stream channels are defined using arcs and then mapped to the appropriate underlying grid cells.

Features of GSSHA include 1D stream flow and infiltration, 2D overland flow and groundwater, and full coupling between the groundwater, shallow soils, streams, and overland flow.[1] "Sediment and constituent fate and transport are simulated in the shallow soils, overland flow plane, and in streams and channels. GSSHA can be used as an episodic or continuous model where soil surface moisture, groundwater levels, stream interactions, and constituent fate are continuously simulated. The fully coupled groundwater to surface-water interaction allows GSSHA to model basins in both arid and humid environments."[1]

The GSSHA model can be added to a paid edition of WMS.[2]

GSSHA Menus

There are two GSSHA menus in WMS:

  • When in the Map Module Map Module Icon.svg, the GSSHA menu is available when a GSSHA coverage is selected. See here for more details.
  • When in the 2-D Grid Module 2D Grid Icon.svg, the main GSSHA menu is available. See here for more details.

Cell Properties

The 2D grid cell properties include an I,J location and a scalar or index map value. The scalar or index map value is associated with the currently selected dataset in the Project Explorer and can be edited in the Properties Window. The I,J location can be viewed but not edited in the Properties Window. The 2D grid contours are a way of visualizing the spatial variation of the scalar or index map values for the selected dataset.

GSSHA Model Check

GSSHA Model Check dialog

The GSSHA Model Check dialog lists potential problems with the GSSHA model. It is accessed by selecting GSSHA | Model Check... while in the 2-D Grid Module 2D Grid Icon.svg. The model check runs through the input data for a GSSHA simulation and looks for obvious inconsistencies and problems with the model. The model check will find logical problems, but will not identify values that are outside of plausible ranges.

An example of a problem that the model checker would not find is if a stream arc has a pit that pools water. Examples of potential problems that will be identified by the model check:

  • An index map has one or more cells whose ID is "0" (which is not allowed in GSSHA).
  • A specified process that has an ID with parameters whose values are "0.00" (which indicates an incomplete entry).

Clicking on a specific warning or error will open a dialog that will allow the potential problem to be fixed, if needed.

At the bottom of the dialog are three buttons:

  • Help – Opens this article in a web browser.
  • Done – Closes the GSSHA Model Check dialog.
  • Print – Opens a Choose name of output file dialog. Enter the desired File name and click Save to export the model check information to a text file.

GSSHA Run Options

GSSHA Run Options dialog

The GSSHA Run Options dialog lists options for running the GSSHA model. It is accessed by selecting GSSHA | Run GSSHA... while in the 2-D Grid Module 2D Grid Icon.svg.

The following sections and options are found in this dialog:

  • Location section – Lists the GSSHA project file that will be run. Click Open Macro.svg to open a Save GSSHA Project File dialog. Select the desired project, or enter a new File name and click Save to close the Save GSSHA Project File dialog.
  • Options section – The following options can be turned on or off:
    • Suppress screen printing – Suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation. This option requires that the Save file before running be turned on.
    • Save file before running – Instructs GSSHA to save the project file prior to running GSSHA.
    • Pause GSSHA window after running

At the bottom of the dialog are the following buttons:

  • OK – Saves the changes and opens the Model Wrapper.
  • Cancel – Cancels the GSSHA model run and closes the GSSHA Run Options dialog.

Read GSSHA Solution

Read GSSHA Solution dialog

The Read GSSHA Solution dialog allows previously saved GSSHA solutions to be imported into a GSSHA project. The dialog contains the following information:

  • Simulation – The selected GSSHA project file name containing solution data.
  • Path – The file path to the selected GSSHA project file.
  • Select Simulation... – Brings up an Open dialog, allowing browsing to and selection of the desired GSSHA project file.
  • Solution file' – Indicates whether the selected GSSHA project file contains solution data.

At the bottom of the dialog are the following buttons:

  • Help – Opens this article in a web browser.
  • OK – Saves and changes, closes the Read GSSHA Solution dialog, and imports the solution data. The solution data will be within a Generic Folder Locked.svg GSSHA solutions folder.
  • Cancel – Discards and changes and closes the Read GSSHA Solution dialog.

References

  1. ^ a b "Overview:Overview". GSSHA Wiki. http://www.gsshawiki.com/Overview:Overview. Retrieved on April 26, 2019. 
  2. ^ "WMS Editions & Pricing". Aquaveo. http://www.aquaveo.com/software/wms-pricing. Retrieved on April 26, 2019.