Part 1.1 - Open the HEC-WAT Study

To open an HEC-WAT:

1. Double-click the HEC-WAT shortcut icon, the HEC-WAT software will launch. The HEC-WAT splash window opens followed by the HEC-WAT main window (shown below).

HEC-WAT Main Window 

2. From the HEC-WAT main window, click File | Open Study. An Open Study browser will open.

Open Study Browser

3. Navigate to the HEC-WAT study (*.sty) file location inside NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver, select RussianRiver.sty, click Open. The Open Study browser will close, and the HEC-WAT study will display in the HEC-WAT main window.

Part 1.2: Adjustment to HEC-HMS Model

The HEC-HMS model that was previously imported only had one method for computing a result.  For HEC-WAT deterministic computes, an HEC-HMS Simulation run is necessary.

You will compare the output of this model at a 15-minute time-step and a one-hour time-step to compare compute time to computational accuracy. Changing the time step is only one way to reduce compute time, as you review the model, consider other options that could be taken to improve the compute time while making minimal impacts to the results computed by the model.

Open HEC-HMS

Simulation runs support the evaluation of a rainfall event for a given time window without considering uncertainty in the inputs. This is a common simulation type in HEC-HMS. First, you will create a new simulation run with a one-hour time step.

From the HEC-WAT main window, from the Programs toolbar, click .  

HEC-WAT Programs Toolbar 

The HEC-HMS main window will display.

HEC-HMS Main Window

Created: 1-Hour HEC-HMS Simulation Run (Skip)

The following steps have been completed for you – but have been included in the workshop for your reference. (Note: Steps are numbered differently to separate them from the step you must complete).

A new HEC-HMS Control Specification was created for you. A control specification allows the user to define the time window for the simulation and the computational time-step. The Control Specifications Manager provides the capability of creating a new control specification.

I. From the HEC-HMS main window menu, Click Components | Control Specifications Manager. The Control Specifications Manager will open.

HEC-HMS - Control Specifications Manager Dialog Box

II. Click New, the Create A New Control Specifications dialog box will open. In the Name box there is a default name, Control 1, this name can be replaced. Click Create, the Create A New Control Specifications dialog box will close. The name of the control specification will display in the Current control specifications box of the Control Specifications Manager dialog box.  Close the Control Specifications Manager dialog box.

HEC-HMS- Create A New Control Specification Dialog Box

A time window for the control specification was entered for you.  Each control specification sets the time window over which an HEC-HMS run will be performed. 

III. From the HEC-HMS main window, from the Study Tree on the Components tab, expand the Control Specifications folder. Click on Control 1, information about the control specification displays in the Control Specifications.  In the Start Date box, enter 26Dec1996; and in the Start Time box enter 00:00.  In the End Date box enter 11Jan1997; and in the End Time box enter 15:00.  From the Time Interval list, select 1 Hour.

HEC-HMS Main Window - Control Specifications Pane

A new HEC-HMS run was created for you that would be recognized by HEC-WAT.  Each HEC-HMS simulation run is composed of one meteorologic model, one basin model, and one control specification.

IV. From the HEC-HMS main window menu, click Compute | Create Compute | Simulation Run, and the Create a Simulation Run wizard opens.

HEC-HMS Main Window - Create a Simulation Run Wizard - Screen One

V. On the screen of the Create a Simulation Run [Step 1 of 4] wizard, in the Name box, enter Run-1 Hour, click Next. From screen two [Step 2 of 4], select Russian CWMS, click Next.  From screen three [Step 3 of 4], select Interpolated, click Next.  From screen four [Step 4 of 4], select Control 1; click Finish.

The last step that was completed for you was the compute of the Run-1 Hour simulation run. 

VI. The next step is to compute the Run-1 Hour simulation run. From the HEC-HMS main window, click the Compute tab from the Study Pane, expand the Simulation Runs folder.  Right-click on Run 1-Hour, from the shortcut menu, click Compute. A compute progress window will open, the simulation should complete successfully. Close the progress window when the compute is finished.

Create: 15-Min HEC-HMS Simulation Run (Continue Here)

