WMS HMSInterface Tutorial

Tutorial for Modeling Judys Branch data on HEC-HMS Single
and
Multiple basin simulation
Table of Contents
CHAPTER 1: HEC-HMS INTERFACE........................................................................................4
1.1 DELINEATING WATERSHED................................................................................................................4
1.2 SINGLE BASIN ANALYSIS:...................................................................................................................6
1.2.1 SETTING UP JOB CONTROL.................................................................................................................6
1.2.2 SETTING UP THE METEOROLOGICAL DATA..........................................................................................7
1.2.3 SETTING UP THE BASIN DATA PARAMETERS.......................................................................................8
1.2.4 RUNNING HEC-HMS....................................................................................................................9
1.3 COMPUTING THE CN USING LAND USE AND SOIL DATA......................................................................12
1.3.1 ADDING SOIL DATA AND MAPPING IT TO WMS COVERAGES...............................................................12
1.3.2 ADDING LAND USE DATA AND MAPPING IT TO WMS COVERAGES.........................................................13
1.3.3CALCULATING CN FOR THE WATERSHED............................................................................................13
1.4 RUNNING HEC-HMS...................................................................................................................14
CHAPTER 2.0 ANALYZING SUB-BASINS AND ROUTING..................................................17
2.1
2.2
2.3
2.4
2.5
DELINEATING THE SUB-BASIN..........................................................................................................17

UPDATING THE BASIN PARAMETERS.................................................................................................19
SETTING UP THE ROUTING PARAMETERS..........................................................................................20
ENTERING METEOROLOGICAL DATA:...............................................................................................21
RUNNING HEC-HMS...................................................................................................................21
CHAPTER 3.0 MODELING A RESERVOIR IN HEC-HMS...................................................24

3.1
3.2
3.3
3.4
3.5
DEFINING A RESERVOIR IN COMBINATION WITH ROUTING.................................................................24

SETTING UP THE RESERVOIR ROUTING PARAMETERS.........................................................................24
ENTERING THE METEOROLOGICAL DATA.........................................................................................25
RUNNING HEC-HMS...................................................................................................................25
CONCLUSION..................................................................................................................................29
CHAPTER 4.0: MODCLARK METHOD IN HEC-HMS..........................................................30

4.1 DELINEATING WATERSHED..............................................................................................................30
4.2 COMPUTING THE CN USING LAND USE AND SOIL DATA......................................................................32
4.2.1 ADDING SOIL DATA AND MAPPING IT TO WMS COVERAGES...............................................................32
4.2.2 ADDING LAND USE DATA AND MAPPING IT TO WMS COVERAGES.........................................................33
4.3 CREATING MOD CLARK GRIDS.....................................................................................................33
4.4 ENTERING METEOROLOGICAL DATA................................................................................................34
4.5 CREATING HEC-HMS INPUT FILE.................................................................................................35
4.6 RUNNING HEC-HMS...................................................................................................................36
4.7 VIEWING RESULTS..........................................................................................................................37
CHAPTER 5: LONG TERM SIMULATION HEC-HMS..........................................................39
5.1 DELINEATING WATERSHED..............................................................................................................39

5.2 LONG TERM SIMULATION...............................................................................................................41
5.2.1 SETTING UP THE JOB CONTROL.......................................................................................................41
5.2.2 SETTING UP THE BASIN DATA PARAMETERS.....................................................................................42
5.2.3 EXPORTING SIMULATION TO HEC-HMS........................................................................................45
5.2.4 ENTERING SMA DATA INTO HEC-HMS........................................................................................45
5.2.5 ENTERING PRECIPITATION AND METEOROLOGIC DATA IN HEC-HMS..................................................46
5.2.6 RUNNING THE HEC-HMS SIMULATION AND VIEWING RESULTS........................................................50
5.3 ENTERING GAUGE DATA.................................................................................................................51
5.4 CALIBRATING THE HEC-HMS LONG-TERM SIMULATION...............................................................52
5.5 SHORT TERM ANALYSIS..................................................................................................................53
5.5.1 CONTROL SPECIFICATIONS..............................................................................................................54
5.5.2 ENTERING PRECIPITATION/METEOROLOGIC MODEL DATA..................................................................54
5.5.3 DEFINING BASIN MODEL DATA......................................................................................................56
5.5.4 RUNNING THE HEC-HMS SIMULATION AND VIEWING RESULTS........................................................57
5.5 CONCLUSION..................................................................................................................................58
Chapter 1: HEC-HMS Interface

1.1
Delineating Watershed
1. Open new instance of WMS

2. Open Judys_Branch_Data\DEM\Judys_branch.hdr which is the DEM data
3. Click OK and click Yes to accept coordinate conversion
4. Check on Edit Project coordinate system on the right side and change Horizontal
system to UTM NAD 83 (US) from the drop down box and change UTM Zone to
16. Make sure that the horizontal and vertical units are set to meters.
5. Click OK. This will bring the DEM to view.
6. Switch to Drainage Module and select DEM | Compute TOPAZ flow data
7. Click OK twice and click on Close button after the flow data is computed. It will
take some time depending on the size and resolution of DEM.
8. Locate the Outlet which is shown in the following figures. To locate the position of
outlet point, use the zoom tools.
9. Create an outlet point using Create Outlet feature tool and make sure that this point
is on the blue stream line. Coordinate of your outlet point should be at or close to
(239163, 4292351). First create the outlet point closer to the point shown in the
figure, and then edit the coordinates on the properties window at right side as shown
in the following figure for exact location.
10. Select DEM | Delineate Basins Wizard to create basin and stream arcs. Use
threshold value of 0.2 and click OK twice. The delineated basin will look like the
figure below:
11. Select DEM | Delete Null Basin Cells Data which will delete the DEM outside the
watershed and the watershed will look as shown in following figure. You might
need to click on Frame macro.
1.2
Single Basin analysis:
1.2.1
Setting up Job control
Most of the parameters required for a HEC-HMS model are defined for basins, outlets,
and reaches. However, there are some global parameters that control the overall
simulation and are not specific to any basin or reach in the model. These parameters are
defined in the WMS interface using the Job Control dialog.
1. Switch to the Hydrologic Modeling module

