HEC-RAS Version 5.0 Comments, Suggestions, and Bug Reports

Hi HEC-RAS users.  HEC is extremely busy dealing with bugs and questions at the moment.  They’re currently working mostly to fulfill their obligations for technical support to the Corps of Engineers only.  If you are trying out the new version 5.0 beta, and you discover a bug, or if you simply have a comment or suggestion, please post them to The RAS Solution Forum.  I’ve agreed to collect, filter, and screen bug reports and comments and periodically send to HEC.  You can get to the forum and two new sub-forums: “HEC-RAS Version 5.0 Bugs”, and “HEC-RAS Version 5.0 Suggestions/Comments”, by following this link or by clinking the “The RAS Solution Forum” button up above. 
http://hecrasmodel.blogspot.com/p/hec-ras-bloggery-forum.html

Please post in the appropriate folder and keep the comments civil and constructive.  If you have a bug report, please post in the “bugs” folder and include as much information as is practical, but still keep it as brief as possible.  If you discover a “work-around” in the meantime, please included that as well. 

Also, don’t forget to get the latest version of HEC-RAS 5.0 beta here:
http://hecrasmodel.blogspot.com/2014/10/updated-hec-ras-version-50-beta-now.html

Thanks-
Chris G.
@RASModel

Update to HEC-RAS 5.0 Beta

Hey 5.0 Beta users.  Please get a new copy of HEC-RAS 5.0 Beta.  It has some of the early problems already fixed.  See below for instructions and have fun.  Please read everything below before you download.

NOTE!!! Latest October 2014 beta version is available here:  http://hecrasmodel.blogspot.com/2014/10/updated-hec-ras-version-50-beta-now.html


Dear HEC-RAS 5.0 Beta (with 2D) tester,      You are receiving the this email, and a link to an updated version of "HEC-RAS 5.0.0 June 6, 2014 Beta (with 2D Flow Areas)", because you are either a previous Beta tester, or you have expressed interest in the new 2-Dimensional modeling capabilities being added to HEC-RAS.  A few problems were found over the last two weeks with the first 5.0 Beta release (May 23, 2014), so we fixed those problems and created a new Setup package.  If you already installed the previous 5.0 Beta, please Install this version and use it instead.  Here is the link to the latest version: http://www.hec.usace.army.mil/misc/files/ras/HEC-RAS_5.0_Beta_2014-06-06.exe     

This link lets you download a self extracting archive file called "HEC-RAS_5.0_Beta_2014-06-06.exe"  Download the file to a separate directory and run the self extracting archive file.  The self extracting archive file contains:
         
1. The installation setup package called: " HEC-RAS_5.0_Beta_2014-06-06_Setup.exe"                
2. An updated PDF version of the User's Manual called "Combine 1D and 2D Modeling with HEC-RAS.pdf"  Here is a separate Link to the new 1D/2D User’s manual, if you want to download it separately: http://www.hec.usace.army.mil/misc/files/ras/Combined_1D_and_2D_Modeling_with_HEC-RAS.pdf           
3. Two 2D Test Data sets in a directory called "RAS_50 Test Data"     

This installation setup package is password protected.  The password to run the setup package is: "ras4you!"     

This version of HEC-RAS has many new features.  I have enclosed a PDF File called "What’s New in HEC-RAS 50 Beta.pdf", that describes most of the new features. The main new features are the following:

1.         2D Only Computations (no 1D elements) and Multiple 2D areas in the same model
2.         Several New Ways to Link 2D Flow Areas to 1D Elements
3.         Hydraulic Structures Inside of 2D Flow Areas
4.         Improved Computational Speed for 2D and 1D
5.         New HEC-RAS Mapper Features and Output Capabilities           
6.         New Computational Options for 2D and 1D           
7.         Improved Speed and Memory Usage of the 2D Pre-Processor
8.         Additional 2D Flow Area Initial Conditions Options
9.         New Sediment bank erosion capabilities (USDA-ARS Bank Stability and Toe Erosion Model             (BSTEM))
10.       Unsteady Flow Sediment Transport Modeling (please Contact Stanford Gibson at HEC for                   updated Sediment documentation)