1. You should compare the one-hour time-step results to 15-minute results.  Create an HEC-HMS simulation with a 15-minute time-step.  From the HEC-HMS main window, from the Components tab on the Study Pane, expand the Control Specifications folder, right-click on Control 1.  From the shortcut menu, click Create Copy; the Copy Control Specifications dialog box will open.  In the Name box, enter Control 2.  Click Copy, the Copy Control Specifications dialog box will close.

HEC-HMS - Copy Control Specifications Dialog Box

2. Now change the time interval for Control 2 to 15-minute time-step. From the HEC-HMS main window, from the Study Tree, expand the Control Specifications folder.  Click on Control 2; from the Control Specifications pane, from the Time Interval list, select 15 Minutes.

3. Next step is to create a copy of an HEC-HMS simulation run.  From the HEC-HMS main window, click the Compute tab from the Study Pane, expand Simulation Runs.  Right-click on Run-1 Hour, from the shortcut menu, click Create Copy, the Copy Simulation Run dialog box will open.  In the Name box, enter Run-15 min, click Copy.  The Copy Simulation Run dialog box will close.

HEC-HMS - Copy Simulation Run Dialog Box

4. The next step is to compute the Run-15 min simulation run.  From the HEC-HMS main window, on the Compute tab of the Study Pane, expand the Simulation Runs folder.  Select Run-15 min, from the Control Pane, select the Simulation Run tab.  From the Control Specifications list, select Control 2.

HEC-HMS Main Window - Compute Tab - Simulation Run Tab

5. From the Study Tree, right click on Run-15 min, from the shortcut menu, click Compute.  A compute progress window will open, the simulation should complete successfully.  From the HEC-HMS main window, click , then close HEC-HMS.

Compare 15 Minute and 1 Hour Time Step Results

1. From the HEC-WAT main window, from the HEC-WAT Toolbar, click , and HEC-DSSVue Viewer will open. 

HEC-DSSVue Viewer

From the menu, click File | Open, for the Open HEC-DSS File browser.  Browse to NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\hms\ and select Run_1_Hour.dss.  Click Open, the Open HEC-DSS File browser will close.

Open HEC-DSS File Browser

2. From the HEC-DSSVue Viewer, click File | Open, for the Open HEC-DSS File browser. Browse to NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\hms\, select Run_15_min.dss.  Click Open, the Open HEC-DSS File browser will close.

3. The HEC-DSSVue Viewer will now display both DSS files. From the By Parts: C list, select Flow, for each DSS file.  From the B Part list, select UKIAH GAGE, for each DSS file.  For each DSS file, double-click on the UKIAH GAGE record.

HEC-DSSVue Viewer - Two DSS Files - UKIAH GAGE

Click .  A Plot dialog box will open which compares results from the two HEC-HMS simulation runs.  Note the slight difference between the results.

UKIAH GAGE - Plot Comparing HEC-HMS Simulation Runs

Because the differences between the two HEC-HMS simulation runs are negligible, it is recommended you use the simulation run (Run 1-Hour) with the one-hour time-step since it computes faster the 15-minte time-step simulation run (ten seconds versus five seconds).

4. Close the plot window and close HEC-DSSVue.

Part 1.3 - Adjustments to HEC-ResSim Model

The HEC-ResSim model has not been associated with output from the HEC-HMS model. Since you are now using an HEC-HMS simulation run that has a one-hour time-step, it is necessary to adjust the HEC-ResSim model accordingly. If a model alternative is changed, it is common that other models lower in the computational sequence will need to be adjusted. Other adjustments may require more coordination, but the net impact of these adjustments can be worth the effort.

Open Reservoir Network

1. From the HEC-WAT main window, from the Programs toolbar, click . The HEC-ResSim main window will display. It is possible the HEC-ResSim main window will open behind HEC-WAT, use Alt+Tab to access the HEC-ResSim main window.

HEC-ResSim Main Window

2. From the Module list, select Reservoir Network. From the menu, click Network | Open; the Open Reservoir Network dialog box will open.

HEC-ResSim - Open Reservoir Network

From the Existing Reservoir Networks box, select Exercise.  Click Open, the HEC-ResSim schematic in the display area will update.

