Workshop Files

Starting Files Using an Imported RAS2025 Mesh: Fixed Bed Modeling Tutorial Starting Files.zip

This workshop includes components of building a hydraulic model. 
If you would like to jump to just adding a sediment analysis, start in Part 3 of this workshop. 
This video starts in Part 3.


Introduction

Sediment computations add run time to hydraulic models, sometimes making sediment runtimes substantial. Two-dimensional sediment models can take even longer to run.  The sediment computations for multiple grain classes are computationally expensive, and a well-designed sediment model can increase model run time by an order of magnitude or more over a hydraulic model. 

 
HEC-RAS includes a range of modeling options that offer tradeoffs between run time and feature richness.  HEC added fixed bed sediment modeling modes as intermediate analysis options.  Because much of the run time in the mobile-bed sediment model is in the bed mixing and elevation updates, a fixed bed sediment capacity tool can provide some of the sediment process insight at a fraction of the runtime.


The capacity-only option is a fixed-bed, 2D, sediment model that computes sediment capacity without sediment transport while the concentration-only model solves the AD equation without bed change.  Both simplifications can provide some of the value of a 2D sediment model for an intermediate level of effort (and run time) and make good screening level tools.  This workshop will introduce some of the important hydraulic variables you can view without a sediment model and then introduce the fixed-bed sediment modeling options.

Warning: Models for Educational Use Only

The models in this demo are intended for pedagogical purpose only.  They have been simplified and modified to fit into a brief workshop and should not be used for scientific or engineering analysis.  This workshop also reflects the quickest steps to get a result, not the best modeling practices.

Objective

This reach was a depositional zone for years, requiring more dredging than any other reach in this large sand bed river.   (Here is a Video of the reach).


Then the District added four structures that increased the transport capacity, and this reach has not required dredging since.  We will model a rising hydrograph with and without the structures and compute the difference in capacity to develop an understanding of how these structures affected capacity.

Part 1: Add Boundary Conditions, Enter Flows, and Run Model

       1. Open the workshop model.

  1. Open the file FixedBedSed.prj.
  2. The model has a two geometries that separate associated terrain and roughness layers (one with the structures and on without) and mesh like you created in the previous workshop
    1. We have used RASMapper mods to clone the terrain and remove the four structures, reducing them to the surrounding grade for the No Structure geometry. (This video demonstrates how to remove the structures).
  3. The project also has a flow file, and two plan file ready to go.  But it needs flow boundary conditions. 

       2. Add Boundary Conditions in Mapper:

  1. Open RASMapper. (GIS Tools → RASMapper or the Mapper Button )
  2. Flow in this project is from North to South.
  3. Right click on the Fixed Bed Workshop Geometry and select Edit Geometry. 
  4. This will expand the geometry tree so that you can see all of the possible components you can edit, including the Boundary Conditions Lines.
  5. Click in the Boundary Condition Lines node
  6. Select the drawing tool.
  7. Draw boundary conditions lines Left-to-Right looking downstream (river flows from northwest to southeast) across the channel just outside the upstream and downstream mesh boundaries.
  8. Give them intuitive names (e.g. US BC and DS BC for upstream boundary condition and downstream boundary condition respectively).
    Note: a 2D model does not know what direction water is going a priori.  You have to define that with your boundary conditions.
  9. Think about what portion of the channel will be actively conveying, this is the portion you want to cover with your boundary locations.
  10. Next, you need to copy these boundary conditions to the other geometry to make sure they are identical (because they will be sharing a flow file).
    You have two geometries because one has the structures in it but the other does not.
    The flows are the same in both models, however, so you will only have one boundary condition file
  11. Right click on the Boundary Conditions Line node on the tree and select Copy All Features.
  12. Select the other Geometry File, and press the Pencil  to start editing.
  13. Select the Boundary Conditions Line and select Paste Features.
  14. Press the stop sign in the location you found the edit pencil to stop editing or right click on the geometry and choose Stop Editing.

     3. Add Flows (upstream) and a Rating Curve (downstream) to the boundary condition editor:

The files already come with an unsteady flow file (that can be shared between the geometry flies) and two plan files with some hydraulic options and parameters already set. 

  1. Open the unsteady flow file  (or Edit → Unsteady Flow Data) from the main HEC-RAS window.
    The two boundary conditions you defined in RAS Mapper should show up there.
  2. Select the blank, Boundary Condition, Cell in the downstream boundary condition row(which you named DSBC).  The boundary conditions allowed at that line in the 2D model will become active above.  
  3. Press the Rating Curve button .  

  4. We developed a downstream stage rating curve for a low Mississippi stage from the 1D steady flow model. 
    The paired data for the downstream boundary condition are below or in the DS Rating Curve Tab of the Workshop Data.xlsx file.
    WSE (ft)

    Flow (cfs)

    1620
    162.3710000
    164.530000
    169.1970000
    177.03150000
    178.16175000
    178.63185000
    182.05260000
    183.34310000
    184.9360000
    186.7430000
    187.36480000
    190.47

    625000



  5. Add the rating curve data.
  6. Then select the upstream boundary condition (USBC) and choose the Flow Hydrograph.    
  7. Define a series of flows between 30,000 and 150,000 cfs at 12 hour increments to simulate a series of rising flows. 
    Flows
    (cfs)
    30000
    60000
    90000
    120000
    150000

    (Note: We will work with with warmup and initial conditions in other tutorials, but they are set for you in this one).

  8. Set your energy grade slope at the bottom of the editor to distribute your upstream flows to 0.004 and check the TW Check box

  9. Because both plans share this flow file, you only need to enter these data once.

     4. Open Plan and Simulate:

  1. Return to the main HEC-RAS editor.
  2. Open the unsteady flow simulation editor
    1. Select Run → Unsteady Flow Analysis or press the "unsteady" running person button.
    2.  There are two plans, you should be open to "Capacity Only (no Struc)"
    3. This plan does not include structures.
  3. Your time window has already been set up to accommodate your flow series.
    This plan file has warmup parameters and other features already defined.
  4. Then press the Compute button to simulate.
  5. Open the second plan (Capacity Only with Struct)
    1. Go to File→Open to select the plan
  6. Press Compute to run the hydraulic mode with the structures

Part 2: Plot Sediment Related Hydraulic Variables (Velocity and Shear Stress)

     5. Map Velocity:

  1. Open RAS Mapper  
  2. Scroll down in the RASMapper Tree to Results and expand the node.
  3. You should have two results, one for each of the plans, expand both
    1. Check both results "on"
  4. Select the velocity results for both plans. 
    1. If you turn on velocity for multiple results you will be able to compare them.
  5. Select the Results tab to animate them together
    1. Move the scroll bar to move through the flows
  6. Plot the velocity time series at several location. 
    1. Right Click on Cells or Faces in the area around the structures to see the difference in velocity with and without the structures.
  7. Try plotting velocity for cells and cell faces.


(Note: If you would like to make the Velocity result translucent like above right click on the Velocity node and select Layer Properties and adjust the Opacity.  You can also change the color scale).

Question: Did the structures increase the velocity or decrease it?

The impact of the structures on velocity depends on where you look at results.  The structures push conveyance from the right bank into the navigation channel to the left (looking downstream - east in the image).  So velocity increases in channel to the east of the structure but downstream of the structure velocities decrease.

 

       6. Map Shear Stress Results:

Shear stress is another hydraulic variable that correlates with sediment transport.  Many of the transport equations use shear stress so it can provide a first order estimate of transportability without running any sediment analyses. 

  1. Shear Stress is an important hydraulic variable for a range of sediment transport analyses, and can be a useful heuristic for sediment processes if you only have a hydraulic model.

  2. Select the shear stress output in your current simulation.  
  3. Right click on each Result and select Create a New Results Map Layers.  
  4. Then expand the Hydraulics tree and select Shear Stress.  Map shear stress and try to plot a time series of shear stress at a cell or a face.
  5. Stream Power is another variable that correlates with sediment transport if you are curious and would like to add it.

Can you plot a time series of Shear Stress?____________________

The hydraulic shear stress parameter is computed on the fly from hydraulic results, so there are no stored shear stress values.  To plot a time series of shear stress, you have to request shear stress output.  Expand the section below to learn how.

7. Request Shear Stress Output:

To request output that do not come standard with a RAS run, open the unsteady flow Computation Window, and select the Options → Output Options menu.

Select the HDF5 Write Parameters.  There are a number of very helpful features on this tab, but in particular, you can choose to write several additional 2D variables.

Re-run your result.  After your new simulation, right click on the result in Mapper again, and choose Create a New Results Map Layers again.

But this time expand the Additional 2D Variables section.  You will find the new Shear Stress result under there.  Select it and press Add Map.  

Now you have two shear stress maps.  The new Shear Stress map has default units that are not very informative.  You can copy the units from the other Shear Stress Map.

Right Click on the on-the-fly shear stress result and open Layer Properties.


At the bottom of the Layer Properties editor, press the Copy Symbology button.
Next, right click on the new Shear Stress result, and select Layer Properties and Paste Symbology. 