IMPORTANT NOTE:  We have changed the file format for how we store Terrain data in HEC-RAS.  To use this version of HEC-RAS, you will need to redo the development of your Terrain model for use in RAS Mapper and 2D modeling.  You will also have to rerun your model to see mapping output.  Please See Section II of the enclosed User’s Manual for building Terrain models in HEC-RAS.  Previously we were using our own file format called the “Tiled Mapping System” (*tms).  We have switched to using the GeoTiff file format (*.tif).  The GeoTiff files are tiled, pyramided, and compressed, just like our own format was.  So it has all the same benefits of the TMS files.  However, GeoTiff is a standard file format, which you can drag and drop into ArcGIS, or other software.  So for compatibility with other industry standard software, we have changed how we make and store terrain data.  We have also switched all of our output grids to the GeoTiff format to make it easier for user’s to get the results into a GIS or other piece of software.     

I provided a link to the updated version of the User's Manual on how to use the 2D modeling capabilities within HEC-RAS 5.0 Beta ("Combined 1D and 2D Modeling with HEC-RAS.pdf".  This document has been dramatically expanded.  If you really want to learn how to use the 2D modeling capabilities in HEC-RAS, Please Read This Manual.  I have spent a lot of time working on this document, and I think anyone who currently knows how to use HEC-RAS for 1D unsteady flow modeling will be able to learn how to use the new 2D unsteady flow modeling capabilities with just the software and this document.  Please give me some feedback on this User’s manual if you find mistakes or there is information you feel is missing, or could be explained better.           

There are two example data sets that come with the self extracting zip file: “Muncie.prj” and “BaldEagleDamBrk.prj”.  The Muncie data set is a 1D river with a 2D Flow Area inside of a Levee system.  The levee system is breached and flow goes into the protected area.  The BaldEagleDamBrk data set has seven different Plans in it.  This data set has examples of all the different ways to use 2D areas.  The purpose of this data set is just to demonstrate all the different Ways 2D areas can be linked to 1D elements, as well as modified computational mesh examples, and hydraulic structures inside of a 2D Flow Area.           

Our Plan is to have approximately a four month Beta test period, then release the Final HEC-RAS 5.0 version this fall at the end of the calendar year.  During this time we hope to get feedback from Users on bugs, interface issues, usability, missing features, documentation, etc…  So, we need you to test this version of the software and provide us feedback.  Please send all comments to hec.ras@usace.army.mil      Thank you for testing HEC-RAS, we look forward to your comments and feedback. Gary W. Brunner, P.E., D.WRE, M.ASCE Senior Technical Hydraulic Engineer Hydrologic Engineering Center. USACE  www.hec.usace.army.mil

International Settings

Written by Christopher Goodell, P.E., D.WRE  |  WEST Consultants
Copyright © The RAS Solution 2014.  All rights reserved.

 

To my international HEC-RAS user friends.  It’s time again to remind everyone that you need to have your Region and Language Windows settings set to English (United States), particularly if you are running unsteady HEC-RAS models.  If you live somewhere other than the USA, and you get an error message relating to the “time” data, or “date” inputs, it’s a good bet that you need to change your region and language settings.

HEC-RAS Version 5.0 beta Issue with HDF5 Viewer

Written by Christopher Goodell, P.E., D.WRE  |  WEST Consultants
Copyright © The RAS Solution 2014.  All rights reserved.

 

A few testers have discovered a dll conflict when trying to open the new 5.0 beta version of HEC-RAS.  The following message appears:

This happens if you’ve installed the HDF5 Viewer as described in the new “Combined 1D and 2D Modeling with HEC-RAS” document on page 115. 