HEC-ResSim Main Window - Exercise Reservoir Network

Select and Compute a HEC-ResSim Simulation

1. From the HEC-ResSim main window, from the Module list, select Simulation. A new menu will appear at the top.

HEC-ResSim Main Window - Simulation Module

Click Simulation | Open; the Open Simulation dialog box will open.  Select the simulation 1996-12.27-1500, click Open, the Open Simulation dialog box will close.

HEC-ResSim - Open Simulation Dialog Box

2. From the Simulation Control panel (located to right of the map window), right-click on 1996.12.27-1500, from the shortcut menu, click Edit. The Simulation Period dialog opens.

HEC-ResSim - Simulation Period Dialog Box

3. Check Run New Extract, and from the Alternatives box, un-check RT-Normal and RT-Dry, then select RT-Normal2, click OK. The Simulation Period dialog closes; the Simulation Control panel will now list RT-Normal2.

4. From the Simulation Control panel, click Compute RT-Normal2. A Compute Progress dialog box will open.  The compute will fail and you will get the error message displayed below.

ResSIM Message Error

Note the location(s) listed in the Compute Progress window (e.g., AUSTIN CK CONF in figure above). Close the Compute Progress window.

Fix the Error in the Cumulative Local Flow and Compute

1. Still in the Simulation module, click Alternative | Edit, the ResSim Alternative Editor will open.  From the alternative table, select RT-Normal20:RT-Normal2, click the Time-Series tab.

2. From the time-series table, highlight the Cloverdale FLOW-LOCAL record. Click Select DSS Path, an HEC-DSSVue Select Pathname viewer will open. The Run_1_Hour.dss file should open automatically in the HEC-DSSVue Select Pathname viewer. 

If not, from the File menu click Open, the Open HEC-DSS File browser will open.  Browse to NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\hms\.  Click Open, the Open HEC-DSS File browser will close

3. From the B Part list, select CLOVERDALE GAGE (or other location that failed to compute). From the C Part list, select FLOW-LOCAL.  Select the CLOVERDALE GAGE record, click Set Pathname.

4. If necessary, from the ResSim Alternative Editor repeat the select DSS path step for any other DSS locations that failed to compute.

5. From the HEC-DSSVue Select Pathname viewer, click the File | Close. The HEC-DSSVue Select Pathname viewer will close. From the ResSim Alternative Editor, click Alternative | Save, then click Alternative | Close.  The ResSim Alternative Editor will close.

6. From the Simulation Control panel, right-click on 1996.12.27-1500 and click Edit from the shortcut menu. From the Simulation Period window, click the checkbox to enable Run New Extract and click OK. From the Simulation Control panel, click Compute RT_Normal2, the Compute Progress dialog box will open. This time the compute should be run successfully. Click Close to close the Compute Progress dialog box.

7. From the Simulation Control panel, right-click on RT-Normal2 and click, Save to Base Directory. The Save Simulation Run Module Parameters to Base Directory dialog opens. Check the checkbox to Copy Data and click OK.

Save Simulation Run Model Parameters to Base Directory dialog

8. From the HEC-ResSim main window, click File | Save Watershed, and then click File | Exit, HEC-ResSim will close.

Part 1.4 - Adjustments to HEC-RAS Model

Like other HEC products, HEC-RAS supports a wide range of project purposes, which requires a tremendous amount of flexibility in user options. These options can translate into substantial changes in the computation time of the simulation and the time required to post process the output into the user requested formats. Understanding the purpose of the study and what is necessary to support the decisions being made can help to reduce output requirements and improve computation speed.

This section of the workshop will explore some of the options that can affect the overall HEC-RAS compute time. Other options might be possible to change that have greater impacts on the computational speed, stability, and accuracy – think about what changes might be able to improve the stability and speed of the HEC-RAS compute as you complete these steps.

Perform Unsteady Flow Calculations

1. From the HEC-WAT main window, from the Programs toolbar, click . The HEC-RAS main window will display.

HEC-RAS Main Window

2. Click Run | Unsteady Flow Analysis, or click from the toolbar. The Unsteady Flow Analysis dialog box will open.  Check that the HEC-RAS Plan: Russian River Real-Time is being used.