2. HEC-1 should be the default model, so change the default model to HEC-HMS by
selecting it from the drop down list of models found in the Edit Window
3. Select HEC-HMS | Job Control
4. Enter Judys Branch in the Name: field
5. In the Description: field you can enter Your name
By default the simulation is set to run for 24 hours starting from todays date at 15 minute
intervals. We want to run this simulation for 48 hours at 10 minute intervals.
6. Change the date as follows:
Starting Date: 08/23/2001
Starting Time: 12:00 AM
Ending Time: 08/25/2001
Ending Time: 12:00 AM
7. Change the Time interval to 10 Minutes
8. Select the Basin Options tab
9. Enter Judys Branch in the Name: field
10. Set the Basin Model Units to US customary (English), which should already be the
default.
Setting the computation units DOES NOT cause any units conversion to take place.
You are simply telling HEC-HMS that you will provide input units in English units (sq.
miles for area, inches for rain, feet/miles for length) and expect results of computation
to be in English units (cfs). If you specify Metric then you must ensure that input units
are metric (sq. kilometers, mm for rain, meters/kilometers for length) and results will be
in metric (cms).
11. Select the Meteorological Options tab
12. Enter Judys Branch Meteorologic Data in the Name: field
13. Select OK
1.2.2
Setting up the Meteorological Data
In HEC-HMS precipitation is defined separately in the Meteorological Data. This is

because of the ability of HEC-HMS to model long term simulations that require additional
information and often a lot more input.
1. Select HEC-HMS | Meteorological Parameters
2. Set the Precipitation Method to SCS Hypothetical Storm
3. Set the Storm Selection to Type II
4. Set the Storm Depth to 0.394 (inches)

5. Select OK
1.2.3
Setting up the Basin Data Parameters
In the first simulation you will treat the entire watershed as a single basin.
1. Select the Select Basin tool
2. Double-click on the brown basin icon labeled 1B. Double-clicking on a basin or
outlet icon always brings up the parameter editor dialog for the current model (in
this case HEC-HMS)
3. Notice that the area has been calculated (in this case in sq. miles because we are
performing calculations in English units).
4. Change the name to Judys instead of 1B.
5. Enter Main Branch in the description.
Displaying and Showing options allows you to see only those variables for which you wish
to enter data. For example in this case toggling on the Loss Rate Method allows you to pick
which method you want to use (in this case the method we want is the default). You then
toggle the display for the different parameters associated with a given methodology from
the show column. In our case we can now see in the Properties window the Loss Rate
Method and the parameters for the SCS Curve Number method.
The HMS-Properties window is versatile in that it allows you to see properties for all or a
selected basin, junctions, reaches and reservoirs, etc.
6. Toggle on the Display of the Loss Rate Method option
7. Toggle the SCS Curve Number from the Show column in the Display options
window
8. Enter an SCS Curve Number of 64. We will compute a CN value from actual land
use and soil files later.
For the SCS CN method initials losses are estimated as 20% of the maximum storage value
computed from the CN when the initial loss is zero. If you wish to override this
computation then you would enter a value other than zero. For now we will assume there is
no impervious area.
9. Toggle on the Display of the Transform option (you may have to scroll vertically in
the Display options window).
10. Show the SCS parameters by toggling this option on in the Display options
window.
11. Scroll horizontally in the Properties window and choose the Define button under
Compute Basin Data (the SCS transform method is the default)
12. Set the Computation Type to Compute Lag Time (the default)
13. Set the Method drop down list to SCS Method (near the bottom of the list)
14. Select OK to update the computed lag time for the SCS dimensionless method
(scroll horizontally to view if you would like)
15. Select OK
You now have all of the parameters set to run a single basin analysis.
1.2.4
Running HEC-HMS
Whenever you run an HEC-HMS simulation, you must save the information created in
WMS to HEC-HMS files and then load it as a project in HEC-HMS. This tutorial is not a
comprehensive review of HEC-HMS but should give you an idea of how to open a project
created by WMS, run an analysis and view some basic results.
Before going through the steps below, save your WMS project now by selecting File| Save
As. Doing this you are saving the DEM, the watershed you delineated, and other related
information. In the steps that follow, you will save HEC-HMS file which is different from
WMS project file because in HMS file you will be saving only some of the components of
WMS project that are required to run HEC-HMS. The HMS file you save will be used as
input file in HEC-HMS.
1. Select HEC-HMS | Save HMS file.

2. Change the HMS project file to Judys.
3. Start HEC-HMS 3.1.0 on your computer
4. Select File | Open.
5. Select the Browse button and browse to the location where you just saved your
HMS Project from WMS.
6. Select the Judys.hms project file
7. From the HEC-HMS project explorer expand the Basin Models, Meteorologic
Models and Control Specifications folders
8. Expand the Judys branch basin model and then select it
The basin model map should appear and your project explorer should look
something like the picture below.
9. Select Compute | Create Simulation Run, Change the name of the run if you want
(default is Run1). Click Next three times and then click finish. In those three Next
clicks you are confirming the Basin model, Meteorologic model and the Control
specifications that you defined in WMS interface to be used for this run.
10. Switch to compute tab in the project explorer window and expand Judys and
Simulation Runs. You will see
Run 1 as your macro name if you
did not rename it in step 9.