HDF5 is a new file format used by HEC-RAS to store 2D output as well as some 1D output (in addition to the standard output files and dss files).  The HDF5 file contains more output information than is currently available in the HEC-RAS graphics and tables, such as velocity information for cell faces and face points.  The HDF5 Viewer is currently the only way for users to access the 2D velocity output. 

The issue is resolved by uninstalling the HDF5 Viewer.  HEC will be posting an updated install soon that corrects this problem. 

Tuesday Tip of the Week–Open Last Project on Startup

Written by Christopher Goodell, P.E., D.WRE  |  WEST Consultants
Copyright © The RAS Solution 2014.  All rights reserved.



Alright, this won’t wow everyone.  It might even induce a few yawns.  But I’m surprised how few people know this option, or if they do know it, use it.  I’m talking about the HEC-RAS option to open the last project on startup.  This little nugget is found under Options…Program Setup in the main HEC-RAS window. 





Check this box and every time you open HEC-RAS, it will automatically open the last project you were working on.  This can save you a lot of mouse clicks, especially if your project is buried deep within your computer’s directory structure. 
One of the first things I do once I’ve installed a new version of HEC-RAS (i.e. Version 5.0 beta, which was just released Friday!) is check the “Open last project on startup” box. 

HEC-RAS 5.0 beta with 2D modeling is out!

***Note-this post was for the old 5.0 beta version.  Please get the latest version here:  http://hecrasmodel.blogspot.com/2014/10/updated-hec-ras-version-50-beta-now.html


Hey RAS Modelers-The long awaited HEC-RAS Version 5.0 with 2D Modeling is finally out in beta form!  Please read the message below from Gary Brunner that provides instructions for downloading and installing HEC-RAS 5.0 beta.   Please note that there is a required password to install, "ras4you!"  Have fun with it and please provide constructive comments/suggestions to HEC.  As you'll read below, there will be an aggressive testing period of only 4 months, so give this version a try as soon as possible and let HEC know if you run into any bugs. 


I've also uploaded the "What's New" document and the updated "Combined 1D and 2D Modeling" document to my The RAS Solution Google Drive Site:


https://drive.google.com/file/d/0B_s8OLJOgOi0OTlwbjNYSGd4SFE/edit?usp=sharing
https://drive.google.com/file/d/0B_s8OLJOgOi0Nm5sdHFhSzFUYkk/edit?usp=sharing




Chris G.

Dear HEC-RAS 5.0 Beta (with 2D) tester,

     You are receiving the this email, and a link to an updated version of "HEC-RAS 5.0.0 May 2014 Beta (with 2D Flow Areas)", because you are either a previous Beta tester, or you have expressed interest in the new 2-Dimensional modeling capabilities being added to HEC-RAS.  Here is the link to the latest version:

      http://www.hec.usace.army.mil/misc/files/ras/HEC-RAS_5.0_Beta_2014-05-23.exe

      This link lets you download a self extracting Archive file called "HEC-RAS_5.0_Beta_2014-05-23.exe" 

      Download the file to a separate directory and run the self extracting zip file.  The self extracting zip file contains:

            1). The installation setup package called: " HEC-RAS_5.0_Beta_2014-05-23_Setup.exe"

            2). A updated PDF version of the User's Manual called "Combine 1D and 2D Modeling with HEC-RAS.pdf"

            3). Two 2D Test Data sets in a directory called "RAS_50 Test Data"

      This installation setup package is password protected.  The password to run the setup package is: "ras4you!"

      This version of HEC-RAS has many new features.  I have enclosed a Word Document called "Whats New in HEC-RAS 50 Beta.docx", that describes most of the new features.

Here is a link to the User’s manual:

            http://www.hec.usace.army.mil/misc/files/ras/Combined_1D_and_2D_Modeling_with_HEC-RAS.pdf

