If you are experiencing a problem with HEC-RAS, please submit the following information via email to hec.ras@usace.army.mil.

  1. Contact Information: Name, Phone Number, and E-mail Address.
  2. What version of the software are you using?
  3. What operating system are you using?
  4. A detailed explanation of the problem (e.g., "Levee option on Cross Section editor not functioning correctly").
  5. If the problem is reproducible, please list the steps required to re-create the problem (e.g., "1. Create a new file. 2. Insert some text ...).
  6. If the problem is not reproducible (only happened once, or occasionally for no apparent reason) please describe the circumstances in which it occurred and the symptoms observed (Note: it is much harder to fix non-reproducible bugs).
  7. If the problem causes any error messages to appear, please write down the exact text displayed, or capture it from the screen and paste into the email.
  8. If you have an HEC-RAS data set that demonstrates the problem, use the HEC-RAS "Debug Report" option to zip up the data set. Then attach the zip file to the email. The "Debug Report" option is under the "File" menu on the main HEC-RAS window. If the data set is too large for an email attachment, then you will need to send it by some form of ftp server, Google Drive, or some other file sharing capability. If you are using the two-dimensional modeling capabilities, we will also need the HEC-RAS terrain model files (*.tif, *.hdf, and *.vrt).

Sometimes a graphical representation of the bug helps out. A good example is shown below.