11. Right click Run 1 and select Compute.
12. When finished computing select Close
13. Switch to Results tab in project explorer and expand Simulation Runs. Click on Run
1 which will expand to show the basin components. If you click on sub basin icon
you can see the components of simulation runs. Click on each component to
see the results.
You now have a completed HEC-HMS simulation for a single basin and the resulting
hydrograph for the Judys sub basin element should look something like the one shown in
following figure.
17. You may continue to explore the HEC-HMS input parameters passed from WMS
and computed results or any other options
18. When finished exit HEC-HMS by selecting File | Exit
19. Select Yes when prompted to save the project.
1.3
Computing the CN using Land use and Soil data
In the previous tutorial, you used CN of 64. Now, you will calculate actual CN value
based on the soil and land use data. For this go back to your WMS project or open it
again if it was already closed.
1.3.1
Adding Soil data and mapping it to WMS coverages
1. Right click on the Coverages under map data and create two new coverages.
Change one of the coverages to Land use and another to Soil type. Now there will
be 3 coverages, Drainage, Soil Type and Land Use coverage respectively.
2. Click on Soil Type coverage and right click on GIS Layers and select Add
Shapefile data. Then browse to Judys_branch_data\Soil\ statsgo.shp which will add
land use GIS data to the view but it will not show up properly as the coordinate
system will not match. So, right click on statsgo.shp and click coordinate
conversion. Select original coordinate (convert from) to Geographic NAD 83 (US)
and vertical units to US survey Feet. Check on Edit project coordinate system and
select UTM NAD 83 (US). Be sure that UTM zone is 16 and both horizontal and
vertical unit is Meters. Click ok. This will bring the soil shape file over the
watershed. Zoom in to see the watershed.
3. Right click on statsgo.shp in GIS layers coverage and select join table to layer.
Then browse Judys_branch_data/soil/statsgoc.dbf. In the Join table dialog, make
sure that Shapefile join field and Table join field are both set to MUID and Table
data field is set to HYDGRP.
4. Use zoom tool to bring up your watershed to proper view if necessary and Click on
Select shapes tool
. Then draw a rectangle around your watershed using this tool
which will select the portion of soils data you will be using. Switch to hydrologic
modeling module and. Select Mapping | Shapes -> Feature Objects and click Next.
Make sure that field HYDGRP is mapped to SCS soil type. Click Next and click
Finish. Now you may turn statsgo.shp under GIS layers off by checking the check
box in the project explorer window.
5. This has mapped your GIS data to WMS Soil Type coverage.
1.3.2 Adding land use data and mapping it to WMS coverages

1. Click on Land Use Coverage and right click on GIS Layers on project explorer and
select Add Shapefile data. Then browse to Judys_branch_data\Landuse\
jb_luse_poly.shp which will add land use GIS data to the view.
2. Click on jb_luse_poly.shp in GIS layers and then use the select shapes tool
to
draw a rectangle around the boundary of basin. Then, select Mapping | Shapes ->
Feature Objects. Click on Next and be sure that LU_CODE is mapped to Land use
in the mapping wizard box. Click Next and click Finish. This will map your land
use data to WMS Land Use coverage. Now you may turn off the GIS layers by
checking off in the project explorer window.
3. Save your project.
1.3.3
Calculating CN for the watershed
Now the Soil Type and Land use data that you entered in previous steps will be used to
determine the CN value for the watershed.
1. Switch to Hydrologic Modeling module. Select Calculators | Compute GIS
attributes. In Computation box select SCS curve number and make sure that Land
use and Soil type coverages are mapped properly.
2. Click on import button at the bottom of the dialog box and then browse to
Judys_branch_data\scsland.tbl and click Ok twice. This will compute Composite
CN for the watershed. Now you can toggle the display of Soil Type and Land Use
coverages off in project explorer and click Frame macro
3. Go to display options and switch to Drainage data. Then check ON Basin CNs, and
click OK. When you make drainage coverage active, the CN value will be shown
on the display. Now, remember the value you used in previous tutorial, it was 64.
Now you found the correct value of CN for this watershed which is 69.5 (or closer
to this). WMS will map this CN value automatically to the basin properties dialog.
4. Save your WMS Project now because you will be using this project file for chapter
2 as well.
1.4
Running HEC-HMS
You can now run another simulation to compare the results with the modified CN value.
1. Switch to hydrologic Modeling Module and select HEC-HMS | Save HMS file.
2. Name the HMS project file JudysCN and Save
4. Select File | Open
6. Select the JudysCN.hms project file
8. Expand the Judys branch basin model and then select it. The basin model map
should appear and your project explorer should look something like the picture
below.

see the results.
You now have a completed HEC-HMS simulation for a single basin and the resulting
hydrograph for the Judys sub basin element should look something like the one shown in
following figure.
Chapter 2.0 Analyzing Sub-basins and Routing

You will now subdivide the watershed into two upper basins and one lower basin and
define routing for the reaches that connect the upper basins to the watershed outlet. You
can use the same WMS project file that you used for Chapter 1 (If you want to start over
again, repeat all the steps form 1.1 to 1.3 in Chapter 1 and continue the following steps.)
2.1
Delineating the Sub-basin
1. Select the Zoom tool

2. Create a zoom box around the region identified by a box in following figure
Figure: Zoom in on the area indicated by the rectangle.

3. Right-click on the Drainage coverage in the Project Explorer and select Display
Options
4. On the Map tab toggle on Vertices
5. Select OK
6. Switch to the Drainage module

7. Select the Select Feature Vertex tool
8. Select the vertex that is just below the main branching point you just zoomed in
around
9. Select DEM | Node <-> Outlet

You created the outlet point just below the branch in order to have a single upstream basin.
If you wanted a separate basin for each upstream branch you could define the branching
node to be an outlet. Thus, WMS would automatically assume that you want separate
basins for each branch, so we have created a node just downstream of the branch and
defined it as the outlet for the upper basin.
10. Select the Frame macro
11. Select DEM | Delineate Basins Wizard and click OK.
12. Type threshold value as 0.2, select OK to delete and recreate feature data
13. Select OK
14. Select OK
15. Your watershed should look something like this but the curve numbers will be 0 for
both sub basins.
2.2
Updating the Basin Parameters
You will have to re-compute the CN values and define precipitation and lag time for the
basins.
1. Select the Hydrologic Modeling module
2. Select Calculators | Compute GIS Attributes
3. Select OK and the CN values will be updated for both basins.
5. Double-click on the right basin icon to bring up the HMS Properties dialog
6. Set the Show: option to All from the drop down list at the top of dialog box.
7. Change the name of the right basin to Right