Now plot the shear stress time series by right clicking on the map.  Try clicking on cells and cell faces.

Part 3: Set Up Sediment Model

Workshop Files

If you just want to work through the sediment part of this workshop, start here with these files.
Starting Files Using a RAS Mapper Mesh: Starting Files for Part 3 (Hydraulics Complete).zip

To use the capacity only, fixed bed sediment features, you still need to set up a full sediment model, which means you will need a sediment file, gradations, and a sediment boundary condition (even though you will not use the latter).

       7. Associate Bed Gradation: (Done for you in this workshop)

One of the requirements for a 2D sediment model (fixed or mobile bed) is a map of the Sediment Bed Material. 
This Bed Material map is primarily for defining the gradation (i.e. grain-size distribution) of the river bed and other features in the model but you can also use it for other purposes, like defining cohesive erodibility properties and non-erodible surfaces).
After you create Sediment Bed Material May Layer in Mapper, you have to associate it with the geometry. 
We have already created a simple Bed Gradation layer in mapper and associated it with the geometry. 

  1. Create a new RAS Map Layer
    1. Right click on Map Layers on the RASMapper tree.
    2. Select Create a New RAS Layer → Sediment Bed Material Layer

    3. Press the "+" button to add shape files.
    4. Navigate to the GIS folder an add the 2D Area and Structure Outline shape files.
    5. Make sure the Structure Outline is above the 2DArea file.
    6. You can use the arrow buttons to reorder the shape files
    7. The folder in the bottom right will let you change the name if you would like.  It is ok to leave it as (1).
  2. Turn on the classification polygons to make sure you can see the structure and the bounding polygon.
  3. Associate your new Sediment Bed Material Layer with both geometries.
    1. Right click on the Geometry node in Mapper
    2. Select Manage Geometry Associations.
    3. In the Sediment Bed Material column, click the drop down and choose the Sediment Bed Material that you just created for BOTH geometries. 

To associate a Sediment Bed Material layer with your geometry:

  1. Right Click on the Geometry Node and select Manage Geometry Associations.
  2. Select the Sediment Bed Material layer you created for each geometry.
  3. You will notice that in this model, the geometries have different Manning's n (yellow box above) layers but the same Sediment Bed Material layer.
    That is because if we want the structures to get their own n-value, we must include separate n-value layers in the separate geometries.
    But for sediment, we can just give the regions associate with the structures the native bed material in one project and define them as "non-erodible regions" in the project with the structures so they don't erode under the high shear stresses they induce.

       8. Open the Sediment Data Editor:

  1. Either select the Edit→ Sediment Data menu or use the sediment data button.  
  2. Select File → New and give your sediment data file a name like "Sediment - No Structures"
    1. You will need a distinct sediment data file for each plan (with and without structures) so lets start with no structures.

            10. Select Sediment Boundary Condition:

The Sediment Data Editor opens to the Boundary Conditions tab.

Fixed bed sediment analysis (especially Capacity Only analysis) is not as sensitive to sediment boundary conditions. 
However the model still needs an upstream sediment boundary condition to run.
So, for now, we will just use the Equilibrium Load sediment boundary condition.

  1. Make sure you are on the Boundary Conditions tab in the Sediment Data Editor.
  2. A boundary condition row populates for each of your boundary condition lines (this should look a lot like your flow boundary condition eidtor).
  3. Click on the row associated wiht your upstream boundary conditoin and click the Equilibrium Load button.
    1. Equilibrium load will use the transport capacity to compute the equilibrium sediment flux at the upstream boundary (the load in balance with the transport causing neither erosion or deposition at the upstream cell faces) and bring it into the model.
  4. Leave the downstream boundary condition blank.

    9. Select Sediment Equations:

  1. Select the 2D Bed Gradation Tab next.  This also includes the equation choices.
  2. HEC recommends starting with one of the 2D transport equations.
    1. Wu, van Rijn, and Van Rijn-Soulsby are the equations developed distinctly for 2D
  3. You have to scroll down to find the 2D equations in the Transport function list.
    Note: It does not matter what sorting method you choose, 2D sediment will always use a customized version of the Active Layer approach, but it is good practice to select it.

    10. Estimate Bed Gradation:

Fixed bed sediment models partition transport capacity by grain class like a mobile bed model, so sediment bed gradations are the minimum data requirement.
This river has 35 bed gradation samples from September 2003. 
These samples are plotted with river station (light blue-downstream/dark blue – upstream) in the classical geotechnical format in the following figure.