The main new features are the following:

            1.         2D Only Computations (no 1D elements) and Multiple 2D areas in the same model

            2.         Several New Ways to Link 2D Flow Areas to 1D Elements

            3.         Hydraulic Structures Inside of 2D Flow Areas

            4.         Improved Computational Speed for 2D and 1D

            5.         New HEC-RAS Mapper Features and Output Capabilities

            6.         New Computational Options for 2D and 1D

            7.         Improved Speed and Memory Usage of the 2D Pre-Processor

            8.         Additional 2D Flow Area Initial Conditions Options

     9.   New Sediment bank erosion capabilities (USDA-ARS Bank Stability and Toe Erosion Model (BSTEM))

10.       Unsteady Flow Sediment Transport Modeling (please Contact Stanford Gibson at HEC for updated Sediment documentation)

            IMPORTANT NOTE:  We have changed the file format for how we store Terrain data in HEC-RAS.  To use this version of HEC-RAS, you will need to redo the development of your Terrain model for use in RAS Mapper and 2D modeling.  You will also have to rerun your model to see mapping output.  Please See Section II of the enclosed User’s Manual for building Terrain models in HEC-RAS.  Previously we were using our own file format called the “Tiled Mapping System” (*tms).  We have switched to using the GeoTiff file format (*.tif).  The GeoTiff files are tiled, pyramided, and compressed, just like our own format was.  So it has all the same benefits of the TMS files.  However, GeoTiff is a standard file format, which you can drag and drop into ArcGIS, or other software.  So for compatibility with other industry standard software, we have changed how we make and store terrain data.  We have also switched all of our output grids to the GeoTiff format to make it easier for user’s to get the results into a GIS or other piece of software.

      I have enclosed an updated version of the User's Manual on how to use the 2D modeling capabilities within HEC-RAS 5.0 Beta ("Combine 1D and 2D Modeling with HEC-RAS.pdf".  This document has been dramatically expanded.  If you really want to learn how to use the 2D modeling capabilities in HEC-RAS, Please Read This Manual.  I have spent a lot of time working on this document, and I think anyone who currently knows how to use HEC-RAS for 1D unsteady flow modeling will be able to learn how to use the new 2D unsteady flow modeling capabilities with just the software and this document.  Please give me some feedback on this User’s manual if you find mistakes or there is information you feel is missing, or could be explained better.

            There are two example data sets that come with the self extracting zip file: “Muncie.prj” and “BaldEagleDamBrk.prj”.  The Muncie data set is a 1D river with a 2D Flow Area inside of a Levee system.  The levee system is breached and flow goes into the protected area.  The BaldEagleDamBrk data set has seven different Plans in it.  This data set has examples of all the different ways to use 2D areas.  The purpose of this data set is just to demonstrate all the different Ways 2D areas can be linked to 1D elements, as well as modified computational mesh examples, and hydraulic structures inside of a 2D Flow Area.

            Our Plan is to have approximately a four month Beta test period, then release the Final HEC-RAS 5.0 version this fall.  During this time we hope to get feedback from Users on bugs, interface issues, usability, missing features, documentation, etc…  So, we need you to test this version of the software and provide us feedback.  Please send all comments on this version to me through hec.ras@usace.army.mil.

      Thank you for testing HEC-RAS, we look forward to your comments and feedback. 

Gary W. Brunner, P.E., D.WRE, M.ASCE

Senior Technical Hydraulic Engineer

Hydrologic Engineering Center. USACE

www.hec.usace.army.mil

Exploring HEC-RAS: XS Interpolation Within a Reach

Written by Christopher Goodell, P.E., D.WRE  |  WEST Consultants

Copyright © The RAS Solution 2014.  All rights reserved.

I’m starting a new series called “Exploring HEC-RAS”.  Each post will discuss a feature in the menu items, starting with the Tools menu item in the Geometry Schematic.  Today’s topic is “XS Interpolation Within a Reach”.