8. Change the name of the upper left basin to Left
9. Toggle on the Display of the Loss Rate Method and Show SCS Curve Number
Because the CN values have been computed automatically you do not need to
change anything here.
10. Toggle on the Display of Transform methods and Show SCS
11. For each basin choose the Define button under Compute Basin Data and define the
equation and use the Compute Lag Time computation method with the SCS Method
You should now have a computed lag time for each basin.
12. Select OK
2.3
Setting up the Routing Parameters
If you were to run HEC-HMS right now (you can if you want), you would see that the
hydrographs from the upper basins would be combined with the lower basin hydrograph at
the watershed outlet without any lag or attenuation because you have not yet set the routing
parameters. You will now define a routing method, which will instruct HEC-HMS to
compute lag and attenuation on the upper basin hydrographs before adding them to the
lower hydrograph.
Routing for a reach is always defined at the upstream outlet of the reach in WMS.
1. Select the Select Outlet tool
2. Double-click on the outlet (the yellow circle icon) of the right basin
3. Make sure the Type field at the top left of the dialog is set to Reaches and set the
Show option to Selected (so that only the top right outlet will be displayed on HMS
properties dialog).
4. Toggle on the Display of Method and Show Muskingum Cunge Std.
5. In the Properties area, change the Routing Method to Muskingum Cunge Std.
6. Make sure that the Cross Section Shape is set to Trapezoidal and set the bottom
width field to be 5 (five feet wide)
7. Set the side slope value to be 1 (1:1 side slope)
8. Set the Mannings roughness (N) to be 0.05 (this is fairly rough, but we want to
exaggerate the routing effects for this exercise)
9. Select OK
10. Save your WMS project now.
2.4
Entering Meteorological Data:
For both the sub basins, we will assume same rainfall distribution. So, enter the
following data:
2. Set the Precipitation Method to SCS Hypothetical Storm for both sub basins
3. Set the Storm Selection to Type II for both sub basins
4. Set the Storm Depth to 3.0 (inches) for both sub basins
5. Select OK
2.5
Running HEC-HMS
You now have everything defined to run a two basin HEC-HMS analysis that includes
routing the upper basins through the reaches connecting them to the watershed outlet.
1. Select HEC-HMS | Save HMS File
2. Name the HMS project file JudysRoute and Save
6. Select the JudysRoute.hms project file
8. Expand the Judys branch basin model and then select it. Your Basin Model will
look something like this:

see the results. Outlet of the basin will be named 4C.
You now have a completed HEC-HMS simulation for two sub basins with routing and the
resulting hydrograph for the Judys basin element should look something like the one shown
in following figure.
Chapter 3.0 Modeling a Reservoir in HEC-HMS

There is an existing small reservoir at the outlet of the Right basin. It has a storage capacity
of 1000 ac-ft at the spillway level and 1540 ac-ft at the dam crest.
3.1
Defining a Reservoir in Combination with Routing
One of the routing methods available in HEC-HMS is Storage routing, which can be used
to define reservoir routing. In this case we can route the hydrograph through the reservoir
before routing it downstream.
Open your existing WMS project that you developed for Chapter 2.
1. Switch to Hydrologic Modeling Module and select HEC-HMS.
Then Select Outlet tool
2. Select the outlet of the right basin
3. Right-click on the outlet and select Add | Reservoir
3.2
Setting up the Reservoir Routing Parameters
In order to define reservoir routing with HEC-HMS you must define elevation vs. storage
(storage capacity curve) and elevation vs. discharge rating curves. You can enter values
directly, or enter hydraulic structures and compute the values, but in this exercise you will
enter the values directly. You will use the same elevation values for both curves.
For this example we want to have no outflow until the elevation in the reservoir reaches the
spillway. Since HEC-HMS linearly interpolates between consecutive points on the
elevation-discharge and elevation-volume curves we will trick it by entering two points
on the curves at essentially the same elevation (149.99 ft and 150 ft) with the first having
no outflow and the second having the discharge over the spillway (300 cfs) as defined for
this dam.
1. Double-click on the reservoir outlet point (it is now represented as a triangle since
you have defined a reservoir at this location)
2. Change the Reservoir name to Judys.

3. Set the Method drop down to be Storage-Elevation-Outflow
You need to input to define reservoir routing is the initial conditions of the reservoir. The
initial condition can be defined as an elevation, a discharge, or a volume. For this example
we will set the initial condition to an elevation four feet below the top of the spillway (the
spillway corresponds to elevation 150).
4. Set the Initial drop down to be Elevation
5. Enter 147 for the Initial Value.
WMS has the interface to enter the storage-elevation-discharge data for HMS project but
currently this interface works only for the older versions of HSC-HMS (i.e. version 2.2.2).
At this point it is being updated and for this tutorial we will enter these data in the HECHMS interface itself.
6. Select OK and save your WMS project at this stage.
3.3
Entering the Meteorological Data
For both the basins, we will assume the same rainfall distribution, so select the following
Meteorological parameters.
2. Set the Precipitation Method to SCS Hypothetical Storm
3. Set the Storm Selection to Type II
4. Set the Storm Depth to 3.0 (inches)
5. Select OK
3.4
Running HEC-HMS
Be sure that the basin data are defined for both the left and right basins. If not refer to
Chapter: 2, 2.2.Updating the basin parameters. You now have everything defined to run
a two basin HEC-HMS analysis that includes routing the upper basins through the reaches
connecting them to the watershed outlet.
1. Select HEC-HMS | Save HMS File.