These data are also in the Bed Gradation tab of the Workshop Data.xlsx file.
Question : Do the data have a clear longitudinal trend? 

Not really.  A clear longitudinal trend would show up as the dark lines disproportionately on one side or the other.  This is a pretty tight distribution of sand without substantial spatial variation.

Question: How many grain classes do you think you need to represent the bed material load in this system?  

In this model, we used a simplified bed gradation layer, that attributes one bed gradation with the whole model (except for the navigational structures). This is a very tight grain size distribution, only representing 4 grain classes.  Capacity only is very fast, so you can run all four without unreasonable run times.  But since we will also turn this into a mobile bed model and are trying to get "workshop runtimes" I would limit it to three, and since 80% of the sediment is Medium Sand, you could probably get pretty good answers with a single grain class model.


Estimate the percentage you would associate with each grain class (and convert it into % Finer):

Grain Class%% Finer
Very Fine Sand (VFS)

Fine Sand (FS)

Coarse Sand (CS)

Very Coarse Sand (VCS)

       11. Enter Bed Gradation:

  1. In the Sediment Data Editor, press the Define/Edit Bed Gradation button to enter your bed gradation.
  2. This will launch the bed gradation editor. 
  3. Press the New button to create a bed gradation and give it a descriptive name. 
  4. Then enter the data.
    1. You can enter data as % Finer or the % in each grain class, which is often more intuitive. 
    2. You could enter multiple samples or bed gradations here, but for now, press OK when you are done.

       12.  Select Bed Gradations for Bed Material Layer Features:

Now we will select a Bed Gradation defined in the sediment editor for each of the Bed Material Layer features we defined in Mapper.

  1. Stay in the 2D Bed Gradation tab in the Sediment Data Editor.
  2. The table lists each Sediment Bed Material type in the Sediment Bed Layer you associated with the geometry of this plan in step 7.  
    1. You should see two Bed Material Types: 
      1. Simplified Bed Gradation
      2. Structure
  3. Because this is the No Structure model, set them both to the default gradation you just made.
    1. Click on the blank cell next to each of them in the column labeled Gradation.  
    2. This will give you a drop down list of all the bed gradationts you have entered (again, just one in this case) and another option that is always available (Non-Erodible Surface).

  4. Trouble Shooting Tips

    If you do not see the Gradation Types you expect make sure they are specified in Mapper and associated with your geometry, then close the program and reopen.  A restart will usually help fix any dissasociation between Mapper and the other RAS Components.

    If you just defined a Bed Gradation but don't see it in the drop down, try saving the sediment data and then closing and opening the editor.

  5. Select the gradation you just created.
    1. You will need to change this to a non-erodible surface in the mobile bed model, but since we are not updating the bed in the fixed bed analysis, it does not affect the results.
  6. Finally Change the Simulation Components to Capacity Only

    1. In the Sediment Data Editor select Options → 2D Options.
    2. From the Simulation Components dropdown, choose Capacity Only.
    3. Select OK.
    4. Save your sediment data.
    5. Capacity Only turns the advection diffusion and bed change equations off, and just computes transport capacity for every time step.  It is a way to screen sediment alternatives with a simplified analysis. 

Part 4: Capacity Analysis

          13. Run the Sediment-Capacity Fixed Bed Model:

  1. Open the Unsteady Simulation editor
  2. Open the No Structures plan.
  3. Then check the Sediment box under Programs to Run. 
  4. This will add a Sediment Files option to the file drop down boxes.
  5. Select the sediment file you just created.  
    1. You should only have one, so it should populate automatically.
  6. Then press Compute.
  7. Repeat the process with the With Structures plan, turn on Sediment and run it.

       14. View the Fixed Bed Sediment Results:

  1. Return to RASMapper.  
  2. Scroll down to Results in the tree and right click each new results in RASMapper and choose Create a New Results Map Layers again.
     
  3. The Output editor Map Type tree has a new node: Sediment. 
  4. Expand the Sediment node of the results tree.
  5. Since we did not compute bed change, you won’t be interested in the sediment bed results.
  6. Expand the Sediment Transport node and select Total-load Transport Capacity.
  7. Add this map to both results.
  8. Select the new Sediment Capacity result in both plan results, and turn off all other variables.
  9. Add a profile line to view cross sections of sediment capacity.

    1. Click the Profile Lines tab at the bottom of the left pane - under the mapper tree.
    2. The choose the pencil next to the Profile Line editor.
    3. Digitize a line just downstream of one of the structures, from left to right looking downstream (so east to west in this model).
    4. Give it a name (e.g. "XS").
    5. Right Click on the Profile line in the list (see image below).
    6. Select Mapping Results → Profile → Fast → Total-load Transport Capacity
    7. Compare the transport capacity for the two models.

