Model Construction:Running GSSHA

From Gsshawiki
Jump to: navigation, search

GSSHA can be executed from WMS, or from the command line, once all of the necessary data to run a GSSHA simulation have been defined and a project file saved. The project file, which specifies all parameters, mapping files, and other input and output files, is the only direct input required to run GSSHA.

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.

Running GSSHA from WMS

GSSHA can be executed from WMS, or from the command line, once all of the necessary data to run a GSSHA simulation have been defined and a project file saved. The project file, which specifies all parameters, mapping files, and other input and output files, is the only direct input required to run GSSHA.

Running GSSHA from command line

GSSHA can also be run from the command line using the project file as the sole command-line argument. For example, from a command prompt window you would type:

gssha simulate.prj

where simulate.prj is the name of the project file saved from WMS and resides in the same directory as GSSHA.exe. You may also use the Start -> Run command from Windows. If the project file is not in the same directory as GSSHA.exe, you must enter the full path name to the project file (i.e., C:\mysimulations\simulate.prj) in order for GSSHA to run successfully. Often it is best to copy the GSSHA.exe file to the directory where the project has been saved.

Project file

The project file definition is made up of a series of cards followed by parameter(s) (usually a file name) related to that card. For example, the watershed mask is defined on a single line using the card WATERSHED_MASK followed by the name of the file containing the watershed mask. The project file informs GSSHA which simulation options (e.g., overland flow, infiltration, long-term, etc.) to perform along with all of the necessary parameters required for the desired options. An example project file is shown below:

GSSHAPROJECT 
WMS 7.0 
WATERSHED_MASK			bear2.msk 
FLINE				bear2.map 
METRIC 
GRIDSIZE			30.000000 
ROWS				61 
COLS				76 
TOT_TIME			480 
TIMESTEP			5 
OUTROW				41 
OUTCOL				74 
OUTSLOPE			0.001000 
MAP_FREQ			360 
HYD_FREQ			180 
MAP_TYPE			2 
CHAN_EXPLIC 

SED_POROSITY			0.400000 
ELEVATION			bear2.ele 
DEPTH				bear2.dep 
CHANNEL_INPUT			bear2.cip 
LINKS				bear2.lks 
NODES				bear2.nod 
DIS_PROFILE			bear2.qpf 
WAT_SURF_PROFILE		bear2.wpf 
OVERTYPE			ADE 
GREEN_AMPT 

MAPPING_TABLE			bear2.cmt 
MATERIALS			bear2.mat 
SUMMARY				bear2.sum 
OUTLET_HYDRO			bear2.hyd 
OUTLET_SED_FLUX			bear2.sed 
PRECIP_UNIF 

RAIN_INTENSITY			20.000000 
RAIN_DURATION			120 
START_DATE			1994 1 1 
START_TIME			12 0  

For a complete description of all the cards and their related parameter(s), see the GSSHA User’s Manual (Downer and Ogden in preparation).

Related Topics

GSSHA Wiki Main Page
Primer Main Page

Model Construction
Global parameters
Total time
Time-step
Outlet information
Units
Defining a uniform precipitation event
Describing overland flow
Overland flow routing options
Verifying the basic model
Editing the grid to correct elevation errors
Determining an appropriate time-step
Running GSSHA