Tuesday, July 17, 2018

HEC-RAS Primer for New Users

Written by Chris Goodell  |  Kleinschmidt Associates
Copyright © The RAS Solution 2018.  All rights reserved

Are you a new HEC-RAS user?  Or maybe you've used HEC-RAS before, but it's been a while.  Maybe you have no idea where to start.  Steady or Unsteady?  1D or 2D?  Subcritical or Supercritical?

OK, for all you Newbies out there, I'm going to walk you through some steps to take to get you up and running with your first HEC-RAS model.  
1.    Take a HEC-RAS Training Course.  There is no better and faster way to get the knowledge you need to start right in on a HEC-RAS model than to attend an in-person HEC-RAS training course. 

If you are brand new, start with a Basic 1D Steady Flow HEC-RAS Course.  There are several of these types of courses out there.  Some may be close to where you live, but be prepared to have to travel-and spend some money.  You can Google “HEC-RAS Training” and find a bunch of options.  Here are a few regular offerings that I can recommend:
·         ASCE Continuing Education.   Typically only available in the US, and expensive.  But the quality is top notch.  Click the link to see where classes are currently scheduled. 
·         National Highway Institute.  Only available in the US.  Courses are not always offered, and when they are you’ll have to get on a waiting list, unless you work for the Federal Highway Administration
·         Hydrologic Engineering Center.  Expensive and priority given to U.S. Government Employees.  Non-government employees can sign up, but only if space is available.  Also, courses are held in Davis, California.  But hey, these are the folks that develop the software, so if you can get in, take it!
You may also hear from time to time about a HEC-RAS course hosted by a local professional organization or government agency.  Keep your eyes and ears open for these.  One option near me is River Restoration Northwest, which hosts HEC-RAS classes in the Northwest USA every couple of years. 
Aside from pre-scheduled courses, you can always bring an instructor to you.  This only pencils out if you have multiple folks that you need to train.  Usually 6 to 10 and the price per student drops below the pre-scheduled courses.  I am able to provide this training as can my friend and colleague Krey Price, who is located in Western Australia.  WEST Consultants is also able to provide custom course training. 
2.    Read the HEC-RAS Manuals.  Please please please read through the HEC-RAS manuals before you try to do any HEC-RAS modeling.  Don’t take my polite use of the word “please” three times as a suggestion.  Think of it as the First Commandment of HEC-RAS Modeling.  I guarantee that if you adopt the strategy of “When all else fails, read the manual”, you will end up wasting a lot of your time. 
At the very least read through the HEC-RAS User’s Manual.   All of the HEC-RAS manuals are very well written, easy to follow, and packed with information.  They come with the installation of HEC-RAS, but if you don’t have them, you can get them from the HEC website.  HEC offers the following manuals for HEC-RAS:
·         User’s Manual.  Start here.  At the very least, read through this manual before any HEC-RAS modeling.
·         Hydraulic Reference Manual.  As the name implies, a good reference resource.  This is where I go to learn about the “guts” of HEC-RAS…the theory behind it.  And to see what’s happening under the hood.  You do not need to read this cover to cover to get a HEC-RAS model running, but it’s good to check in for certain features in HEC-RAS that you’d like to know more about-specifically the theory and computational schemes behind the feature. 
·         Applications Guide.  A fantastic collection of example data sets with instructions on how to set them up. 
·         Two-Dimensional Modeling User’s Manual.  Definitely read this if you plan on doing any 2D modeling. 
·         5.0 Supplemental User’s Manual.  Good to read if you want to learn about the new features in Version 5.0.  Especially give this a read if you wish to take advantage of the new RAS Mapper preprocessing editing tools. 
·         BSTEM Technical Reference & User’s Manual.  If you don’t know what BSTEM is, there is no need for you to read this manual.
3.    Example Projects and Applications Guide.  When you download HEC-RAS, you not only get the software, but you get all of the manuals listed above, plus some other useful documentation.  You also have the option to download a larger install package that contains the Example Data Sets.  DO THIS!!!  These example data sets are invaluable.  As you can see in the figure below, the example projects are organized into 5 folders after you download them and unzip them to your computer.  Notice the fourth folder called “Applications Guide”.  These are all of the HEC-RAS projects documented in the Applications Guide manual.  If you want to do some self-training, there is no better way than to go through each of these Application Guide Examples one by one.  In fact, I highly recommend going through at least a handful of them before taking a training course.
The Applications Guide is designed to provide example projects for you to work through alongside instructions for a wide variety of HEC-RAS applications.  In fact, the manual has examples that cover just about every kind of geometric element you may want to use, including bridges, culverts, dams, lateral structures, storage areas, junctions, etc.  Unfortunately, the current Applications Guide does not have any 2D examples, but there are 2D examples in the HEC-RAS Example Data Sets. 

