Using 

Output for Evaluation, 
Troubleshooting, and Calibration

Copyright © 2021 Kleinschmidt Associates
This lecture includes some material produced by the Hydrologic Engineering Center in 
Davis, CA. 

1
Overview
• How do we visualize/analyze RAS results in RAS Mapper?
• How do we compare different plans?
• Troubleshooting/Debugging 
• Calibration

2
 Results Mapping
• Dynamic Mapping – on‐the‐fly mapping
• Animation of results without waiting

• Stored Maps – results written to file

* = There was a problem reading data

Visualizing results is best done in RAS Mapper using either dynamic or stored maps. 

3
 Results Mapping

Map Type    |    Profile/Parameter    |    Mode

Default maps: Depth, Water Surface Elevation, Velocity
4

You can add many different map types to RAS Mapper depending on the type of analysis 
you are doing. The default maps that are created automatically with each completed 
simulation are depth, WSE, and velocity. 

4
Example Maps

•Depth •Velocity

5
Arrival Time

6
Hazard Mapping
D*V or D*V2

7
Inundation Boundary

8
 Results Layer Properties

You can change the scaling of each map type added to RAS Mapper depending on how you 
want to view the results. This is most handy when trying to identify “hot spots” of velocity 
or other results, or if you have specific criteria your project has to meet. For instance for 
many fish passage projects there are minimum depth and maximum velocity criteria that 
must be met in order for the project to be approved. 

9
Map Types – Dynamic vs Stored
• Dynamic: Computed on‐the‐fly
• Smooth: Computes to screen‐resolution
• Doesn’t use disk space
• Stored: Computed to terrain resolution
• Stored to disk
• Faster rendering for slow map types

10

10
Dynamic vs Stored Results
• Dynamic results plot values for the current pyramid level. 
Boundaries are defined based on interpolation.
• Stored results have a single value per cell.

11

11
Dynamic Mapping
• Animation Toolbar – works on active layer

12

12
Dynamic Mapping ‐ Animation

13

13
Stored Maps
• Map status message on 
cursor tool tip

Right‐slick options:
• Edit Map Parameters

• Compute Map

14

14
Render Mode Options

15

15
Results Interpolation
• Render mode options allow for interpolation of water surface 
elevation values or plotting values at the cell center.

16

16
Horizontal vs Sloping Surface

17

17
Sloping Surface Mapping Issues

18

18
Hydraulic Connectivity
• Hydraulic connectivity from mesh

19

19
Questions?
What we Covered
• Mapping Results
• Type
• Location
• Display

• Dynamic vs Stored

• Layer Properties

• Render Mode

• Hydraulic Connectivity

20

20
Poll Question #1

21

21
Results Query
• 2D Flow Area query

22

22
2D Flow Area Queries
• Hydraulic Properties

• Time Series

23

23
Velocity Results

24

24
Velocity Arrows

25

25
Velocity Tracing

26

26
Velocity Tracing ‐ Animation

27

27
Profile Lines – User Defined
• Sample map values along a line
• Compare multiple results
• Animate
• Utilized for Calibration

28

28
Water Surface and Terrain

29

29
Profile Line ‐ Comparison
• Turn on multiple result maps
• Highlight ‘Results’ node
• Choose a Profile (i.e. ‘Max’)
• Choose Plots | Map Type (from Map or on Profile Line)

30

30
Profile Lines ‐ Comparison

31

31
Profile Lines ‐ Animating

32

32
 Section Lines ‐ Animating

33

Section Lines are drawn transverse to the flow lines.  These are useful for visualizing water 
surface elevation and plotting flow hydrographs.  

33
Profile Lines ‐ Velocity

34

34
Questions?

What we Covered
• Result Query

• Velocity Results
• Arrows
• Tracing
• Connection

• Using Profile Lines to Analyze 
Results
• Animations

35

35
 Troubleshooting
• Dynamic Maps

• Profile Lines

• SA/2D Connections

• 1D Elements
• Structures
• Cross Sections
• Profile Plots

36

There are a number of ways to troubleshoot a HEC‐RAS 1D/2D model using both 1D and 2D 
output. 

36
Dynamic Maps and Profile Lines
• High Courant Number

• Cell Connectivity

• Time Series Plots

• Pulsing

37

37
Dynamic Maps and Profile Lines

38

38
SA/2D Connections
• Check Stage and Flow Hydrographs of SA/2D Connections for:

• Unstable water headwater/tailwater elevations

• Unrealistic changes in flow

• Positive to negative flow swings

39

39
 SA/2D Connections
Example:
• Head water and tailwater are virtually the same
• Sharp changes in flow and positive/negative flow swings
• 100% of flow is through culvert (no weir flow)
• Likely a highly submerged connection

40

• Head water and tailwater are virtually the same
• Sharp changes in  flow and positive/negative flow swings
• Likely a highly submerged connection

40
 SA/2D Connections
Solution:
• Larger Cells
• Smaller timesteps
• Increase Manning’s roughness through culvert
• Add a flap gate 
• Increase Stability Factors and Decay Exponents

41

• Head water and tailwater are virtually the same
• Sharp changes in  flow and positive/negative flow swings
• Likely a highly submerged connection

41
1D Model Elements 
• Profile Plot

• Cross Section Plot

• Energy Grade Line

• Critical Depth

• Summary Tables

42

42
Troubleshooting Tips
• Start simple.  Add model elements incrementally.
• Courant Numbers
• Is your Computation Interval too high?
• Use the Courant Number Map
• Remember:  HEC‐RAS  likes changes to happen gradually.  Look for 
ways to lessen significant changes.
• Smaller Cells
• Smaller Computation Intervals
• Higher Manning’s n Values
• Sudden drop in terrain?  Consider using a Structure. 
• Dampening techniques
• Mixed Flow LPI Factor (1D)
• Increase Stability Factors and Decay Exponents
• Initial Conditions Problems?
• Initial Conditions Time
• Warm‐up Time

43

43
Troubleshooting Resources
• The Manuals! 

• “Common Model Stability Problems in Unsteady Flow” 
– Gary Brunner, Presentation

• The RAS Solution
• Oct 8, 2013 post: “My Unsteady HEC‐RAS 
Model is Unstable…Why?”

• Full Momentum Vodcast

• HEC‐RAS User’s Groups
• Facebook
• LinkedIn

44

44
2D Model Calibration

• Sources of Calibration Data

• Calibration Methods

45

45
Sources of Calibration Data 

• Surveyed High Water Marks
• Aerial Imagery
• Stream Gage Data 
• Flow
• Stage
• Local Witnesses/Authorities

46

46
High Water Marks

47

47
High Water Marks

48

48
Aerial Imagery 

49

49
Aerial Imagery 

50

50
Aerial Imagery 

51

51
Aerial Imagery 

52

52
Stream Gage Data

• 1D Approach To 2D Calibration
• Match Stage and Flow Data at Specific Profile 
Lines/Structures

53

53
Poll Question #2 and #3

54

54
Questions?

55

55