Distributed Hydrology Soil Vegetation Model

---

 

Documentation

As a research model, documentation for DHSVM is limited and subject to change. However, the goal is to make the documentation complete enough to enable users to implement their model without direct assistance from us. If you find that the documentation does not match what the model does, if certain features are undocumented, or if you would like to add documentation based on your own experience, we would like to hear from you. Please see the information under DHSVM - Contacts on how to contact us.

• Model Overview
• Tutorials
• Frequently Asked Questions!
• Model Input Files
• Processing of Input Files
• Model Output
• Processing of Output Files (examples)

---

DHSVM Overview

A brief summary of the main features of DHSVM is presented. Details are available in the publications section.

Back to top

---

Tutorials

A tutorial is now available for DHSVM.  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 feel that additional information would improve the tutorial and have specific suggestions and further model instructions, feel free to contact the administrator.   Contact information is available under DHSVM - Contacts. Unfortunately, we are not able to provide any further instructions on running the model.

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 extention) which is needed to run the sediment model and to define the specific events to be specified in the sediment control file. 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.

- The GIS file processing (.bin files) is identical to 2.0.1 (same aml scripts, .c, etc).
- 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.
- If you use the sediment option, you might need an additionnal 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: here ( DHSVM 3 r2 version)

Tutorial for DHSVM 2.0

Instructions
Download the tutorial  (3.1 mb)
Access the processed input files here for checking your input files processing.

Back to top

---

Model Operation

Describes how to compile the source code, input requirements, and miscellaneous issues related to running the model

• Hardware requirements
• Compiling and running the source code
• Input requirements
• Miscellaneous issues

Back to top

---

Model Input

The following input files are part of a DHSVM application. Note that many input files are created using GIS and advanced skills are required. Some files are always required, but additional files may be needed depending on the options specified in the configuration file. This is specified in the description below:

• Sediment Model Configuration file
• Configuration file for DHSVM 2.0 and below
  
• Mask file    Note: 2-D data binary files are stored from NW->SE, incrementing across columns before down rows
• DEM file
• Soil type file
• Soil depth file
• Vegetation type file
• Meteorological station file
• Meteorological map files
• PRISM files
• Shading parameter files
• Wind model files
• Stream/road class files
• Stream/road network files
• Stream/road map files
• Travel time file
• Unit hydrograph file

To initialize the model, a number of model state files are required as well:

• Soil state file
• Snow state file
• Interception state file
• Channel state file
• Hydrograph state file

Back to top

---

Input Files Processing

Get started and do the input file processing in a few steps:

1. Get started
2. Process the map files
3. Create Stream and Soil input files
4. Create Model States

The following input files are required if using the road component, or the sediment and mass wasting model.
5. Create Road input files
6. Mass Wasting Model input files

Configuration files editing
7. Configuration file for DHSVM
8. Configuration file for WMW

Back to top

---

Model Output

There are a number of different types of output that the model can produce. In short, the following possibilities are available:

DHSVM hydrologic output

• Default output (these files are always produced)
• Model state files
• Network flow files
• Travel time based hydrograph file
• Optional output files

Sediment Module output

• Default output (these files are always produced)
• Network flow files
• Optional output files

Unless you change the code, in very brief the ASCII output files will contain ( Check the above link for more details about the variables) :

Aggregated.Values (default output file)
Date HasSnow OverSnow LastSnow Swq Melt PackWater TPack SurfWater TSurf
ColdContent EvapTot EPot0 EPot1 EPot2 EAct0 EAct1 EAct2 EInt0 EInt1
ESoil00 ESoil01 ESoil02 ESoil10 ESoil11 ESoil12 ESoil Precip IntRain0 IntRain1
IntSnow0 IntSnow1 RadBeam RadDiff SoilMoist0 SoilMoist1 SoilMoist2 Perc0 Perc1
Perc2 TableDepth SatFlow Runoff SoilTemp Qnet Qs Qe Qg Qst Ra IExcess (InfiltAcc)

Mass.Balance (default output file)
Date IExcess CanopyWater SoilWater Snow.Swq Soil.SatFlow ChannelInt RoadInt
CulvertReturnFlow Evap.ETot Precip Snow.VaporMassFlux Snow.CanopyVaporMassFlux
OldWaterStorage CulvertToChannel RunoffToChannel MassError

Stream.Flow ( network output file )
Date Discharge_for_station1 Discharge_for_station2 etc ( each columns corresponds to the "SAVE" markers in the streams.network.dat.

Road.Flow ( network output file )
Date Discharge_for_segment1 etc ( each columns is the discharge at the culvert with a "SAVE" marker in the road.network.dat file.)

Streamflow.Only and Road.Only ( network output file )
the first column is the date, and then each columns is the discharge at all the station or road segment where you wrote "SAVE" in the stream.network.dat row

AggregatedSediment.Values ( mass wasting model output file )
Date SatThick DeltaDepth Probability TotMassWasting TotMassDeposition TotSedToChannel Erosion
SedFluxOut OverlandInflow RdErosion RdSedToHill OverroadInflow

MassSediment.Balance ( mass wasting model output file )
Date MassWasting SedimentToChannel MassDeposition MWMMassError Sediment.Erosion
Road.Erosion RoadSed DebrisInflow SedimentOverlandInflow SedimentOverroadInflow
SedimentOutflow CulvertReturnSedFlow CulvertSedToChannel LastChannelSedimentStorage
SedMassError

failure_summary.txt ( mass wasting model output file )
Date avgnumfailures avgpixperfailure numlikelyfailedpixels which correspond to
"For each date that the mwm algorithm is run" "ave. no. of failures" "ave. no. of pixels per failure"
"total number of failed pixels with probability of failure greater than failure_threshold"

Sed.Stream.Flow and Sed.Road.Flow ( mass wasting model output file )
Date ChannelID TotalMass TotalOutflowConcentration SegmentID

Sed.Streamflow.Only and Sed.Roadflow.Only ( mass wasting model output file )
Date TotalOutflowConcentration_for_each_segment_with_a_marker_"SAVE"

saturation_extent.txt ( DHSVM output file )
Date Sat
The file is intended to screen for Mass Wasting dates to insert in the MWM configuration file
Saturation extent is the percentage of the number of pixels with a water table that is at least MTHRESH of soil depth

Back to top

---

Model Output Processing

Back to top

---