HEC RAS Mapper User's Manual Páginas 121 149
HEC RAS Mapper User's Manual Páginas 121 149
provided updating the user with the progress. Upon completion, the status label will change to
“Map files up to date”. There are also options on the dialog to Copy and Delete a results map.
The Manage Results Maps dialog is convenient for processing multiple stored maps.
The simple cursor reporting of values is a quick way to get an answer or two, but is reliant on the user
selecting the layer of interest and then moving the mouse. More efficient tools are available to
analyze the full scope of the HEC-RAS results using the Layer Watch List, Time Series Plots, and
Profile Plots.
When querying results Maps, an interpolated value is reported to the user. The interpolated
value may change based on the Render Mode and zoom level.
For computed model results (that are not interpolated), you can use the structure of the geometry to
query results. For 1D models, this means that the River, Cross Sections, and Storage Areas have
results that can be plotted. Select the layer, right-click on the feature and choose the Results Profile
Plot option of interest (WSE, Depth, Velocity) or a Results Time Series (Flow, Stage). For 2D models,
the 2D Mesh is allows you to select various time series plots for the cell or cell face (discussed in
detail, later). Below are an examples for different cross section plot options.
When querying model geometry for Results, such as cross sections or 2D cells, the value
computed by the computation engine is reported to the user.
list also allows you to Add and Delete layers to watch. If you would prefer, you can also pop the
window out and place it at any desired location.
As you move the mouse over the Map Window, values for the watch layers will be shown as the map
tip, without having to select the layer. In the example below, the Depth (D), Water Surface Elevation
(W), and Terrain (T) are being evaluated. The number of decimal places used to show the value is
controlled by the Display Output Decimal Places in the Global Settings | General options.
If the 2D Flow Area layer is enabled (turned on, you can see the mesh), as the mouse is moved over
the map, the selected cell will be highlighted. A right mouse click provide access to simulation
results (not interpolated) for the highlighted cell or cell face. Depending on the zoom level, the
mouse will snap to the cell or face (zoom in more to snap to cell center). These computation values
are what are used in the 2D hydraulic computations and are available under the Cell/Face Plot Time
Series menu option. Available options are listed below.
• Cell: Water Surface
• Fact Point: Velocity
• Face: Normal Velocity
• Face: Flow
• Face: Shear Stress
Not only will a right mouse-click provide access to simulation results, the user will also have access
to the pre-processed geometric data. The context menu will provide a Plot Property Table menu
item for several plot options.
• Cell: Volume-Elevation
• Face: Profile
• Face: Area-Elevation
• Face: Wetted Perimeter-Elevation
Profile Lines
River and Cross Sections lines allow you to plot 1D model results, simply by clicking on the feature.
However, user-defined Profile Lines allow you to create lines for 2D models in specific locations
where you would like to repetitively evaluate simulation results. The Profile Lines layer and is
located in the Features group so that the layer is drawn on top of all other features. Profile lines are
created using the RAS Mapper Editing tools. To create them, start editing the Profile Lines layer, and
create lines wherever you would like to extract information from a raster dataset. The orientation of
the profile lines with have zero-station at the start of the line and positive flow will be evaluated with
downstream (positive flow) established with the starting point on the left of the line.
Once a feature has been created, you will be prompted for new name for the Profile Line.
Profile lines are features just like any other in that they can be modified, moved, and deleted. You
can also interact with them when the Profile Lines layer is selected. To plot information along a
profile line, select the Profile Lines layer and select a feature from the Map. Alternatively, you can
select profile line from the Active Features list or the dedicated Profile Lines list. A right-click will
allow you to Plot Profile or Plot Time Series.
Plot Profile
Plot Profile will allow you to create a plot underneath the line for a single mapping time step. Plot
options are dictated by what Result layers are turned on in the Layer List (WSE, Depth, Velocity, etc.).
There are plot options to plot the map values with and without Terrain. The profile plots are also
linked to the animation tools, so you can move through the simulation window to evaluate results.
When animating, the profile line and map layer will update. As shown in the figure below, multiple
map layers of the same type can be plotted at the same time (so long as they are turned on). The
data behind the plots are available for inspection by clicking on the Table tab in the plot.
Another plot option when plotting velocities is to plot Velocity with Terrain.
It is also convenient to have an idea where you are along a line. One of the Profile Lines layer
plotting properties is the ability to turn on Stationing Tick Marks along the line. In the figure below,
a plot of velocities near a breach location are shown along with the stationing along the profile line
used to extract the velocity information.
10 RASTER CALCULATOR
There are several tools in RAS Mapper that allow the user to evaluate model results at specific
locations through interactive point querying and with profile lines. However, in order to perform
analysis of the entire layer, you can use the the RASter Calculator. The RASter Calculator allows you
to perform mathematical and logical operations on gridded datasets in RAS Mapper through user-
defined scripts. When using the RASter Calculator, the you are actually creating a syntax for a
Calculated Layer that can then be evaluated in RAS Mapper using the interactive querying tools
used for evaluating normal RAS Results. The Calculated Layer is intended to be treated very similarly
to a Dynamic Map, in that you can animate the layer. If you are using the calculated layer to compare
results from two different HEC-RAS simulations then it is quite convenient to use the animate
toolbar to evaluate various timesteps. However, a calculated layer can also have a static
component layer, such as the Terrain layer or using the value from a particular timestep in a result.
A Calculated Layer is added to RAS Mapper by selecting a RAS Result group or by selecting the Map
Layers group, right clicking and choosing the Create a New Calculated Layer menu item.
Overview
A Calculated Layer is created by defined the Layers you want to use in the analysis. By default, the
Terrain layers will always be available to the user. After defining the layers (think of them as
variables in an equation), you can then write simple code to perform and operation. The intent, is to
have example scripts provided with HEC-RAS, so that the user doesn't have to create a script. One
example script might be to compare water surface elevations from two different plans. The basic
steps to creating a calculated layer are listed below.
Begin with Tools | Create Calculated Layer menu item or right-click on a Plan and select
Create a New Calculated Layer.
1. Select an example Script or "User Defined" to write your own.
2. Add the Layers to be evaluated.
3. Add mathematical operations and logic calculation code.
4. Provide an output location to save the script.
5. Provide a Name for the Calculated layer.
6. Press the Create Layer button to add the layer to RAS Mapper.
Scripts
The RASter Calculator was developed to allow users to write complex scripts; however, HEC-RAS
provides example scripts to assist you in performing common calculations. Example scripts are
available from the Script list at the top of the calculator. Current examples include:
• Compare WSE - Allows the comparison of water surface profiles from two different plans. By default, the
script uses the first two Plans available in the RAS project.
• Depth * Velocity - Result is the multiplication of the Depth times the Velocity for the first plan in the RAS
Project. Using the Max profile is not appropriate as it multiplies the max depth and max velocity (which will
not have occurred at the same time).
• Hazard - This is an complex example of how to script to evaluated the product of depth and velocity given
rule criteria.
You can Load a script shared by another RAS user or Save a script once you have completed it.
Example scripts most likely will not be exactly what you need. To write or modify the code, you will
first need to add Layers or change what the represent.
Layer Variables
Layers are used as the "variables" for scripting. Tools are available to Add New, Delete, Rename,
and Edit. By default, Terrain layers are added as static layers that cannot be modified or removed.
Add - Use the Add button to add a Layer to be evaluated. When a layer is added, you must define
how the layer will be use. A layer variable is defined by its Name, Plan, Map Type, Animation
Behavior, and Profile.
Once a layer definition has been supplied, click the Add Variable button to add to the Layer list.
Press the Close button to dismiss the form.
Delete - Removes the selected Layer from the Layer list.
Rename - Allows you to rename the selected Layer variable.
Edit - Allows you to change the definition of a the selected layer variable.
Calculation Code
Scripts are written in a simple text editor using either Visual Basic or C#. You are only writing the
functional code (not the complete program). Once a script is complete, it will be compiled at
runtime when the Calculated Layer is evaluated. Example code is provided to assist users in
scripting. More complete help is available by clicking on the Help button.
To check to see if it will compile use the View Full Code button to compile the script, see the full
code, and check for any errors. Successful code compilation will result in a window message without
errors. If there are errors, the line number where an error occurred will be reported at the top of the
Code Compiler Check window.
Help
Help is available by clicking on the Help button. Help is provided for the coding in Visual Basic
logic and .Net Framework math functions. Additionally, example scripts are provided to
demonstrate the use of functional code. The example code can be copied and pasted into the
coding window, however, layer variables will have to be created to use the script. Examples of
available help are shown below.
Calculated Layer
Once a script is finished, specify a Folder location to store the map script (name.rasscript) and
provide a layer Name. The script will be saved to disk will be used to load the map each time RAS
Mapper is opened. Clicking the Create Layer button will then add the Calculated Layer to the Map.
If a script already exists on disk, you will be prompted for a unique name.
Once a Calculated Layer has been added to the Map, it will be treated like other layers. All the
fundamental map querying tools will be available to analyze the layer. If the layer variables were
added as a dynamic map type, the animation toolbar will allow for changing the profile.
Provided you have an inundation boundary polygon developed in HEC-RAS, you can export it either
to a KML file or to a 3D KML by simply right-clicking on the inundation boundary polygon and
selecting the Export Layer menu option.
KML Export
To create a KML, perform the following steps listed below.
1. Create and Inundation Boundary layer in RAS Mapper.
2. Right-click on the Inundation Boundary layer and choose the Export Layer | Save Features to KML menu
option.
3. Provide a filename and press OK.
4. The KML can then be added to a Google Earth instance (or likely you can double-click on the KML and it will
launch and load Google Earth).
Experience has shown, that KML files with more that 10,000 points do not render well in Google
Earth. Therefore, you may consider filtering the inundation boundary polygon, prior to KML
export.
3D KML Export
To create a 3D KML, perform the following steps listed below.
1. Create and Inundation Boundary layer in RAS Mapper.
2. Set the symbology to the color and transparency (blue, 50% are good values).
3. Right-click on the Inundation Boundary layer and choose the Export Layer | Save Inundation to 3D KML
menu option.
4. The 3D KML export dialog will be shown.
5. The default name and location of the KMZ file (zipped up KML) will be based on the Plan that produced the
inundation boundary. You can change the name and file location using the Browse button.
6. The default values for the output options are good suggestions. They are discussed in detail below.
7. Press OK to generate a KMZ file to use in Google Earth.
8. As the file is generated, a status message will inform you of the progress. The number of polygons that are
processed for the entire file extent is shown and the maximum count.
9. When finished, a message box will report the filename location and number of polygons in the KML file.
10. The KMZ can then be added to a Google Earth instance (or likely you can double-click on the KMZ and it will
launch and load Google Earth).
The final file is a KMZ file, which is a zipped up KML file. The smaller file size will improve sharing
the floodplain inundation.
The 3D KML file may initially look a lot like the 2D KML file discussed above, as Google Earth will
zoom to the extents of the data. Interacting with the map is when the "3D" aspect starts to get
interesting. The 3D KML file allows you to interact with it by clicking on a particular location. The
depth, water surface elevation, and velocity for that area will be reported.
At this point, let's make it clear that the 3D KML file you are visualizing is a vector representation of
an HEC-RAS results grid. The reported results in the 3D KML are values based on interpolated HEC-
RAS results for the center of the 3D KML polygon. This is more obvious if we turn on the polygon
boundaries, as shown in the figure below. While the point values are exacting, they do lend insight
into the potential hazards for a particular area for the event being considered.
Providing interaction with the map is very useful, but there are better ways to visualize results in
Google Earth. Choose a location and enter "Street View".
You can now visualize the water level in perspective to cars, buildings, sign posts and other features
to inform you how the flood hazard.
An example plot using Horizontal Water Surface example where the "flat" water surface results in an
elevation gap at the boundary of each polygon.
The Cache Level used will greatly affect the time it takes to write out the map tiles because the Cache
Level corresponds to the effective cell size resolution of the raster that is stored. The process of
creating each PNG for the tile cache requires RAS Mapper to re-compute the output variable layer
(depth, for instance) for each cache level. The PNG must then be re-projected to the web Mercator
projection supported by web mapping services and written to the ‘db’ file. This can be a time
consuming process - larger Cache Levels will result in smaller “cell” sizes and larger file sizes.
The Cache Level also indicates how far you can zoom into the map. If you attempt to zoom in
beyond the pyramid level of the tile cache, the data will be interpolated. The default Cache Level is
12 and is recommended for a first cut look at the data at a low resolution that will not sacrifice
speed. If you write out data using an initial Cache Level and then wish to add additional levels, RAS
will append the data, assuming the output Layer Name (and time step) is consistent – the dialog
shown below will appear allowing the user to overwrite or append to existing data.
The other option affecting what is written to the map tiles is the Profile selected. The options of
Maximum, Minimum, or Profiles are available. If the Profiles option is selected, the user must define
the time range for data export. Using a time window allows for the data to be animated from the tile
cache. If there are many profiles in the unsteady flow simulation, there is an option to skip profiles in
the list so the event range can be visualized without having to write out more data than is needed. If
the inundation area associated with the maximum water surface is exported by default.
The web browser is launched with the “RAS Tiles” title at the top of the web page. Individual RAS
Project datasets in the ”.db” files are available for display as indicated by the RAS project name with
sub headings listing the available Plans. An overview image is shown on the right of the webpage, as
shown below.
Selecting a RAS project will show a new web form with datasets for each Plan that has been exported
based on the database files in the “tilesets” folder. The web interface, shown the figure below, will
allow you to select the Opacity for the RAS maps, animate through the list of output maps, pan,
zoom, and select from the list of background layers.