Model Construction:Running GSSHA
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