4.     Online Resources.  Since you’re reading this, you’ve already found The RAS Solution, the best online resource for all things HEC-RAS.  With over 200 posts about HEC-RAS, you are bound to find the information you are looking for (for example…this post 😊).  There is a search bar near the top of The RAS Solution, where you can enter in some key words to help you find articles on topics you are interested in.  The RAS Solution also has a very widely used forum, where you can ask questions, but also give back to the HEC-RAS community by posting answers.
There are a number of social media sites out there dedicated to HEC-RAS.  These are great ways to not only get the latest information about HEC-RAS (e.g. upcoming courses, new version releases), but also to post questions about HEC-RAS.
https://www.facebook.com/TheRASSolution.  This is the Facebook site for The RAS Solution.  When a new post goes up on The RAS Solution, a link to it goes on this site. 

https://www.facebook.com/groups/90473474105/.  This is an all-purpose HEC-RAS User’s site on Facebook.  With nearly 2000 members, there is a lot of interaction on this site.  Great place to pose questions and get answers. 
https://www.facebook.com/groups/571614272961250/.  For my HEC-RAS friends from Italy, this is an Italian language HEC-RAS help site run by my friend and colleague Antonio Cotroneo. 
https://www.facebook.com/groups/906806026048714/.  This is a Brazilian HEC-RAS site that generally caters to our Portuguese-speaking friends.  This site is administered by my friend and colleague Pedro Sydorak.
https://www.linkedin.com/groups/7065494.  This is the LinkedIn site for The RAS Solution.  When a new post goes up on The RAS Solution, a link to it goes on this site. 
https://www.linkedin.com/groups/1908568.  This LinkedIn site has over 5000 members.  A lot of great RAS modelers participate on this site.  Unfortunately the administrator of this site doesn’t participate and so it tends to get a lot of spam and advertisements, and the “About” section is about 10 years out of date.  Still, there are some pretty good discussions on here with lots of participation.   
https://twitter.com/RASModel.  This is my twitter feed.  I post links to all of The RAS Solution posts up here as well as other useful HEC-RAS information.  I also occasionally post about some of my favorite sports teams. 

Wednesday, June 13, 2018

HEC-RAS 5.0.5 has been released!

HEC has released a new version of HEC-RAS called version 5.0.5 today.  This version is a bug fix only version (i.e. No new features).  Unfortunately in version 5.0.4 there was a bug in which User defined Manning's n value override regions for 2D Flow Areas (called "2D Area Manning's n Regions"), define in the Geometry editor, were not being applied to the 2D Faces.  So user's would be unaware that they were not getting modified Manning's n values for these override regions.  As this is a bad computational error, anyone that was using Manning's n override regions defined in the Geometry editor, should rerun their models with this new release of HEC-RAS 5.0.5.  

In addition to that bug, several other minor bugs were also fixed.  Please review the Version 5.0.5 Release Notes to see all of the bugs that were fixed for this release.

Monday, May 14, 2018

Closing the wormhole with the new features in HEC-RAS 5.0.4!

Written by Krey Price  |  Surface Water Solutions
Copyright © The RAS Solution 2018.  All rights reserved

The Great Hobbiton Flood

For those who have used wormhole culverts or mega-cell culverts in previous versions of HEC-RAS, you'll be relieved to hear that they have officially been retired with the May 2 release of the new Version 5.0.4.

It sounds like the new features are already getting lots of use, and online and face-to-face training courses are popping up all over the world. Given the surge in interest, we thought we'd post a quick overview of the new features and compare some model results between versions. We've found, for example, that the new coordinate-based culvert features in Version 5.0.4 give identical results to wormhole culverts in Version 5.0.3, with both methods drawing flow from the 2D cells that cover the actual inlet location:

[Left-click to play, then right-click on the video to loop the particle tracing - a handy trick to keep file sizes small while providing a continuous animation in a presentation!]

This article highlights the new culvert capabilities along with the following features, each of which is also covered in an accompanying instructional video here:
  • Culverts. We’ll see how the new culvert editor gets rid of the need for wormhole culverts (RIP!) by allowing the inlet and outlet of each barrel to be defined by its own set of coordinates.
  • Mesh Polygons. We’ll then add a “Refinement Region” to a 2D Flow Area using the new RAS Mapper tool that allows you to assign customized computational grid spacing with polygon features.
  • Internal Boundary Conditions. Next we’ll add inflow hydrographs inside of the 2D Flow Area as internal boundary conditions.
  • Adjustable Time Steps. We’ll set Courant Number criteria to allow variable time steps to be selected based on computed velocities.
  • Rating Curves. We’ll then run the model and generate rating curves in a single step (rather than having to extract flow and stage time series hydrographs separately and combine them in Excel).
  • Speed Enhancements. Finally we’ll compare run times to see how the speed improvements stack up.
This demonstration model uses terrain data covering the Hobbit movie set in New Zealand. You can download the terrain for free if you want to follow along (instructions for setting up the project with saved views and static aerial imagery are available here.)

If a HEC-RAS model contained wormhole culverts in Version 5.0.3, they will be ignored when the project is opened in Version 5.0.4, so we’ll need to convert any wormhole culverts to “coordi-culverts”, with coordinates assigned to each barrel’s inlet and outlet either manually or with a great new feature to import culvert centerlines from a shape file:

Here’s the schematic plan view for four culvert methods available in Version 5.0.4, with the new “coordivert” in our demonstration model shown in the canal on the far right:
A description of each method is included here. (A fifth method, entering the bridge piers or culvert walls as 2D terrain only, wasn't included here since it is only appropriate for open channel flow.)

Mesh Polygons
To take advantage of the new capability to define a finer mesh within a polygon, we'll use a "Refinement Region" in RAS Mapper. After delineating a polygon under the refinement regions layer, the next step is to right-click on the shape and select “Edit Refinement Region Properties” and enter a cell spacing (in this case 1 meter by 1 meter):
With the higher resolution area defined, if you zoom in on the refinement region, you’ll see a more detailed computational mesh inside the 2D Flow Area:
In this case, I've defined a tighter mesh spacing around the roadway and culvert and left a lower-resolution mesh in the open channel areas. This feature can save a substantial amount of computation time and prevents the need to create multiple 2D areas to reflect varying resolution requirements – or the menial task of creating an excessive number of snaking breaklines with red-dot errors that need fixing!
Internal Boundary Conditions
In Version 5.0.4, BC lines can now be entered as internal boundary conditions inside the 2D Flow Area. Keep in mind that flow will be able to travel in both directions from an internal BC Line, and any BC line in 5.0.3 that crossed the external boundary of the 2D Flow Area will need to be edited to be either all in or all out. At this point flow can only be positive (can’t subtract flow to represent infiltration or a stormwater pit) but with Version 5.0.4 there isn’t any need to use the wormhole culvert hack to move flow around your 2D area anymore. To test it out, we’ve moved the BC lines inside of the upstream boundary, and the model behaved just fine:

Adjustable Time Step
The window with the new option to use the Courant Number criterion is shown below. With the adjusted time step selected, the model will increase or decrease the computational time step automatically based on the computed velocity. This can give you significant speed improvements if you were already conservative with your time step. If you had an unstable model, however, the use of this feature will slow it down as it slices the time step to stabilize it. In this case, our 0.5-second time step can be doubled four times or halved four times, giving it a potential range from 0.03 to 8 seconds:

Rating Curves
One last feature we’ll illustrate is the ability to plot rating curves directly along any saved profile line with a single command. Just right-click on your saved profile line name and select “Rating Curve” as a new option under Time Series (but watch out for the potential pitfalls mentioned in the article here!). Here’s where to find the rating curve function in RAS Mapper:

Speed Comparison
Using the same grid size and time step, this particular model runs twice as fast in 5.0.4 as it did in Version 5.0.3. Taking advantage of the refinement areas and variable time steps, it runs even faster - in less than a quarter of the 5.0.3 time without any significant loss of accuracy. We’ve seen similar speed enhancements with our other models as well.
Comparing results
In this particular demonstration model, the water surface elevation profile results in 5.0.4 look nearly identical to the results from 5.0.3. Here is the particle tracing with the coordi-culvert in 5.0.4 shown at the right-hand side of the image. This one matches the particle tracing in Version 5.0.3 using a wormhole culvert in place of the coordi-vert:
Here are the water surface profiles comparing the coordi-culvert to the wormhole culvert for open channel flow, pressure flow, and overtopping flow conditions:
As you can see, in the vicinity of the culvert, the results are effectively identical for all three flow conditions, which brings us to the bottom line: the wormhole has closed with the release of Version 5.0.4, and wormhole culverts have officially been retired – not just for long culverts, but for internal boundary conditions as well. Mega-cell culverts have also become obsolete now. From what we’ve seen so far, the new culverts provide equivalent results with much more functionality - particularly the fact that they work perfectly fine with the roadway/bridge deck represented as terrain or removed from the terrain and replaced with a weir embankment - so good riddance to both the worms and the Cells Of Unusual Size!
And finally just for fun, let’s ramp up the flow and see if an Orc-dam can flood out Hobbiton; if you want to see how the Hobbits fare in the flood, further details, animations, and comparisons of the new features are available here, or feel free to follow along with the instructional videos covering each of these new features separately.

In this case, our particle tracing shows that this one may catch Frodo in a whirlpool - and suck him right through the Orc-pipe that we can now move anywhere in our model thanks to the new coordiverts in Version 5.0.4!
[Again, right-click to loop]

We'd love to have you join us in an upcoming comprehensive training course, but in the meantime, we hope this has been a helpful overview of some of the new features in 5.0.4! We look forward to hearing how you are using the new features in your own projects.
Krey Price
Surface Water Solutions

Monday, May 7, 2018

6th HEC-RAS Water Modelling 1D+2D Course in Sydney, Australia

If you're in the neighborhood, or just want a nice trip to Australia, consider taking this excellent course in 1D/2D Modelling using HEC-RAS the week of 4 June, 2018, hosted by ICEWaRM and the Australian Water School.  This will be a great opportunity to get some training on the new features just introduced in the recently released version 5.0.4. 

Click here for more information and to register.

Latest version! Hydrologic Engineering Centres-River Analysis System (HEC-RAS)

HEC-RAS is recognised globally as an industry standard hydraulic modelling program and is available for use without charge. Using the latest version, these courses cover basic, intermediate and advanced levels across both 1D and 2D, and gives you access to select HEC-RAS experts who are BETA testers and work in the industry.

You can choose from 3 options in this HEC-RAS training:
2-day (Mon-Tues) 1D only
3-day (Wed-Fri) 2D only
5-day (Mon-Fri) 1D + 2D
Note: The 2D course assumes a basic understanding of 1D.

HEC-RAS 5.0.4 contains many key new features for editing both 1D and 2D data sets, much faster computations, the new 64 bit RAS Mapper can handle much larger terrain data sets and there are improvements to the solution for some settings. HEC GEO-RAS and other third party utilities are no longer needed to create 1D model elements! Come learn these new HEC-RAS features in this combined 1D and 2D training opportunity.
Date: Monday, 4 June, 2018 - Friday, 8 June, 2018
Location: SYDNEY: Novotel Sydney on Darling Harbour

Contact: Trevor Pillar: tpillar@icewarm.com.au

Saturday, May 5, 2018

Important follow-up on 5.0.4

If anyone downloaded and installed HEC-RAS 5.0.4 before Friday May 4th at 4:00 PM pacific daylight time, please re-download and install the software.  There were some minor mistakes found in the original 5.0.4 release.

Please click here to find the download links for all of the updates:


Thursday, May 3, 2018

HEC-RAS 5.0.4 is released!

Message from HEC on the new release of HEC-RAS version 5.0.4.  Make sure to also check on the new Verification/Validation and the Benchmarking documents. 

***Note.  If you originally downloaded 5.0.4 before May 4 at 4:00 pm PDT then please redownload and install from the links below.  There were some minor errors found in the original release.

Download HEC-RAS Version 5.0.4 here:

Download RD-52  HEC-RAS Verification and Validation Tests document here: 

Download RD-51 Benchmarking of the HEC-RAS Two-Dimensional Hydraulic Modeling Capabilities here:

There are several other new useful documents related to HEC-RAS here:

From HEC:
We have released the final version of HEC-RAS 5.0.4 today.  It is now available for download from our webpage at the link below.  I have enclosed the 5.0.4 release notes for your review.  I have also included a separate document that describes how to use the new features contained in this version. Additionally  I have also included a document on how to spec out a computer for doing 2D modeling with HEC-RAS.

            We hope you enjoy the new version of the software.  As always, please keep us informed on any bugs you find, or your ideas for new features.  Here is the link to the HEC-RAS 5.0.4 web page:

            The following is a list of the major new features you can read about in the Release Notes and the Supplemental User’s Manual:

  1. New RAS Mapper Pre-Processor Tools
  2. Variable Time Step Capabilities (improved accuracy and faster run times)
  3. Increased Computational Speed for 2D Computations (2 to 5 times faster run times)
  4. Enhancements to SA/2D Hydraulic Connections
  5. New 2D Polygon Mesh Refinement Tool
  6. Internal Boundary Condition Lines for 2D Areas
  7. New Velocity Term for 2D Flow Area Boundary Conditions
  8. 64–bit Version of RAS Mapper and 64-bit 2D Pre-Processor (RAS now can handle much larger 2D models)
  9. Improved Terrain Generation Utility
  10. Improved Manning’s n Layer Development
  11. Sediment – New Options in the User Defined Grain Class Editor
  12. Sediment – New Transport Function Calibration Options

WARNING: Some of the bug fixes “may” cause the computed results from 5.0.3 to 5.0.4 to change.  Please read the Release Notes carefully for information about these changes.

There are two new verification and validation documents for HEC-RAS now available on our web page in the HEC-RAS area.  Here is a short description of each:

  1. RD-52  HEC-RAS Verification and Validation Tests (Enclosed in this email)

            This is the first ever full blown Verification and Validation document for HEC-RAS.  In this report we compare HEC-RAS to: analytical and text book data sets; lab studies, and real world flood events with good observed data.  This report covers 1D steady flow; 1D unsteady flow, and 2D unsteady flow computations.  The report verifies that HEC-RAS correctly solves the equations used in each of these computational frameworks, and it verifies that HEC-RAS can be used for a very wide range of riverine modeling conditions.  It can aslo be download here:

  1. RD-51 Benchmarking of the HEC-RAS Two-Dimensional Hydraulic Modeling Capabilities

This research document summarizes how the Hydrologic Engineering Center's (HEC) River Analysis System (HEC-RAS) software performed in the two-dimensional (2D) modeling benchmark tests developed by the United Kingdom's (UK) Joint Defra (Department for Environmental Food and Rural Affairs) Environment Agency.  This is an updated version of this report that we previously developed.  We re-ran all of the test, plus one new test, with version 5.0.4 of HEC-RAS.  The results are even better than before, and the HEC-RAS computational speed is much faster than previously document.  This report can be downloaded from our web page at the following link:

Friday, March 30, 2018

Webinar: The HECRAS Controller, A Powerful Feature of HEC-RAS Exposed

I'll be giving a free webinar on the HECRAS Controller through the Australian Water School on April 18 at 7:00 PM (pacific daylight time) which is April 19 11:30 AM (local time in Adelaide, Australia). 


Unlock a multitude of custom applications for controlling and automating HEC-RAS

In this webinar, Chris explains the HECRASController, an application programming interface (API) that communicates with HEC-RAS, through a comprehensive library of programming procedures. You will gain an understanding of how to work with the HECRASController that are not otherwise available through the standard version of HEC-RAS. He also covers custom applications including an analysis example that allows the implementation of selected Australia Rainfall and Runoff (ARR2016) guidelines. As Chris is fond of saying, "if you can imagine it, it's likely you can do it with the HECRASController and a little programming skill".