There are two options for interpolating cross sections in HEC-RAS:  “Within a Reach…”, let’s call this Option A, and “Between 2 XS’s…”, Option B.  First, let’s briefly review why you may need to interpolate cross sections in HEC-RAS.  Cross Sections should be selected early on in your project to adequately define changes in geometry, roughness, bed slope, and discharge.  Also, cross sections are needed to properly define the expansion and contraction zones around bridges, culverts, and inline structures.  Additional cross sections are needed in areas of rapidly varying flow and/or significant grade breaks to avoid overestimation of energy loss (http://hecrasmodel.blogspot.com/2010/01/another-reason-for-interpolated-cross.html).  There’s also that pesky warning message that seems to always pop up:    

 

Each of these warning messages suggest that more cross sections will provide a better solution.  Finally, in unsteady flow modeling, there’s a relationship between cross section spacing, wave speed, and computational time step that minimizes errors and numerical instabilities (Courant Condition).  Interpolating cross sections is a quick and convenient way to satisfy this relationship. 

The first interpolation method, Option A, is called Interpolation “Within a Reach…”.  This is also called “blind” interpolation, because you cannot see nor control how HEC-RAS interpolates new cross sections.  They are interpolated based on the internal interpolation scheme, with no user interaction, except for entering a maximum spacing value.   This method is good for testing whether the spacing of cross sections will help produce a more numerically stable simulation.  You can choose to interpolate over an entire river/reach, or a segment of a reach, based on your selection of the Upstream River Station and Downstream River Station. 

Here you can see there’s a single input box for the Maximum Distance between XS’s.  RAS will then determine the number of interpolated cross sections necessary between each set of original cross sections so that the main channel reach lengths never exceed that maximum distance.  There are a couple of other options to be aware of in this window:  Cut Line GIS Coordinates allows you to control whether HEC-RAS interpolates the cut line coordinates of the original cross sections, or simply displays the interpolated cross sections as perpendicular segments along the reach centerline.  Whatever you select here will have no bearing on the computations, but will only change how the cross sections are displayed in the geometry schematic.  If you have a georeferenced project with adequate initial spacing, the first option should display the interpolated cross sections just fine.  However, if you have a very sinuous river and the original cross sections are spaced too coarsely, the interpolated cross sections may not follow the stream centerline very well, sometimes resulting in interpolated cross sections laying off center or completely away from the stream centerline (see below). 

In this case, to better display the layout of the interpolated cross sections, select the “Generate for display as perpendicular segments…” option.  This will lay the interpolated cross sections centered on their bank stations and perpendicular to the stream centerline.

Notice how the interpolated cross sections now follow the stream centerline.  However, be aware that these new interpolated cross sections are NOT georeferenced.  If you will be mapping your results on inundation maps, it would be better to cut new original cross sections around the bend section of the reach and use the “Linearly Interpolate cut lines…” option. 

The dropdown box “Decimal Places in interpolated Sta/Elev” simply directs HEC-RAS to how many decimal places to carry out the station elevation points for the interpolated cross sections.  The default is 2 and is generally left alone.  One case where you may want more precision in the decimal places is with extremely shallow reaches, where the resulting bed profile may look “stair stepped” due to rounding off of the channel invert point.  Adding more precision will help to smooth this out. 

A word of warning about Interpolation Option A, “Within a Reach…”.  The interpolated cross sections under this method are generated by built-in interpolation routines, that simply linearly interpolate station elevation points based on their proportional stationing within a subsection.  You have no control over the interpolation.  As such, it is very important that before you use these interpolated cross sections for your final RAS model, you verify that they accurately describe the geometry of the reach.  If important geometric features are not captured or are improperly defined, you’ll want to get real cross sections, or interpolate using Option B, “Between 2 XS’s”.  It is advised that blind interpolation (Option A) only be used to test the numerical adequacy of the cross section spacing.  More on Option B in the next post.  Stay tuned.