2. Name the HMS project file JudysReservoir and Save. You will get an error message
stating that No data has been defined. Please define a start date and try again. This
error is because we have not entered all the data required for HMS file. So, at this
point you can neglect this error. Hit OK.
5. Select the Browse button and browse to the location where you just saved your HMS
Project from WMS.
6.
Select the JudysReservoir.hms project file
8. Expand the Judys Branch basin model and then select it
Now we need to define storage-elevation-storage data for this simulation. Expand Basin
Models and click on reservoir icon named as Judys
in the project explorer
window.
9. Now under reservoir tab, set Initial Condition to Elevation and the Initial Elevation
should itself map to 147 ft (enter 147 ft if it does not).
10. Select Components | paired Data Manager.
11. Chose Storage-Discharge-Functions for Data Type and click New. Enter
StorageDischarge for the Name and click Create.
12. Again Chose Elevation-Storage-Functions for Data Type and click New. Enter
ElevationStorage for the Name and click Create.
13. Close Paired Data Manage dialog.
Now you can see Paired data mapped in the project explorer window and expand both
storage-discharge and elevation-storage folders.
14. Click on StorageDischarge and then below project explorer under Paired Data tab,
select Manual Entry for Data source and AC-FT: CFS to unit.
15. Switch to Table tab and type the following table into the cells. The table will
expand itself as you keep typing the values.
Storage (AC-FT)
0
350
650
1000
1000.01
1540
Discharge (CFS)
0
0
0
0
300
550
You can see the plot of Storage-Discharge curve from the Graph tab next to Table tab.
16. Select ElevationStorage under Paired data in Project explorer and in paired data tab
select Manual Entry for Data source and FT: AC-FT for the Units.
17. Switch to Table tab and type the following table into the cells. The table will
expand itself as you keep typing the values.
Elevation (FT)
141
144
147
149.99
150
154
Storage (AC-FT)
0
350
650
1000
1000.01
1540
You can see the plot of Storage-Discharge curve from the Graph tab next to Table tab.
At this point you have defined the Storage-Discharge and Storage-Elevation data. Now you
need to set it up so that the reservoir defined earlier uses this data for reservoir routing.
18. In the project explorer, expand Judys Branch under basin Models and select the
reservoir named as Judys
. Then below project explorer, select
StorageDischarge for Stor-Dis Function and select ElevationStorage for Elev-Stor

Function.
19. Select Compute | Create Simulation Run and click Next 3 times and click Finish.
20. Switch to compute tab in the project explorer and expand Simulation Runs under
JydysReservoir. Right click Run 1 Compute Current Run macro
and select
Compute.
see the results. Outlet of the basin will be named 4C.
You now have a completed HEC-HMS simulation for two sub basins with reservoir routing
and the resulting hydrograph for the Judys sub basin element should look something like
the one shown in following figure.
3.5
Conclusion
This concludes the exercise defining HEC-HMS files and displaying hydrographs. The
concepts learned include the following:
Entering job control parameters
Defining basin parameters such as loss rates, precipitation, and hydrograph methodology a
watershed analysis
Defining routing parameters
Routing a hydrograph through a reservoir
Saving and running HEC-HMS simulations
Chapter 4.0: MODClark Method in HEC-HMS

4.1

16. Make sure that the horizontal and vertical units are set to meters.
5. Click OK. This will bring the DEM to view.
6. Switch to Drainage Module and select DEM | Compute TOPAZ flow data
7. Click OK twice and click on Close button after the flow data is computed. It will
take some time depending on the size and resolution of DEM.
9. Create an outlet point using Create Outlet feature tool and make sure that this point
is on the blue stream line. Coordinate of your outlet point should be at or close to
in the following figure for exact location.
10. Select DEM | Delineate Basins Wizard to create basin and stream arcs. Use
threshold value of 0.2 and click OK twice. The delineated basin will look like the
figure below:
11. Select DEM | Delete Null Basin Cells Data which will delete the DEM outside the
watershed and the watershed will look as shown in following figure. You might
need to click on Frame macro.
4.2
4.2.1
Computing the CN using Land use and Soil data

Adding Soil data and mapping it to WMS coverages
1. Right click on the Coverages under map data and create two new coverages.
Change one of the coverages to Land use and another to Soil type. Now there will
be 3 coverages, Drainage, Soil Type and Land Use coverage respectively.
2. Click on Soil Type coverage and right click on GIS Layers and select Add
Shapefile data. Then browse to Judys_branch_data\Soil\ statsgo.shp which will add
land use GIS data to the view but it will not show up properly as the coordinate
system will not match. So, right click on statsgo.shp and click coordinate
conversion. Select original coordinate (convert from) to Geographic NAD 83 (US)
and vertical units to US survey Feet. Check on Edit project coordinate system and
select UTM NAD 83 (US). Be sure that UTM zone is 16 and both horizontal and
vertical unit is Meters. Click ok. This will bring the soil shape file over the
watershed. Zoom in to see the watershed.
3. Right click on statsgo.shp in GIS layers coverage and select join table to layer.
Then browse Judys_branch_data/soil/statsgoc.dbf. In the Join table dialog, make
sure that Shapefile join field and Table join field are both set to MUID and Table
data field is set to HYDGRP.
4. Use zoom tool to bring up your watershed to proper view if necessary and Click on
Select shapes tool
. Then draw a rectangle around your watershed using this tool
which will select the portion of soils data you will be using. Switch to hydrologic
modeling module and. Select Mapping | Shapes -> Feature Objects and click Next.
Make sure that field HYDGRP is mapped to SCS soil type. Click Next and click
Finish. Now you may turn statsgo.shp under GIS layers off by checking the check
box in the project explorer window.
5. This has mapped your GIS data to WMS Soil Type coverage.
4.2.2 Adding land use data and mapping it to WMS coverages

1. Click on Land Use Coverage and right click on GIS Layers on project explorer and
select Add Shapefile data. Then browse to Judys_branch_data\Landuse\
jb_luse_poly.shp which will add land use GIS data to the view.
2. Click on jb_luse_poly.shp in GIS layers and then use the select shapes tool
to
draw a rectangle around the boundary of basin. Then, select Mapping | Shapes ->
Feature Objects. Click on Next and be sure that LU_CODE is mapped to Land use
in the mapping wizard box. Click Next and click Finish. This will map your land
use data to WMS Land Use coverage. Now you may turn off the GIS layers by
checking off in the project explorer window.
3. Save your project.
4.3
Creating MOD Clark Grids
1. Switch to Map Module
and Select Feature Polygon
. Then right click on the
basin and select Create Grid and select No, for not selecting GSSHA grid. That
way, WMS will create MOD Clark grid cells.
2. Choose number of cells to be 100 and 100 on both X and Y dimensions and click
OK.
3. Click Ok to interpolate background elevation from DEM.
4.4
Entering Meteorological Data
1. Select HEC-HMS | Meteorologic Parameters. You will now input the precipitation
data.
2. Select User Hyetograph as the Precipitation Method.
3. Type in 3.0 inches as the total depth.
4. Select the XY Series button.
5. Select the Import button, and import the scstabs.xys file from Judys_Branch_Data
folder.
6. Use the Type II, 24 hour curve. The XY Series Editor should look like this:
7. Select OK in the XY Series Editor Dialogue box.

