WMS:GSSHA: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
Line 68: Line 68:
[[Category:GSSHA|G]]
[[Category:GSSHA|G]]
[[Category:WMS Dialogs|G]]
[[Category:WMS Dialogs|G]]
[[Category:External Links]]

Revision as of 18:39, 29 October 2014

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.

A detailed online reference manual for GSSHA is found here:

http://www.gsshawiki.com

Open Project File

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.

Model Check

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.

Run Simulation

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:

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

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.

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

For long term simulations WMS copies the HMET file from its original location to the new GSSHA project directory.

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.

Cell Properties

The 2D grid cell properties include an , 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 Window and can be edited in the Properties Window. The , 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