HEC-RAS - Unsteady Flow Analysis Dialog Box

3. To find the best combination for the HEC-RAS unsteady flow computation settings, you will need to try different scenarios. The best combination could be based on compute time and the need for specific outputs. Table 1 provides two different scenarios, which have different compute settings suggested for the unsteady flow computation.

Table 1. Two Compute Scenarios for HEC-RAS Unsteady Flow Computation

Scenarios

DSS for Cross Sections

Hydrograph Output Interval

Detailed Output Interval

Compute Time

1

All

1 min

Max Profile


2

All

1 hour

Max Profile


4. There are 3 computation settings commonly adjusted in RAS to adjust computation time, in this workshop you will be adjusting Hydrograph Output Interval:

  • Computation Interval: This interval is set to 1 minute in this study and is the same for all scenarios. Adjusting this variable can impact the stability of the model and should only be done in coordination with the hydraulic modeler.
  • Hydrograph Output Interval: This is used to define at what interval the computed stage and flow hydrographs will be written to HEC-DSS. This interval should be selected to give an adequate number of points to define the shape of the computed hydrographs without losing information about the peak or volume of the hydrograph.
  • Detailed Output Interval: This field allows the user to write out profiles of water surface elevation and flow at a user specified interval during the simulation. Profiles are not written for every computational time step because it would require too much space to store all the information for most jobs. To reduce the amount of post-processing and storage required for a detailed hydraulic output, it is suggested that just Max Profile is written.

Run Scenarios

1. Following the instructions from Table 1 for Scenario 1, on the Unsteady Flow Analysis dialog box, from the Mapping Output Interval list, select 15 Minute. From the Hydrograph Output Interval list, select 1 Minute.  From the Detailed Output Interval list, select Max Profile.

2. By default, the unsteady flow analysis computation will save DSS results for cross sections. To turn this option off, in the Unsteady Flow Analysis dialog box, click Options | Stage and Flow Output Locations and the Stage and Flow Output Locations Selector will open.

HEC-RAS - Stage and Flow Output Location Selector

3. For Scenario 1, click Clear Selected List, the Selected Locations box will now be empty. Click OK, the Stage and Flow Output Locations Selector will close.

4. Click Compute, the HEC-RAS Computations dialog box will open. The computation should run to completion, record your "Complete Process" compute time in Table 1.

HEC-RAS - HEC-RAS Computations Dialog Box - Example Compute

5. For Scenario 2, in the Unsteady Flow Analysis dialog box, change the Hydrograph Output Interval and recompute for 1 Hour time step. The computation should run to completion, record your "Complete Process" compute time in Table 1. Then close the HEC-RAS Computations

6. Keep the Unsteady Flow Analysis dialog open and answer the questions for the two scenarios.

Reviewing the Recorded Compute Times for the Two Scenarios

Now that you have recorded compute times for the scenarios in Table 1, review your results (recorded in Table 1. Two Compute Scenarios for HEC-RAS Unsteady Flow Computation ) with respect to the following questions:

Question 1: Which scenario takes less compute time?
Scenario 1. 
Question 2: How will the outputs of HEC-RAS be used?

In the HEC-WAT the HEC-RAS output will be used to compute the HEC-FIA model. 

Question 3: Are any applications consuming the outputs to define their boundary conditions in the Russian River watershed?

Yes, the HEC-FIA “Real-time” model alternative. 

Question 4: Which scenario should we select? Why?

Scenario 2, because the HEC-FIA model is looking for input in a 1 Hour time step. 

Part 1.5 – Adjustments to HEC-FIA Model

HEC-FIA computes a variety of outputs to support CWMS and HEC-WAT. CWMS is interested in evaluating the impacts of real time operations on established critical thresholds using the impact response table. CWMS also is concerned with changing operations to minimize impacts of critical infrastructure elements. While these are both important in a planning context, they are not typically used in an HEC-WAT watershed. Life loss estimation is an important consideration for a typical HEC-WAT watershed. Life loss estimation requires a warning to be issued to the public with each event. The warning should be relative to a critical threshold within the watershed. To achieve this, HEC-FIA allows warnings to be issued based on user specified rules at specific locations in the watershed. Our rules for warning issuance will be on exceeding critical stage elevations at three cross sections. This way the variety of events that may be computed in HEC-WAT can each have a unique warning issuance time that is consistent with how warning plans are stated in emergency operation plans. We do not need D*V for our HEC-FIA model so some additional modifications are necessary, this section will outline those modifications.