8. Select OK in the HMS Meteorological Model dialogue box.
4.5
Creating HEC-HMS input file
1. Switch to Hydrologic Modeling Module and in the model selector, select HECHMS from the combo box. In HEC-HMS menu, select HMS Job Control. In control
info tab, Change the name from WMS control info to Judys Branch. Change
starting date to 08/23/2001 and ending date to 08/25/2001 and starting and ending
time both to 12:00:00/PM and change time interval to 10 minutes. In basin options
and Meteorological Options change name to Judys_Branch and click OK.
2. Select HEC-HMS | Compute HMS grid Parameters. In grid computation option
check on SCS Curve number. Make sure that the soil type and land use coverages
are properly allocated. Check if the mapping table shows some values. If the table is
blank, you have to import the table. Browse to Judys_Branch_Data/scsland.tbl.
Select the file and click Open. Then you can see values in the mapping field. Click
OK. This will compute CN value for each grid cells.
3. Some of the cells might have 0 CN values, so you have to replace those values with
the CN in neighboring cells. In project explorer, under 2D grid data, right click on
Curve number and select Properties. Select Edit Values and in the spreadsheet, if
any value under the column f is 0, replace it with the values in neighboring rows.
You might have to replace a couple of hundreds of the values. You may use excel
spreadsheet for quick replacement. Then click OK twice and save your project.
4. Switch to hydrologic modeling module and select HEC-HMS again (if necessary).
Click on Select basin tool and click on the basin icon. Now, in HEC-HMS menu,
select Edit parameters. Check on Loss Rate and choose Gridded SCS curve number.
Similarly, check on Transform and choose MODClark.
5. In Properties area, Change the Loss Rate method to Gridded SCS curve number
from the drop down box.
6. Enter 0.2 for initial abstraction (20% of the precipitation will be absorbed by the
watershed), and a potential retention scale factor of 1.0. These numbers will be
used for the purposes of this tutorial only different numbers may apply to the
specific characteristics of other watersheds you are modeling.
7. In the properties area, select MODClark as the Transform method and click Define
button under Compute Basin Data.
8. In the Basin Time Computation window, select the ADOT method (Urban). This
method works for areas that can be defined as Urban. Make sure you use whatever
method is appropriate for the watershed you are modeling.
9. Select OK, and then OK again in the HMS Property Dialogue.
10. Select HEC-HMS | Save HMS File. Save your file as JudysMODClark.hms. You
should see several screens pop up on your computer as WMS is saving the HMS
file. This may take a few minutes depending on how many grid cells you have
chosen. You have completed setting up your model in WMS, and can now access
the newly created file to compute the data in your HMS program.
4.6
Running HEC-HMS
1. Open
HEC-HMS
3.1.0
from
start
menu.
Open
the
file
you
saved
(JudysMODClark.hms) and expand Basin models, Meteorologic models, control

specifications etc on the project explorer window.
2. Switch to Compute tab on the project explorer window. Select Compute | Create
simulation run. Click Next, Next, Next and finish. You will see Run1 under
Judys_branch\Simulation runs in the project explorer. Right click Run1 and select
Compute. Close the simulation status box after 100% is reached. Compute run1
again as sometimes it might not complete properly. If the computation is not
working properly, check the errors listed there.
4.7
Viewing Results
1. Switch to Results tab, expand simulation Runs and click on Run1. It will expand to
Global summary, 1B and 2C. You can see the flow summary by clicking on Global
summary.
2. Similarly, if you click 1B, it will expand to summary, outflow and so on. You can
see various flow parameters by clicking on the corresponding names under 1B.
Your outflow hydrograph should looking something like this:
3. You can see the time series data of your simulation by clicking View Time series
button
at the end of menu bar.
4. Save the project before you exit.
Chapter 5: Long Term simulation HEC-HMS

5.1

16.
5. Click OK
6. Switch to Drainage Module and select compute TOPAZ flow data under DEM
menu.
7. Click OK twice and click on Close button after the flow data is computed.
9. Create an outlet point using Create Outlet feature and make sure that this point is on
the blue stream line. Coordinate of your outlet point should be at or close to
in the figure for exact location.
11. Create basin and stream Arcs using the delineate basin wizard. It can be found in
DEM menu. Use threshold value of 0.2 and click OK twice. The delineated basin
will look like the figure below:
12. On DEM menu, click Delete Null Basin Cells data and the watershed will look as
shown in following figure
5.2
Long Term Simulation
For this HEC-HMS simulation, you will perform a long-term analysis for the watershed
you have delineated. The SMA (Soil Moisture Accounting) loss method, the Clark
transform method, and the Linear Reservoir baseflow method can be used to account for
the movement of water in a watershed during long-term simulations. Before entering these
values, we will first set up the Job Control (or global) data for this simulation.
5.2.1 Setting up the Job Control

There are many global parameters that control the overall simulation and are not specific
to any basin or reach in the model. These parameters are defined in the WMS interface
using the HMS Job Control dialog.
1. Select the Hydrologic Modeling module
2. Select HEC-HMS from the drop down list of models found in the Edit Window
3. Select HEC-HMS | Job Control
4. In the Control Options tab, enter Judys Branch for the name.
5. For the starting time and date, enter August 23, 2001, 12:00 AM.
6. For the ending time and date, enter September 20, 2001, 12:00 AM. This starting
and ending time will be used to indicate the duration of simulation in HEC-HMS,
not the duration for which the rainfall data will be entered. This difference will be
clearer later on as you proceed through the tutorial.
7. Select a time interval of 5 minutes.
8. Switch to the Basin Options tab and enter Judys Branch for the name.
9. Switch to the Meteorological Options tab and enter Judys Branch Meteorologic
Data for the name. Turn ON the option to include evapotranspiration method in the
meteorologic model. This option needs to be on and evapotranspiration data values
need to be defined for long-term simulations.
10. Select OK on the HMS Job Control dialog.
For now, we will leave the other Job Control settings at their default values.
5.2.2 Setting up the Basin Data Parameters

