Difference between revisions of "Gridded Surface Subsurface Hydrologic Analysis"

From Gsshawiki
Jump to: navigation, search
(GSSHA™ User's Manual)
(2024 Cold Regions Hydrology Design Workshop With WMS and GSSHA™)
 
(93 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Welcome to the GSSHA™ Wiki!==
 
==Welcome to the GSSHA™ Wiki!==
  
The GSSHA™ Wiki is the best source for up to date information on the GSSHA™ model.  In the last two to three 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.
+
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.  This site will cover only release versions of the code.  Currently we are on release version 5.1Release version 3.0b is supported by WMS 8.1, which can be downloaded below (under the Tutorials section on this page). Release version 5 is supported by WMS 8.2 and above. Currently we are using WMS 8.4, and thus reccommend to our users to use the same.
+
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.15Earlier versions of the model are also no longer supported and are thus not recommended. Version 7.15 is fully supported by WMS 11.2. WMS versions 10.1 and higher are 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.
 
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.
  
As of July 30, 2009 the sediment transport and stream routing sections of the manual has been updated to reflect the new formulations in the current modelAdditional information may be added to these sections. At this point, major updates to the manual are essentially completeThis site is frequently updated, so check back often for additional improvements, updates, and resources.
+
GSSHA™ is developed and maintained by the US Army Engineer Research and Development Center (ERDC) Hydrologic Systems Branch, in the Coastal and Hydraulics Laboratory, see:
 +
*http://chl.erdc.usace.army.mil/gssha
 +
 
 +
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 *[[media:GSSHA_IS.pdf| GSSHA™ Information Sheet]].   
 +
 
 +
The GSSHA storyboard can be found here: *[[media:GSSHA_storyboard.pdf| GSSHA storyboard]]
  
As of Jan 27, 2011 we released a new version, 5.7. Look for the executables for 32 and 64 bit installations on the download page. There have been some issues with Windows 7 usersWe are working to straighten out those issues.
+
For more information about the GSSHA™ model, it's formulation, and it's applicability, contact me at [mailto:charles.w.downer@usace.army.mil charles.w.downer@usace.army.mil].   
  
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:
+
For more information about WMS and using WMS to construct a GSSHA™ model and visualize results, contact Aquaveo at:*http://www.aquaveo.com/wms-learning.
*http://chl.erdc.usace.army.mil/gssha
 
  
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.  For more information about the GSSHA™ model, it's formulation, and it's applicability, contact me at [mailto:charles.w.downer@usace.army.mil charles.w.downer@usace.army.mil].  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 *http://www.fema.gov/national-flood-insurance-program-flood-hazard-mapping/hydrologic-models-meeting-minimum-requirement#1.
*http://xmswiki.com/wiki/WMS:WMS
 
  
Back to back basic and advanced GSSHA training was conducted in Omaha Nebraska, July 12-16.  These courses were conducted primarily for USACE and other DoD users.  See this announcement for details on the course subject matter. *[[media:GSSHA Course Announcement 2010.pdf| GSSHA Omaha Course Announcment]].  The updated tutorials from this course are available in the Tutorial Section below.  These tutorials were developed especially for WMS 8.4. 
+
== GSSHA DLL and BMI Support ==
  
There will be a one day Introductory Course, followed by a three day basic course in Vicksburg, MS, July 19-22. Details can be found here. [[media:GSSHA Course Announcement 2011_final.pdf|2011 Course Announcement]]
+
News on GSSHA version 8.0: We are finalizing the verification of the new code before we publish the new release version. One of the exciting new features of version 8.0 is that the code has been refactored into a library that allows programmatic access to the gssha simulation processes. Further, we have worked to include Basic Model Interface (BMI) support so that it can be a part of BMI-based modeling frameworks, such as NOAA's NextGen system. If you are interested in helping us test these new features, please contact me at [mailto:Aaron.R.Byrd2@usace.army.mil Aaron.R.Byrd2@usace.army.mil]. These new simulation interaction features will be experimentally released in 8.0 while we test and document them.
 
  
Chuck
+
-Aaron
  
  
  
For those of you in the Corps of Engineers, we now have a User's Community you can join in the new Knowledge Hub. Check it out! https://knowledge.usace.army.mil
+
__TOC__
  
Aaron
+
== [http://www.fema.gov/national-flood-insurance-program-flood-hazard-mapping/hydrologic-models-meeting-minimum-requirement GSSHA™ FEMA Certification] ==
  
 +
GSSHA™ is now FEMA certified for National Flood Insurance Program studies! For more information see the [http://www.fema.gov/national-flood-insurance-program-flood-hazard-mapping/hydrologic-models-meeting-minimum-requirement FEMA NFIP Currently Accepted National Hydrologic Models]
  
 +
==[[GSSHA Training|GSSHA™ Training Course Information]]==
  
__TOC__
+
''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. The next training course will be offered in September 2024. It will cover how to use GSSHA to model cold regions hydrology.  [[GSSHA Training|Click here]] for updated information about the next ''GSSHA™'' training course.
  
 
==[[GSSHA Software Primer|GSSHA™ Software Primer]]==
 
==[[GSSHA Software Primer|GSSHA™ Software Primer]]==
Line 40: Line 46:
 
==[[GSSHA User's Manual|GSSHA™ User's Manual]]==
 
==[[GSSHA User's Manual|GSSHA™ User's Manual]]==
  
This document is the detailed user manual for ''GSSHA™''.  The last printed version is available here:  *[[GSSHA Manaual:Manual]]
+
This document is the detailed user manual for ''GSSHA™''.  The last printed version is available here:  *[http://wmsdocs.aquaveo.com/gssha_manual_erdc.pdf 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.
  
 
==[[Tutorials:Tutorials|GSSHA™ Tutorials]]==
 
==[[Tutorials:Tutorials|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.
 
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™ Training, Omaha, NE, 2010 -- Tutorials and data files]]
+
[http://www.aquaveo.com/software/wms-learning-tutorials Download the latest GSSHA™ tutorials and data files here]
  
[http://wms.aquaveo.com/GSSHAwiki_tutorial_data.zip GSSHA™ tutorial data files (download these data files to use in the tutorials accessed from the link above, ZIP file)]
+
[http://wmstutorials.aquaveo.com/Park_City_Tutorials.zip GSSHA™ Park City June 2008 training tutorials and data files (ZIP file, 65.4 MB)]
  
[http://wmstutorials.aquaveo.com/Park_City_Tutorials.zip GSSHA™ Park City June 2008 training tutorials and data files (ZIP file, 65.4 MB)]
+
[http://www.aquaveo.com/downloads?tab=3#TabbedPanels Download the latest version of WMS, the Time Series Editor (for use with GSSHA), and related files here (this includes the GSSHA installation)]
 +
 
 +
[http://www.aquaveo.com/wms-learning 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.
 +
 
 +
[[Media:GSSHA_PEST_Tutorial_2021.zip|GSSHA™ PEST 2021 Training Files]] ([https://pesthomepage.org/ 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:
 +
 
 +
* [[media:gssha_course_announcement_flood.pdf|GSSHA™ Flood Simulation Course Announcement and Agenda]]
 +
* [[media:BasicMaterials.zip| Basic Materials]]
 +
* Day 1 [[media:TutorialsDay1.zip|tutorials]] and [[media:PresentationsPDFs_day1.zip|presentations]]
 +
* Day 2 [[media:TutorialsDay2.zip|tutorials]] and [[media:PresentationsPDFs_day2.zip|presentations]]
 +
* Required data for the course can be found here:  http://www.aquaveo.com/software/wms-learning-tutorials
  
[http://wmstutorials.aquaveo.com/Tutor81_Vol_VI.pdf GSSHA™ and HMS MODClark tutorials distributed with WMS (volume 6, PDF file, 2.5 MB)]
+
=== 2023 Watershed Engineering with Nature (EWN) Design Workshop With WMS and GSSHA™ ===
 +
* [[Media:WMS_GSSHA_EWN.pdf | Class Information and Agenda]]
 +
* Day 1 [[media:GSSHAWMSEWNDay1PresentationPDFs_day1.zip|presentations]]
 +
* Day 2 [[media:SedimentTutorials_Sep2023.zip|Updated Sediment Tutorial]], [[media:RiverCaneTutorial.zip|River Cane Tutorial]], [[media:ParkCityBDAWetlands.zip|Example Beaver Dam Analog and Wetlands Model]] and [[media:GSSHAWMSEWNDay2PresentationPDFs_day2.zip|presentations]]
 +
* Required data for the course can be found here:  http://www.aquaveo.com/software/wms-learning-tutorials
  
[http://www.aquaveo.com/f.php5?s=wms&v=8.3&p=full WMS 8.3-full download (installation EXE file, 600 MB)]
+
=== 2024 Cold Regions Hydrology Design Workshop With WMS and GSSHA™ ===
 +
* [[media:2024_Cold_Regions_Watershed_Modeling.pdf| Class Information and Agenda]]
 +
* [[media:CRH2024_AllPresentations.zip | Class Presentations]]
 +
* Class Tutorials and Demo Files
 +
** [https://www.aquaveo.com/software/wms-learning-tutorials WMS Learning Center] (Go to Distributed Hydrology -> Snowmelt Modeling in GSSHA)
 +
** [[media:FrozenGround.zip | Frozen Ground Spreadsheet]]
 +
** [[media:WMS-GSSHA-permafrost_tutorial_v1.1.zip | Permafrost Tutorial]]
  
[http://www.aquaveo.com/f.php5?s=wms&v=8.3&p=update WMS 8.3-software update only (installation EXE file, 65 MB)]
+
== [[GSSHA Video Tutorials|GSSHA™ Video Tutorials]] ==
 +
We have begun recording the training courses and turning them into individual tutorial lessons.  
  
 
==[[Utility_Programs:Main|Utility Programs]]==
 
==[[Utility_Programs:Main|Utility Programs]]==
Line 68: Line 101:
 
|  
 
|  
 
*[[Utility_Programs:Format_HMET Spreadsheet|Format_HMET]]
 
*[[Utility_Programs:Format_HMET Spreadsheet|Format_HMET]]
 +
| width="50px" |  
 
|}
 
|}
  

Latest revision as of 20:52, 25 September 2024

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.15. Earlier versions of the model are also no longer supported and are thus not recommended. Version 7.15 is fully supported by WMS 11.2. WMS versions 10.1 and higher are 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 Systems 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 charles.w.downer@usace.army.mil.

For more information about WMS and using WMS to construct a GSSHA™ model and visualize results, contact Aquaveo at:*http://www.aquaveo.com/wms-learning.

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 *http://www.fema.gov/national-flood-insurance-program-flood-hazard-mapping/hydrologic-models-meeting-minimum-requirement#1.

GSSHA DLL and BMI Support

News on GSSHA version 8.0: We are finalizing the verification of the new code before we publish the new release version. One of the exciting new features of version 8.0 is that the code has been refactored into a library that allows programmatic access to the gssha simulation processes. Further, we have worked to include Basic Model Interface (BMI) support so that it can be a part of BMI-based modeling frameworks, such as NOAA's NextGen system. If you are interested in helping us test these new features, please contact me at Aaron.R.Byrd2@usace.army.mil. These new simulation interaction features will be experimentally released in 8.0 while we test and document them.

-Aaron


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. The next training course will be offered in September 2024. It will cover how to use GSSHA to model cold regions hydrology. 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™

2024 Cold Regions Hydrology Design Workshop With WMS and GSSHA™

GSSHA™ Video Tutorials

We have begun recording the training courses and turning them into individual tutorial lessons.

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.

Disclaimer