HEC-RAS Compute for HEC-FIA Model

In HEC-RAS the D*V grid adds a considerable amount of additional post processing time but does not impact the computation of life loss in HEC-FIA in this watershed. The evaluation to support this decision requires more analysis than can be shown in this workshop but is a useful consideration for other watersheds. Understanding the details of how the models work – how they work together and alone – can really affect how the project delivery team sets up their watersheds.

1. The HEC-FIA model needs HEC-RAS output at three cross sections. These locations are used by HEC-FIA in evaluating warnings that will be issued to the public for evacuation.

HEC-FIA - Edit Cross Section Time Series Mappings Dialog Box

2. From the Unsteady Flow Analysis dialog box, click Options | Stage and Flow Output Locations, the Stage and Flow Output Locations Selector will open.

3. From the River list select Russian. From the Reach list and RS list select the following, respectfully; and for each RS selection click to add the location to the Selected Locations box:

CoyoteToDC:

(1) 84.78 Hopland

(2) 35.42  Healdsburg

DCtoOcean:

(1) 15.15 Johnsons Beach

HEC-RAS - Stage and Flow Output Location dialog

4. Click OK to save the selections and close the Stage and Flow Output Locations Selector

5. From the Unsteady Flow Analysis dialog box, verify that the Mapping Output Interval list is set to 1 Hour, the Hydrograph Output Interval list is set to 1 Hour and the Detailed Output Interval list is set to Max Profile. Make sure the Floodplain Mapping option is selected on the Unsteady Flow Analysis dialog box.

6. Click Compute, the HEC-RAS Computations dialog box will open. When the unsteady flow analysis computation is complete, click Close, the HEC-RAS Computations dialog box will close.

7. Save the unsteady flow analysis (File menu | Save Plan), close the Unsteady Flow Analysis dialog (File menu | Exit), save the HEC-RAS project (File menu | Save Project) and close HEC-RAS (File menu | Exit).

Modify an Existing HEC-FIA Alternative

1. From the HEC-WAT main window, from the Programs toolbar, click . The HEC-FIA main window will display.

HEC-FIA Main Window

2. First, you need to create a new inundation data configuration that does not include a Depth*Velocity Grid. From the Study Tree, right-click on the Inundation Data folder, from the shortcut menu, click New.  The New Inundation Configuration wizard – Step 1 will open.

HEC-FIA - New Inundation Configuration Wizard - Step 1

3. In the Name box, enter WO D*V, and from the Hydraulic Data Type list, select Grids and Cross Sections. Click Next, the New Inundation Configuration wizard – Step 2 will open.

HEC-FIA - New Inundation Configuration Wizard - Step 2

4. Select Inundation Grid and Life Loss Arrival. From the Watershed Configuration list, select Russian Real-Time.  Click Finish, the New Inundation Configuration wizard will close.  Under the Inundation Data folder, the name of the new inundation configuration will display.

5. Right click on WO D*V, from the shortcut menu, click Define Event. The Define Event dialog box will open.  From the DSS File box, click , an Open browser will open.  Browser to NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\ras, select RussianRiver.dss, click Open.  The Open browser will close, and the pathname and name of the DSS file will display in the DSS File box.  From the E-Part list, click 1HOUR.  Click OK; the Define Event dialog box will close.

HEC-FIA - Define Event Dialog Box

6. From the Study Tree, from the Inundation Data folder, from the WO D*V folder, right-click on RT UNSTEADY. From the shortcut menu, click Edit Event.  The Grids and Cross Sections Event dialog box will open.

HEC-FIA - Grids and Cross Sections Event Dialog Box

7. From the Inundation Grid box, click , an Open browser will open. Browse to the location of the Depth Max grid, NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\ras\RT Unsteady, click Depth (Max).russiandemft_albers.tif, click Open, the Open browser will close.