2. Double-click on the brown basin icon labeled 1B. Double-clicking on a basin or
outlet icon always brings up the parameter editor dialog for the current model (in
this case HEC-HMS)
3. Observe the layout of this dialog. The top part can be used to display different
entities in the hydrologic tree. You can also show only the selected entities or all of
them. The Display Options portion of the window is used to control which HMS
parameters are displayed. To display the SMA loss rate method data, first turn the
Loss Rate Method box on and then turn the SMA box on. The corresponding
data values show in the Properties window at the bottom of the dialog. The
Properties portion of the HMS Properties dialog is used to set the basin data itself.
For example, set the Loss Rate Method field in the Properties section to SMA.
Notice that all the SMA Fields become undimmed so you can enter data.
4. SMA parameters are defined using SMA units in WMS and values are entered in
HMS. To create a new SMA unit, select the Define button under Define SMA
Unit.
You could enter the SMA data here but the WMS interface needs to be updated for
version 3.1.0 of HMS. It works fine for HMS 2.2.2. But for this tutorial we will be
using HMS 3.1.0. So, some of the data should be entered directly in HMS interface. We
will do this in later steps.
5. In the Land Use Mapping dialog, turn OFF SCS CNs and turn ON SMA Unit
in the Display parameters section.
6. If there is no Land use type listed on WMS land use ID box, then select Add land
use ID to list. If Land ID 1 is already there then you do not have to add.
7. Select the Apply button.

8. Enter the following values for the SMA method in the Properties area of HMS
Properties dialog box:
SMA Unit: Judys Branch SMA
% Impervious: 0.0
% of Canopy Capacity: 10.0
% of Surface Capacity: 10.0
% of Soil Capacity: 60.0
% of Groundwater 1 Capacity: 20.0
% of Groundwater 2 Capacity: 20.0
10. In the Display options section of the HMS Properties dialog, turn the Transform
box on and then turn the Clark box on. Turn on the Base Flow box and turn on
Linear Reservoir.
11. In the Properties portion of the HMS Properties dialog set the Transform Method to
Clark. Set the Baseflow Method to Linear Reservoir.
12. Enter the following data into the HMS Properties dialog:
Time of Concentration: 7.13
Storage Coefficient: 85.0
Groundwater 1 Storage Coefficient: 20.0
Groundwater 1 Number of Reservoirs: 2.0
Groundwater 2 Storage Coefficient: 1.0
Groundwater 2 Number of Reservoirs: 2.0
13. Select OK on the HMS Properties dialog.
You now have all of the basin parameters to run a long-term analysis. You will still need to
go to the HEC-HMS program to finish entering Meteorologic data and SMA data to run
and calibrate your HMS simulation.
5.2.3 Exporting Simulation to HEC-HMS

To run your HMS project, you will need to export the data you have defined in WMS to
HMS. This section will guide you through the process of doing this.
1. Select HEC-HMS | Save HMS File
2. Enter Judys.hms for the name for the HMS file; note the directory you are saving
the file to, and select Save. You might get an error message because we have not
yet defined Meteorologic and SMA data. Just click OK, the file will be saved with
the parameters you defined.
3. Start up the HEC-HMS program and perform the
following commands in HEC-HMS
4. Select File | Open Project
5. Select the Unlisted Project tab.
6. Browse to the directory containing the HMS project
you saved from WMS.
7. Select the Judys project ID, the HMS file
exported from WMS will be read into HMS.
5.2.4
HMS
Entering SMA data into HEC-
1. Expand the basin models, Meteorological Models

and Control Specifications under Judys in the
project explorer window. Again expand Judys
Branch under Basin Models. Click on Judys Branch
SMA to expand it as shown in the figure. Then you
can see 5 tabs just below the project explorer
window (See the figure).
2. Enter the following values by clicking the Loss tab.
The values for other 4 tabs are already defined in
WMS. You can check those tabs too.
Canopy Storage: 0.1 inches

Surface Storage: 0.25 inches
Maximum Infiltration: 0.3 inches/hour
Soil Storage: 20.0 inches
Tension Storage: 9.0 inches
Soil Percolation: 0.1 inches/hour
Groundwater 1 Storage: 5.0 inches
Groundwater 1 Percolation: 0.1 inches/hour
Groundwater 1 Coefficient: 50 hour

Groundwater 2 Storage: 5.0 inches
Groundwater 2 Percolation: 0.0 inches/hour
Groundwater 2 Coefficient: 200 hour

