Last Modified: 2026-09-24 10:17:47.261

Software Version

HEC-HMS version 4.15-beta.1 was used to create this tutorial. You will need to use HEC-HMS version 4.15, or newer, to open the project files.

Suggested Time

This tutorial should take approximately 5 to 10 minutes to complete.

Download the initial project files here:

NAB_West_Branch_Susquehanna_Initial.zip

Background

This tutorial and guide highlights the addition of internet basemaps to HEC-HMS version 4.15. Available tile sources include USGS Topo (default), USGS Shaded Relief, USGS Imagery, and USGS Imagery Topo. When added to a basin model and toggled on, these background layers are rendered in the Basin Map pane. Tiles are fetched asynchronously and saved to a two-level memory + disk cache. The disk cache is located under a {user directory}/tiles/internet folder. Cached tiles have a 30-day expiration date. If the cache size grows in excess of 500 MB, a warning dialog is presented to the user at startup with an option to clear the cache. 



Data

The project files in this tutorial and guide model Bald Eagle Creek (a tributary of the West Branch Susquehanna River) and the drainage area above Foster Joseph Sayers Dam (339 square miles). Foster Joseph Sayers Dam is located approximately one mile upstream from Blanchard, PA and 14 miles above the mouth at Lock Haven, Centre County, PA. The dam is an earth fill construction with a maximum height of 100 feet above the streambed and a top length of 6,835 feet. It has a gated outlet tunnel for the regulation of flood flows. The spillway, located in rock in a saddle adjacent to the left abutment, is uncontrolled. The reservoir has a storage capacity of 99,000 acre-feet at spillway crest and a drainage area of 339 square miles. The project was completed in 1969.

Adding Internet Basemap Imagery to an HEC-HMS Basin Model

  1. Open the project files in HEC-HMS version 4.15 or newer.
  2. Click View | Map Layers. Alternatively, you can right-click in the Basin Map pane and select Map Layers.
  3. In the Map Layers dialog, click Add Internet Map.
  4. There are four basemap tile services available. Select the default, USGS Topo.

  5. Using your mouse, click and drag within the Basin Map pane to pan around the watershed and surrounding areas. Use your mouse wheel or the Zoom Tool in the top menu to zoom in and out.
  6. As you pan around and zoom in and out, you should notice tiles being fetched to cover the extents of the Basin Map pane.
  7. Click View | Map Layers. In the Map Layers dialog, select the option to Change Internet Map. Then choose the USGS Imagery basemap source.
  8. In the Watershed Explorer, expand the WB_Susquehanna basin model and right click on the Foster Joseph Sayers Dam reservoir element. Select Zoom To.
  9. The Zoom To feature should automatically update the Basin Map view extents to center on the selected basin element.
  10. Save your project. Fetched tiles are saved to a cache in the user's directory similar to C:\Users\HEC\AppData\Roaming\HEC\HEC-HMS\tiles\internet.
  11. Notice that each of the basemap sources we selected have their own cache. Navigate into the usgs-topo cache directory. Cached tiles are organized by zoom level, x, and y and stored in PNG format. When reloading a project, HEC-HMS first looks in the cache directory for tiles covering the current Basin Map view extents before attempting to fetch them from the internet.

    File Management

    Cached tiles have an expiration date of 30 days from the time they are first downloaded. After expiration, HEC-HMS will refetch the tiles from the web. If the cache directory exceeds 500 MB, a warning dialog will appear upon project open with an option to clear the cache.