Skip to Main Content U.S. Department of Energy
Distributed Hydrology Soil Vegetation Model (DHSVM)

Tutorial & Datasets

Tutorials for different DHSVM versions are now available. The links below contain all input files required to run DHSVM, as well as detailed, step-by-step instructions. Because our goal is to make implementation of the model possible for users on their own, we welcome comments on this tutorial. If you have specific suggestions on how to improve the model instructions, feel free to contact the administrator. Unfortunately, we are not able to provide any further instructions on running the model.

Tutorial for DHSVM 3.1

DHSVM 3.1 for urban hydrologic processes is developed based on DHSVM 3.0. The adaptations to DHSVM 3.0 expand the model capabilities to applications in urbanized or partially urbanized areas.

The main changes in the configuration file:

For each defined land cover category (or VEGETATION type):

  • a fraction of impervious area (which can be extracted from land cover maps)
  • impervious areas that is controlled by storm water detention
  • a linear reservoir coefficient to described drainage from detention storage.

How to run DHSVM 3.1:

  • Set up the input configuration files (see example INPUT.3.1.SpringBrook)
  • Set up the input files (dem, veg, soil, stream, shadow, skyview). Download tutorials for detailed instructions.
  • Run the program find_nearest_channel.c (download) to generate the surface routing file. Click here for brief instructions.
  • If the sediment module or mass wasting option is going to be implemented, follow the instructions in the Tutorial for DHSVM 3.0 section.

Issues regarding DEM SINK REMOVAL: — ArcGIS tools calculate flow direction and distribute flow using an eight direction< approach (often referred to as D8) while DHSVM uses four flow directions (D4). Accordingly, in small-scale model applications, you may find surface water in some cells do not drain properly to the downstream cells.
In this 3.1 version, the elevation of identified sink cells is internally increased to the elevation of the lowest neighboring cell in order to form a downslope path.

Tutorial for DHSVM 3.0

In order to run the mass wasting option in the sediment model, the first step is to run the hydrological model with SEDIMENT option set FALSE. The hydrological run will output the file "saturation_extent.txt" (saturation extension) which is needed to run the sediment model and to define the specific events to be specified in the sediment control file. Then run DHSVM with SEDIMENT TRUE and Overland Routing KINEMATIC (instead of CONVENTIONAL) over the specified time periods. If you do not need the mass wasting option, you do not need to run DHSVM in 2 steps, just set SEDIMENT to TRUE from the start in the main control file.

Please check the input file processing section below for now.

  1. The GIS file processing (.bin files) is identical to 2.0.1 (same aml scripts, .c, etc).
  2. Use DHSVM 3.0 templates for the files that you had to edit manually before (stream.class.dat, road.class.dat, configuration files). Those are available in the input files processing section below.
  3. If you use the sediment option, you might need an additional DEM (higher resolution DEM). Just process it the same way you did for the other one. Rainy Creek 10 meter DEM to be used by the sediment option is available here.

As a test, you can find all the input files and output files as run in our lab: download from here.

Tutorial for DHSVM 2.0


Download the tutorial (3.1 mb)

Access the processed input files here for checking your input files processing.