HEC-RAS 5.0.1 Release Notes
HEC-RAS 5.0.1 Release Notes
HEC-RAS 5.0.1 Release Notes
Release Notes
Version 5.0.1
April 2016
Approved for Public Release Distribution Unlimited
Introduction
Version 5.0.1 of the River Analysis System (HEC-RAS) is now available. This
Version supersedes Version 5.0, and all previous versions. Several new
simulation features have been added to the software since that time. Version
5.0.1 of HEC-RAS includes the following new features:
1. Two-dimensional and combined 1D/2D Unsteady Flow Modeling
2. New HEC-RAS Mapper capabilities and enhancements
3. Automated Manning's n value calibration for 1D unsteady Flow
4. Simplified Physical Breaching algorithm for Dam and Levees
5. Breach Width and development time calculator
6. New Hydraulic outlet features for Inline Structures
7. Sediment Transport Modeling Enhancements: Including unsteady flow
sediment transport analyses; Reservoir flushing and sluicing; as well
as channel stability using BSTEM integrated within HEC-RAS
8. Completely new 2D User's manual
9. Several new example applications within the Applications Guide
10. Updates User's Manual, Hydraulic Reference manual, Applications
Guide, and Help System
Other minor enhancements were also added. The development team has also
continued careful and systematic testing of the software since the last
release. The results of that testing in combination with reports from users has
allowed the identification and repair of various problems. Some minor
problems that did not affect results but caused problems in the software
interface have been repaired without being specifically documented.
Installation
The installation program and all documentation are available on the HEC
website at http://www.hec.usace.army.mil . This new release is installed
independently of any previous versions of the program. Users may have the
new version and previous versions of HEC-RAS software installed
simultaneously for parallel use or testing. This new version is fully compatible
with projects developed in any previous version of the program. However,
once a project has been opened in Version 5.0.1 and saved, it may not be
possible to open it with an older version of the software and reproduce the old
results.
The new installation package is designed to be easy to use. It will take you
through the steps of selecting a directory for the program files and making
other settings. Use the following steps to install the program on the Microsoft
Windows operating system:
1. Download the installation package from the HEC website to a
temporary folder on the computer.
2. Run the installation program. In Windows Explorer, double-click
the icon for the installation program. You must have administrator
privileges to run the installer.
3. Follow the on-screen prompts to install the program.
New Capabilities
Two-dimensional and combined 1D/2D Unsteady Flow
Modeling
HEC has added the ability to perform two-dimensional (2D) hydrodynamic
routing within the unsteady flow analysis portion of HEC-RAS. Users can now
perform one-dimensional (1D) unsteady-flow modeling, two-dimensional (2D)
unsteady-flow modeling (Saint Venant equations or Diffusion Wave
equations), as well as combined 1D and 2D unsteady-flow routing. The 2D
flow areas in HEC-RAS can be used in number of ways. The following are
examples of how the 2D flow areas can be used to support modeling with
HEC-RAS:
zone until the maximum flow zone error is less than a user entered tolerance,
or until a maximum number of iterations is reached.
For details on how to use the new Automated Mannings n value calibration
feature, please review Chapter 16 of the Users Manual.
For details on the new Inline structure outlet options in HEC-RAS, please
review the section on Inline Structures in Chapter 6 of the Users Manual.
Problems Repaired
The following is a list of bugs that were found in version 5.0 and fixed for
version 5.0.1:
1. Unsteady Flow with Pumps: A pumping station that is connected
"From" a storage area had a bug that could generate an "access
violation" error.
2. Unsteady flow with rating curves at structures: The rating
curves for: inline structure outlet rating curve, lateral structure outlet
rating curve, and user defined gate rating curves (both inline and
lateral) have been changed so that unsteady will no longer extrapolate
past the top or bottom of the curve. A warning will be generated the
first time this happens.
3. Unsteady flow with an SA/2D Hydraulic Conn between two 2D
areas: There was a bug when a SA/2D connector has a 2D area on
the upstream side. This bug would sometimes show up as an "access
violation" error.
4. Steady Flow Analysis (Encroachments at Bridges): There was a
bug when type 1 encroachments were specified immediately adjacent
to a bridge opening. The encroachment was being set to the opening.
The left encroachment was set to the left side of the bridge opening
and the right encroachment was being set to the right edge of the
opening.
5. Unsteady flow with 2D areas/Internal Hydraulic connector: For
a hydraulic connector inside of a 2D area, the DSS output for
headwater and tailwater had a bug. The reported values were "one
cell" away from the intended values. For a connection that was
entirely inside of a single cell, this resulted in a reported water surface
of "0.0". This was only a reporting issue.
6. 1D Velocity plotting in HEC-RAS Mapper for metric data sets:
1D HEC-RAS Mapper maximum velocity plot was wrong for SI data
sets.
7. Unsteady flow Lateral Structure connected to a 2D flow area:
For a lateral structure connected between a 1D river and a 2D area,
the lateral structure was pulling the water out of the river at the wrong
cross section location. The flow was being removed from the 1D river
upstream of the location it should have been removing it from.
8. User Interface Right Bank of Main channel: If you had a cross
section with a vertical wall at the right bank of the main channel, the
interface was displaying the main channel bank station at the bottom
of the vertical wall. The computations were correct, this was just a
visual problem in the interface.
The following is a list of bugs that were found in version 4.1 and fixed for
version 5.0:
1. Unsteady (user defined gate curves): User defined gate curves for
storage area connections were not working.
2. Unsteady Flow Post processing (pump): If a pump group had
more than one pump that was on, only the flow from one pump was
being summed. So the total flow of the pump group was wrong as
was the total flow of the pump station. This bug did not affect the
unsteady flow pump computations nor the pump DSS output.
3. Steady flow (bridges/cross sections with lids): For the internal
bridge cross sections (or other cross sections with lids), if there was
more than one Manning's n value in the channel, the program was not
correctly compositing the channel Manning's n value. For bridges, this
would only affect the answers using the energy method (the other
methods, such as pressure/weir were not affected).
4. Unsteady Flow Post processing: The inline structure output was not
showing the breach flow and breach velocity. This has been fixed.
5. Steady flow (bridge/WSPRO): The WSPRO method uses its own
methodology to compute the friction/expansion loss between the exit
cross section and the cross section immediately downstream/outside of
the bridge. This computation was not correct and tended to slightly
over predict the energy losses.
6. Steady flow (bridge/WSPRO): For the WSPRO bridge method, the
energy downstream of the bridge was not being correctly outputted.
(The WSPRO method recomputes the downstream water surface. The
displayed/outputted energy did not reflect the recomputed water
surface.)
7. Unsteady Flow Post processing (overflow gate): For lateral
structures, the flow through an overflow gate was not always being
output.
8. SI Sediment Volume Bug: HEC-RAS 4.1 did not convert sediment
mass into volume correctly in SI units, generally under predicting
deposition volume substantially.
9. Wilcock Transport Function: HEC-RAS 4.1 included a bug in the
Wilcock transport function that generally caused it to substantially
under predict transport.
10
21. Unsteady flow (roughness factors): The flow roughness factor and
the seasonal roughness factor associated with geometric data had a
bug that caused them to be applied to the wrong range of cross
sections. This bug did not affect the roughness factors that were
entered as part of the Plan data, only those entered in the geometric
editor.
22. Unsteady flow (Modpuls/Hydrologic routing): Having both
multiple Modpuls regions and lateral inflows in the same reach was
causing a bug that was screwing up the lateral inflows.
23. Unsteady flow (Navigation Dams): For navigation dams, the
starting gate open was being set to the minimum which usually caused
a very high starting water surface behind the dam. The gate setting is
now being determined based on the target water surface.
24. Unsteady flow (Advanced Rules): If an advanced rule operation
had been used to set a desired flow (for a given gate group) and then
a later rule operation set a specific gate opening height (for that gate
group) the program was continuing to use the desired flow operation
instead of overwriting it with the designated gate opening height.
25. Steady flow (culvert): For a steep culvert, where the flow at the
inlet starts out supercritical (and the inlet is not submerged) but the
flow has a hydraulic jump (and the outlet is submerged) the program
was using the outlet answer (and reporting outlet control) when it
should have been using the inlet control answer.
26. Steady flow (culvert): For a steep culvert, where the outlet is
submerged and the original, subcritical outlet answer, shows that the
inlet is not submerged, but the inlet answer shows a submerged inlet
and "drowned" hydraulic jump, the program was not reporting the
correct, full flowing outlet answer.
27. Unsteady flow (hydraulic curves): For the hydraulic bridge curves
and hydraulic rating curves, the program was sometimes incorrectly
reporting a, "extrapolated above rating curves" when in fact it had not
had to extrapolate.
28. Sediment (Long Cum Mass Change): minor bug when erosion
punched through the cover layer and eroded down into the surface
layer during a single computation increment.
29. All (rating curve/bridges): If a cross section immediately upstream
of a bridge has a rating curve, it was causing the program to crash.
30. Sediment (overbank deposition): Material that was being
deposited in the overbank, outside of the moveable limit, was not
being removed from the sediment going to the next cross section. It
was being double accounted.
31. Sediment (dredging/cumulative out): The longitudinal cumulative
mass output was not correctly including dredged output. Output bug
only.
32. Sediment (Exner7): the Exner7 bed mixing option had several bugs.
11
12
13
55. Unsteady (pump rules): For the advanced pump rules (these are
the rules specific to pumps, not the general Advanced Rules), there
was a bug if a day of month was entered as a single digit. For
example, "1Jan2012" would not work, but "01Jan2012" was ok.
56. Sediment (Concentration): The sediment concentration output was
wrong. This has been fixed.
57. Unsteady (navigation dam): The option to use both hinge control
and pool control was sometimes not working.
58. Steady and Geometric PreProcess (bridges/cuverts): Cross sections
with ineffective flow areas can have multiple critical depths. The
program was sometimes not using the best answer. The most likely
situation that this bug would show up is for the unsteady flow
preprocess internal boundary curves where the curve suddenly "shot
up" for no apparent reason.
59. Unsteady (IB Stage/Flow at Inline Structure with elev
controlled gates): When using the IB Stage/Flow option at an inline
structure to force a known stage or known flow, the program will now
operate the gates in order to match the gate opening to the forced
stage or flow. When the user entered IB Stage/Flow "runs out", the
program will revert to "normal" gate flow for the inline structure. For
the case where the inline structure is using elevation controlled gates
(as opposed to time series gates), the gate openings should match the
flow condition when the IB runs out.
60. Preprocess/Unsteady (HTAB points): The number of allowable
points in the cross section lookup tables has been increased to 500.
61. Converting bridge to cross sections with lids is no longer
supported. This option was causing stability problems in some
unsteady flow models. We felt that computing the bridge curves was a
much better option.
62. Unsteady (Inline culvert flag gates): For culverts in an inline
structure, the positive flap gate option was not working correctly.
63. Unsteady/steady (lateral structure crossing bridge): A lateral
structure that crossed a bridge showed flow leaving the river between
the bridge sections when in fact flow was not being removed from the
river. No lateral structure flow is removed between the bridge sections
and the output now reflects this.
64. Unsteady (culvert/encroachments): For unsteady flow,
encroachments adjacent to culverts were not working correctly causing
the internal boundary curves to be incorrect.
65. Unsteady flow (ungaged area computations): If the preprocessor
was run by itself, and then unsteady was run by itself, and that
unsteady plan had ungaged areas, the ungaged option may not work
correctly.
14
69. Unsteady flow (IB Stage/flow): The internal boundary flow (IB
stage/flow hydrograph) option was not using the user specified flow
during the initial backwater.
70. Unsteady flow (SA to SA connector): The interpolation
methodology was changed from a horizontal to a vertical method.
71. Unsteady flow (Htab): A bug in how the curves transitioned from
open flow to pressure flow. (Subroutine HBS_LIM3)
72. Unsteady flow (Lateral Structure): The user specified cross
section intersections did not work for some data sets.
73. Unsteady flow (SA connector with culvert): There was a bug for
when the invert of a culvert was higher than the low point in the weir.
74. Unsteady flow (DSS hydrograph output): Monthly DSS
hydrograph output was not being output correctly to DSS.
15
Support Policy
Technical support for program users within the Corps of Engineers is provided
through an annual subscription service. Subscribing offices can expect full
support from HEC staff in the routine application of the program. Users are
strongly urged to consult with HEC staff on the technical feasibility of using
the program before beginning a project with unique requirements. Extended
support for large or complex projects can be arranged under a separate
reimbursable project agreement.
Reporting of suspected program errors is unrestricted and we will reply to all
correspondence concerning such errors. We are continuously working to
improve the program and possible bugs should always be reported. Reports
should include a written description of the steps that lead to the problem and
the effects that result from it. If we cannot reproduce the reported problem,
we may ask you to send a copy of your project.
Report program errors through the following channels:
Write to:
U.S. Army Corps of Engineers
Hydrologic Engineering Center
609 Second Street
Davis, CA 95616 USA.
16