3. Switch to another tab so that the data is stored and font floor changes to black from
blue if you switch back to Loss tab and view the data.
4. Go to Baseflow tab and enter 1 cfs for both GW 1 initial and GW2 initial. These
values are used to initiate simulation.
5. Save your HMS project.
You have now entered all the SMA data required for long term simulation.
5.2.5
Entering Precipitation and Meteorologic data in HECHMS
Currently, precipitation data cannot be entered and exported to HMS from WMS. In the
near future, however, WMS will support entering and exporting precipitation
(Meteorologic model) data. Currently, your Meteorologic model must be defined in HECHMS. Perform the following steps in HEC-HMS to define your Meteorologic model:
1. Select Components | Time Series Data Manager.
2. In the time Series Data Manager Dialog, select Precipitation Gages for Data Type
and click on New. Enter name as Judys and give description to precipitation data if
you want and click Create. Close the Data manger dialog.
3. Expand Time series data and Precipitation Gages in the project explorer window.
You can see Judys under Precipitation gages and if you further expand Judys, you
can see the time range. You should redefine this time range. We will do it in the
next step.
4. You can see four tabs below the project explorer window. In Time-Series gage tab,
change the data to:
Data Source: Manual Entry
Units: Incremental Inches
Time Interval: 5 mins
5. Switch to Time Window tab to see the time range. Change to following:
Start date: 23Aug2001
Start Time: 12:00
End Date: 30Aug2001
End Time: 12:00
This time range specifies the duration for which precipitation data will be entered.
6. Switch to Table tab, here you can see the spreadsheet set up for the time range you
specified (in 5mins interval). You are now ready to enter the precipitation data.
7. Using Windows Explorer, browse to Judys_branch_data, locate and open the file
precip.txt in Windows Notepad.
8. In Notepad, select Ctrl+A to select all the text in this file. Select Ctrl+C to copy this
selected text. Go back to the HMS Gage Data Editor window, select the first
editable row at the top of the window, and select Ctrl+V to paste the text to this
window. This will enter the precipitation values over the period defined in the time
range into this editor. Select the Plot tab and you should see a plot of the
incremental precipitation that looks something like the following image:
The precipitation for the Judys Branch gage has now been entered into HMS. The next step
is to specify how this gage is used in the meteorologic model.
7. Click on Judys Branch Meteorologic data under Meteorologic Models in the project
explorer window. Select Meteorology Model tab below project explorer.
8. Change Precipitation to Specified Hyetograph. This will allow us to enter a single
gage for the entire watershed. If multiple gages existed in the watershed, you could
use the User Gage Weighting option.
9. In the Evapotranspiration field, select Monthly Average and leave other field to
the default (None to snowmelt and US Customary to Unit System) . Doing this will
add Judys Branch SMA under Meteorologic Model and if you expand it you will
see Monthly Average there as shown in the following figure. Click on Monthly
average in the project explorer then you can see Evapotranspiration tab below it
where you will fill the ET data.
10. Using Windows Explorer, browse Judys_branch_data, locate and open the file
evapotrans.txt in Windows Notepad.
11. In Notepad, select Ctrl+A to select all the text in this file. Select Ctrl+C to copy this
selected text. Go back to the HMS Meteorologic Model, Evapotranspiration tab,
select the first row at the top of the Rate (IN/MONTH) column in the window, and
select Ctrl+V to paste the text to this window.
12. Use the same procedure in as in step 11 to paste the data
from the pancoeff.txt file into the Pan Coefficient
column of the HMS Meteorologic Model dialog.
13. Save the HMS Project to accept data change. You are
now finished entering your precipitation and the data for
your meteorological model.
14. Click on Specified Hyetograph under Judys Branch
Meteorologic Data in the project explorer window.
Then you will see Subbasins tab below project explorer
window. Select Judys for the gage name for Judys
branch SMA. See the figure. By doing this you defined
the long term precipitation data that you entered and named as Judys to be used as
your precipitation data. Save the project again.
5.2.6 Running the HEC-HMS Simulation and Viewing Results

Now that you have exported your model and defined your meteorologic model and SMA
values, you can run the HEC-HMS simulation. To do this, perform the following steps:
1. In the HMS Project Definition window, select Compute | Create simulation Run and
click Next three times and then click Finish.
2. Switch to Compute tab in the project explorer window and expand Simulation
Runs. There you will see Run1.
3. Right click Run1 and select Compute.
4. HEC-HMS should run to completion. When it is done running, Compute
Successful should appear in the dialog. If any other thing appears, you should
select the View Log button to discover what the error was and how to fix it. If
Compute Successful appears, select the Close button.
5. Select the Close button in the HMS Run Manager.
To this stage you entered the available data and simulated the runoff at the outlet specified.
But, HMS allows you to enter the measured runoff data (if you have) so that you can
calibrate your model to match with the measured gage data. You will now enter
information on observed data from a gage at the watershed outlet.

WMS HMSInterface Tutorial

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

WMS HMSInterface Tutorial

Caricato da

Copyright:

Formati disponibili

Tutorial for Modeling Judys Branch data on HEC-HMS Single

DELINEATING THE SUB-BASIN..........................................................................................................17

CHAPTER 3.0 MODELING A RESERVOIR IN HEC-HMS...................................................24

DEFINING A RESERVOIR IN COMBINATION WITH ROUTING.................................................................24

CHAPTER 4.0: MODCLARK METHOD IN HEC-HMS..........................................................30

5.1 DELINEATING WATERSHED..............................................................................................................39

Chapter 1: HEC-HMS Interface

1. Open new instance of WMS

Single Basin analysis:

Setting up Job control

1. Switch to the Hydrologic Modeling module

Setting up the Meteorological Data

In HEC-HMS precipitation is defined separately in the Meteorological Data. This is

4. Set the Storm Depth to 0.394 (inches)

Setting up the Basin Data Parameters

1. Select HEC-HMS | Save HMS file.

Simulation Runs. You will see

Run 1 as your macro name if you

did not rename it in step 9.

19. Select Yes when prompted to save the project.

Computing the CN using Land use and Soil data

Adding Soil data and mapping it to WMS coverages

. Then draw a rectangle around your watershed using this tool

1.3.2 Adding land use data and mapping it to WMS coverages

Calculating CN for the watershed

Simulation Runs. You will see

Run 1 as your macro name if you

did not rename it in step 9.

Chapter 2.0 Analyzing Sub-basins and Routing

Delineating the Sub-basin

1. Select the Zoom tool

Figure: Zoom in on the area indicated by the rectangle.

6. Switch to the Drainage module

9. Select DEM | Node <-> Outlet

Updating the Basin Parameters

7. Change the name of the right basin to Right

Setting up the Routing Parameters

Entering Meteorological Data:

Simulation Runs. You will see

Run 1 as your macro name if you

did not rename it in step 9.

Chapter 3.0 Modeling a Reservoir in HEC-HMS

Defining a Reservoir in Combination with Routing

Setting up the Reservoir Routing Parameters

2. Change the Reservoir name to Judys.

Entering the Meteorological Data

1. Select HEC-HMS | Save HMS File.

Select the JudysReservoir.hms project file

in the project explorer

. Then below project explorer, select

StorageDischarge for Stor-Dis Function and select ElevationStorage for Elev-Stor

Entering job control parameters

Defining routing parameters

Routing a hydrograph through a reservoir

Saving and running HEC-HMS simulations

Chapter 4.0: MODClark Method in HEC-HMS

1. Open new instance of WMS

Computing the CN using Land use and Soil data

. Then draw a rectangle around your watershed using this tool

4.2.2 Adding land use data and mapping it to WMS coverages

Creating MOD Clark Grids

1. Switch to Map Module

and Select Feature Polygon

. Then right click on the