From the Life Loss Arrival Grid box, click , an Open browser will open. Browse to the location of the Arrival Time grid, NWO_Workshop_1.5\NWO_WS_1.5_start\RussianRiver\ras\RT Unsteady, click Arrival Time (2ft hrs).russiandemft_albers.tif, click Open.  Click OK, the Grids and Cross Sections Event dialog box will close.

8. Now you need to modify the existing warning issuance scenario to use the newly created inundation configuration. From the Study Tree, from the Warning Issuance Scenario folder, right-click on Warning Issuance.  From the shortcut menu, click Edit, the Edit Warning Issuance Scenario dialog box will open.

HEC-FIA - Edit Warning Issuance Scenario Dialog Box

9. For each rule in the Rules list, from the Inundation Configuration list, select WO D*V. Click OK, the Edit Warning Issuance Scenario dialog box will close.

10. From the Study Tree, from the Alternatives folder, right-click on Real-time. From the shortcut menu, click Edit; the Edit Alternative dialog box will open.  From the Inundation Configuration list, select WO D*V.  From the Warning Issuance list, select Warning Issuance.  Click OK; the Edit Alternative dialog box will close.

Note: The Impact Response selection (NWS Impact Response) will automatically unselect as this element was created for the GridsAndXSec inundation dataset; this behavior is expected.

HEC-FIA - Edit Alternative Dialog Box


Update Existing Simulation and Compute

1. From the Study Tree, from the Simulation folder, right-click on Simulation, from the shortcut menu, click Edit. The Simulation Manager dialog box will open.

HEC-FIA - Simulation Manager Dialog Box

2. Re-select Real-time, RT UNSTEADY, and TW time window from their respective dropdown lists. Click OK; the Simulation Manager dialog box will close.

3. From the Study Tree, from the Simulation folder, right-click on Simulation, from the shortcut menu, click Compute. The Compute Progress window will open. The compute should complete with the message Compute Complete.  Click Close, the Compute Progress window will close.

HEC-FIA - Compute Progress - Simulation Window

4. From the HEC-FIA main window, click File | Save Study, and then click File | Exit. The HEC-FIA main window will close.

5. From the HEC-WAT main window, from the File menu, click Save Study, to save the study.

Part 1.6 – Questions for Parts 1.1 -1.5

Question 5: What are some additional changes that could be done to improve the computational speed of HEC-HMS? – At what cost?

Increase compute time-step from 15-min to 1-hour, or greater. Cost is model accuracy and potential issues with model linking (e.g., HEC-HMS and HEC-ResSim or HEC-RAS). Additional option within the HEC-WAT is to Time Window Modifier plugin. The Time Window Modifier Plugin provides the user ability to modify the simulation time window based on flow, stage, or elevation. The user can modify the time window relative to a threshold, a peak value, or through a script. A typical use case for this plugin is to reduce the time window to correspondingly reduce the runtimes for a computationally intensive plugin. Also, the Time Window Modifier plugin can be used to expand a time window to allow for hydraulic routing of rainfall or provide a lookback period for HEC-ResSim. 


Question 6: What are some additional changes that could be done to improve the computational speed of HEC-ResSim? – At what cost?

Increase compute time-step from 15-min to 1-hour, or greater. Cost is model accuracy and potential issues with model linking (e.g., HEC-ResSim and HEC-RAS). Additional option within the HEC-WAT is to Time Window Modifier plugin. 


Question 7: What are some additional changes that could be done to improve the computational speed of HEC-RAS? – At what cost?

Increase compute time-step from 1-hour to 6-hour, or greater. Cost is model accuracy and potential issues with model linking (e.g., HEC-RAS and HEC-FIA). Additional option within the HEC-WAT is to Time Window Modifier plugin.  

Question 8: What are some additional changes that could be done to improve the computational speed of HEC-FIA? – At what cost?

Increase compute time-step from 1-hour to 6-hour, or greater. Cost is model accuracy and life loss estimates. HEC-FIA is the last model in the program order (or compute sequence) and therefore only the input time-step matters for HEC-FIA. 

Click here to continue to Part 2 - Setup HEC-WAT for a Deterministic Compute.