WMS:GSSHA: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(44 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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.
{{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.


According to the [http://www.gsshawiki.com/Overview:Overview GSSHA wiki Overview] page, "features include two dimensional (2-D) overland flow, 1-D stream flow, 1-D infiltration, 2-D groundwater, and full coupling between the groundwater, shallow soils, streams, and overland flow. 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."[http://www.gsshawiki.com/Overview:Overview]
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.<ref name="GSSHA overview">{{cite web|url=http://www.gsshawiki.com/Overview:Overview|title=Overview:Overview|publisher=GSSHA Wiki|accessdate=April 26, 2019}}</ref> "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."<ref name="GSSHA overview"/>


A detailed online reference manual for GSSHA is found here:
The GSSHA model can be added to a paid edition of WMS.<ref name="WMS Pricing">{{cite web|url=http://www.aquaveo.com/software/wms-pricing|title=WMS Editions & Pricing|publisher=Aquaveo|accessdate=April 26, 2019}}</ref>
[http://www.gsshawiki.com http://www.gsshawiki.com]


The GSSHA model can be added to a [http://www.aquaveo.com/software/wms-pricing paid edition] of WMS. [[Category:Link to Store]]
==GSSHA Menus==
There are two ''GSSHA'' menus in WMS:
*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 '''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.


==Open Project File==
==Cell Properties==
The '''Open Project File''' command in the ''GSSHA'' menu looks 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.
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.


==Model Check==
==GSSHA Model Check==
[[Image:Dialog_GSSHA_Model_Check.png|thumb|350 px|''GSSHA Model Check'' dialog]]
{{anchor|Model Check}}[[File:Dialog GSSHA Model Check.png|thumb|right|380px|''GSSHA Model Check'' dialog]]
The GSSHA '''Model Check''' command 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.
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.  


==Run Simulation==
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:
The '''Run GSSHA''' command launches GSSHA in the WMS Model Wrapper. 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:
*An index map has one or more cells whose ID is "0" (which is not allowed in GSSHA).
* Suppress screen printing
*A specified process that has an ID with parameters whose values are "0.00" (which indicates an incomplete entry).  
* 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]]
Clicking on a specific warning or error will open a dialog that will allow the potential problem to be fixed, if needed.


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.
At the bottom of the dialog are three buttons:
*'''Help''' &ndash; Opens this article in a web browser.
*'''Done''' &ndash; Closes the ''GSSHA Model Check'' dialog.
*'''Print''' &ndash; 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.


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.
==GSSHA Run Options==
{{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]].  


==Save Project File==
The following sections and options are found in this dialog:
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.
*''Location'' section &ndash; 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 &ndash; The following options can be turned on or off:
**''Suppress screen printing'' &ndash; 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'' &ndash; Instructs GSSHA to save the project file prior to running GSSHA.
**''Pause GSSHA window after running''


For long term simulations WMS copies the HMET file from its original location to the new GSSHA project directory.
At the bottom of the dialog are the following buttons:
*'''OK''' &ndash; Saves the changes and opens the [[WMS:Model Wrapper|Model Wrapper]].
*'''Cancel''' &ndash; Cancels the GSSHA model run and closes the ''GSSHA Run Options'' dialog.


It is also possible to manage all of the GSSHA input and output files names using the ''Manage files'' option in the ''GSSHA Job Control Parameters'' dialog.
==Read GSSHA Solution==
 
{{anchor|Read Solution}}[[File:WMS Read GSSHA Solution dialog.png|thumb|right|280 px|''Read GSSHA Solution'' dialog]]
==GSSHA Files==
The ''Read GSSHA Solution'' dialog allows previously saved GSSHA solutions to be imported into a GSSHA project. The dialog contains the following information:
 
*''Simulation'' &ndash; The selected GSSHA project file name containing solution data.
Here are tables of some of the available files for GSSHA.
*''Path'' &ndash; The file path to the selected GSSHA project file.
 
*'''Select Simulation...''' &ndash; Brings up an ''Open'' dialog, allowing browsing to and selection of the desired GSSHA project file.
* For more information on these files see the [http://gsshawiki.com/GSSHA_User%27s_Manual GSSHA online manual]
*''Solution file''' &ndash; Indicates whether the selected GSSHA project file contains solution data.
 
{| class="wikitable"
|+'''Files'''
!width="40" align="center"|Name
!width="250" align="center"|Description
|-
|PRJ||GSSHA [http://gsshawiki.com/File_Formats:Project_File_Format Project File]
|-
|TRE||WMS Tree File
|-
|STO||WMS Stochastic Information File
|-
|MAP||WMS Map File
|-
|OUT||GSSHA Output Summary File
|-
|IDX||GSSHA Cell Index File
|-
|PRO||GSSHA Projectioin File
|-
|OTL||GSSHA Outlet Series Discharge File
|-
|MSK||GSSHA Watershed Delineation Mask File
|-
|ELE||GSSHA Cell Elevation File
|-
|DEP||GSSHA Depth File
|-
|CMT||GSSHA Area Property Mapping Table File
|-
|}
 
==Read Solution==
While solutions are not new to GSSHA, being able to work with them in WMS is a new feature. Accessible from the ''GSSHA'' menu in the 2D Grid module is the command '''Read Solution''' which looks for a GSSHA project file and then reads in all of the associated datasets and lumps them together into a solution folder in the Project Explorer. Solution folders are identified by a lowercase "s" on the folder. 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.
 
==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 cannot be 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.


==Related Topics==
At the bottom of the dialog are the following buttons:
* [[WMS:GSSHA Calibration|GSSHA Calibration]]
*'''Help''' &ndash; Opens this article in a web browser.
* [[WMS:GSSHA Channel Routing|GSSHA Channel Routing]]
*'''OK''' &ndash; 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.
* [[WMS:GSSHA Contaminants|GSSHA Contaminants]]
*'''Cancel''' &ndash; Discards and changes and closes the ''Read GSSHA Solution'' dialog.
* [[WMS:GSSHA Digital Dams|GSSHA Digital Dams]]
* [[WMS:GSSHA Embankment Arcs|GSSHA Embankment Arcs]]
* [[WMS:GSSHA Groundwater|GSSHA Groundwater]]
* [[WMS:GSSHA Maps|GSSHA Maps]]
* [[WMS:GSSHA Job Control|GSSHA Job Control]]
* [[WMS:GSSHA Model Linkage|GSSHA Model Linkage]]
* [[WMS:GSSHA Join SSURGO Data|GSSHA Join SSURGO Data]]
* [[WMS:GSSHA Mapping Tables|GSSHA Mapping Tables]]
* [[WMS:GSSHA Maps|GSSHA Maps]]
* [[WMS:GSSHA Multiple Scenarios|GSSHA Multiple Scenarios]]
* [[WMS:GSSHA Nutrients|GSSHA Nutrients]]
* [[WMS:GSSHA Overland Soil Erosion|GSSHA Overland Soil Erosion]]
* [[WMS:GSSHA Output Control|GSSHA Output Control]]
* [[WMS:GSSHA Precipitation|GSSHA Precipitation]]
* [[WMS:GSSHA Solution Analysis|GSSHA Solution Analysis]]


{{GSSHAMain
==References==
{{reflist}}


|PLinks=
* [http://gsshawiki.com/Overview:Overview Overview]
|GUMLinks=
* [http://gsshawiki.com/Introduction:Introduction Introduction]


}}
{{GSSHA Wiki}}
{{WMSMain}}


[[Category:GSSHA|G]]
[[Category:GSSHA|G]]
[[Category:GSSHA Dialogs|G]]
[[Category:GSSHA Dialogs|G]]
[[Category:External Links]]
[[Category:External Links]]
[[Category:Link to Store]]

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.