Gridded Surface Subsurface Hydrologic Analysis

From Gsshawiki
Revision as of 15:15, 7 September 2023 by Aabyrd (talk | contribs)

Jump to: navigation, search

Welcome to the GSSHA™ Wiki!

The GSSHA™ Wiki is the best source for up to date information on the GSSHA™ model. In the last few years many new features have been added to the GSSHA™ model. Many of these features were developed or released after the publication of the primer and manual. One of the main purposes of the GSSHA™ Wiki is to keep the documentation up to date with the model development.

If you are an experienced GSSHA™ user you may still find some model features missing from the site. Currently we are on release version 7.13, which is now available as a LINUX version. Earlier versions of the model are also no longer supported and are thus not recommended. Version 7.13 is supported by WMS 11.1 and 10.1 and WMS 11.1 or 10.1 is recommended for use with this version.

As many users may be aware, support of features in WMS typically lags behind development of GSSHA™. This is necessary in that we must settle on final GSSHA™ inputs and outputs before we ask them to be added to WMS. While we strongly encourage GSSHA™ users to use WMS for pre and post processing, users should be aware that many GSSHA™ models, especially GSSHA™ models with advanced features, must be at least partially developed outside of WMS. In addition to WMS, we have developed several utilities to assist in the development of GSSHA™ inputs. These utilities are linked to this site as well. The documents provided here describe the actual inputs to the GSSHA™ model and should be consulted when there are questions about inputs, whether developed from WMS or by other means. When in doubt, refer to Users Manual section on this wiki, which contains the most up to date information on model inputs.

GSSHA™ is developed and maintained by the US Army Engineer Research and Development Center (ERDC) Hydrologic Modeling Branch, in the Coastal and Hydraulics Laboratory, see:

If you are not familiar with GSSHA™ see the overview tab on the top left hand side of your screen to get a feel for what GSSHA™ is and what applications it might be appropriate for.

A one page information sheet is available here * GSSHA™ Information Sheet.

The GSSHA storyboard can be found here: * GSSHA storyboard

For more information about the GSSHA™ model, it's formulation, and it's applicability, contact me at

For more information about WMS and using WMS to construct a GSSHA™ model and visualize results, contact Aquaveo at:*

As of the year 2013, GSSHA has been approved by FEMA for hydrologic modeling, and has been added to the list of approved models on the FEMA site *

FY 2023 Training

We have scheduled a "Watershed Engineering with Nature (EWN) Design Workshop With WMS and GSSHA™" September 6-7, 2023 in Norman Oklahoma. We are partnering with the University of Oklahoma. This course is sponsored by the USACE H&H Set and EWN programs and hosted by the University of Oklahoma Norman. The course is offered free of charge to all USACE and DoD personnel. The course may be attended by others with permission of the lead course instructor. Access to the physical course may be restricted. The course will be physically conducted at the National Weather Center at University of Oklahoma, Norman. For more information please contact Dr. Aaron Byrd at

Class Information and Agenda

Hotels in Norman, OK


GSSHA™ FEMA Certification

GSSHA™ is now FEMA certified for National Flood Insurance Program studies! For more information see the FEMA NFIP Currently Accepted National Hydrologic Models

GSSHA™ Training Course Information

GSSHA™ Training courses are occasionally offered through the USACE and through Aquaveo. These courses are very interesting and fun and are normally offered once a year. Course attendees leave these courses with the information they need to build any type of GSSHA™ model that fits their needs and with a comprehensive understanding of the GSSHA™ model. Click here for updated information about the next GSSHA™ training course.

GSSHA™ Software Primer

This document is a primer for use of the Watershed Modeling System (WMS) interface with the physically based, distributed-parameter hydrologic model Gridded Surface Subsurface Hydrologic Analysis (GSSHA™). The primary purpose of this primer is to describe how the WMS interface is used to develop inputs and analyze output from the GSSHA™ model. This primer also provides a brief description of the GSSHA™ model, including the overall model formulation, processes that can be simulated, and input formats for files not supported by WMS.

GSSHA™ User's Manual

This document is the detailed user manual for GSSHA™. The last printed version is available here: *GSSHA Manual. Be aware the the printed version has not been updated since 2006 and that many features in the model have changed. Updates to the Manual are done on the wiki, which has the latest information on GSSHA™ features and file formats.

GSSHA™ Tutorials

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.

Download the latest GSSHA™ tutorials and data files here

GSSHA™ Park City June 2008 training tutorials and data files (ZIP file, 65.4 MB)

Download the latest version of WMS, the Time Series Editor (for use with GSSHA), and related files here (this includes the GSSHA installation)

Download tutorials and videos describing how to use WMS here

2021 Workshop on Using GSSHA with PEST

PEST is often used to calibrate GSSHA models. Here are the workshop files.

GSSHA™ PEST 2021 Training Files (PEST Homepage)

2022 Workshop on Using GSSHA™ for Combined Coastal Storms

GSSHA™ can be used for combined coastal storms (intense rainfall + storm surge). Here are the workshop files:

2023 Watershed Engineering with Nature (EWN) Design Workshop With WMS and GSSHA™

Utility Programs


Obtaining Data

This section gives sample values for many of the parameters used in GSSHA™.

GSSHA™ Bibliography

Reports or papers where GSSHA™ was used.

Test Cases

Example projects: 10x10 Simulations, Project Simulations.

Wiki Editing Guidelines

Guidelines on how to edit this Wiki

GSSHA™ Download

Current release and research versions of the code can be downloaded here along with tutorial data.