Question: How do the structures change the transport capacity through this reach?

The increase transport capacity by about 50% in the navigation channel.


Part 5: Concentration Analysis

       Create a Concertation Analysis Plan:

Next you will experiment with the other fixed bed analysis mode. 
To do that, you will need a mostly identical Sediment Data File. 
Open the Sediment Data Editor and Save As.  
Give it a descriptive name, like “Concentration Only”. 
Then switch the Simulation Component and Save the file.

To change the Component select the Options→ 2D Sediment Options menu from the Sediment Data Editor. 
Select Concentration Only from the Simulation Components dropdown box at the top of this editor.
Then Open the Unsteady Flow Simulation editor, make sure the Sediment File has changed to the file you just created. 
Then save the new plan, give it a descriptive name, and press Compute.

       View the Concentration-Only, Fixed-Bed Results:

Open Mapper and Right Click the new result to add the Concentration Result. 
Expand the Sediment→ Sediment Transport node of the Map Type tree. 
Total-load Concentration is now on the list. 
To just add total concentration, expand the Total-load Concentration tree and select Total. 
Then Add Map.
(Note: you can add results for individual or all grain classes, but this can get unwieldly at this point, so start with just the total).

To view concentration results, you will often have to reduce the max, since local concentration spikes or initial condition effects can stretch the color band. 
There are also two Concentration display options. 
You might want to experiment with which works best for each map.

Part 6: Compare Capacity Results With and Without Structures

These results are useful to indicate relative regions of high and low capacity. 
But we want to be able to weigh in on the impact of the structures. 
So in this section you are going to repeat the capacity calculation on a terrain without the structures, and compare the results to try to quantify the impact of the structures before we begin mobile bed modeling.

        15. Open the RASter Calculator:

The objective of this study is to evaluate the effect of these structures. 
The RASter Calculator can compute maps of capacity difference between the two simulations to quantify and illustrate the effect of the structures.

  1. In RAS Mapper, select the Tools → Create Calculated Layer option.
  2. This will launch the RASter Calculator Editor (see next editor).

       15. Define the Capacity Maps as Variables:

  1. To create a difference map from the capacity results, you will have to define each capacity result Layer as a variable.
  2. Push the Add New Layer Variable button in the top left corner of the editor.
  3. Select the Plan (no Structures) and Map Type (Total-load Transport Capacity - which is at the bottom). 
  4. Leave the Animation Behavior to the default (Dynamic). 
  5. Then give the layer a brief but descriptive variable name in the Name field (e.g. CapNoStruc). 
  6. Press the Add Variable button.
  7. This should add the variable to the Map Layer window in the upper left of the editor.
  8. Repeat the process with the four-structure plan, and press Add Variable.
  9. These variables (CapNoStruc and CapWithStruct) should show up in the upper left corner (Layers) of the editor as depicted in the following figure.
  10. Once you add the first variable, the editor automatically populates a “stub” code that you can modify.
    1. Make the minor changes to that statement pictured below to complete the analysis.
    2. Add an "andalso" statement to include the second variable in the NoData line (pictured above)
    3. Set the Output to 0 (replace Output = NoData with Output = 0) if there is no data to compare
    4. Set the Output equal to the difference between the Capacity Variables:
      1. Output = CapWithStruc - CapNoStruct
    5.  After you have completed the code, press the Check Code button to see if it is complete.
    6. If not, press the View Full Code button, which will help you find the error.
    7. After the code passes the check, press Create Layer.

       16. Visualize Capacity Difference Map: 

  1. The new layer will appear in the Map Layers portion of the mapper tree. 
  2. Right click on the new CapacityDiff Map Layer and select Image Display Properties
  3. The result will import with an unhelpful 0-100 greyscale symbology.
  4. Switch it to the Red-White-Blue “Bed Change” symbology. 
  5. Press the Edit button under the Surface options

    1. Select the Bed Change red to blue color ramp.
    2. Set the max to 10 and min to -10 (this color ram works best if the max and min are symmetrical).
    3. Press the Create Ramp Values button
    4. Double click on the red and choose blue.
    5. Double click on the blue and choose red
    6. Set the alpha for white to 0.

If you have extra time: Try to make a % Change capacity map.

Solution Files: Fixed Bed Sediment Solution.zip

Workshop Files

To learn how to modify and import a RAS2025 Mesh, explore the workshop on Exporting a RAS2025 Mesh