Skip to main content

PNNL

  • About
  • News & Media
  • Careers
  • Events
  • Research
    • Scientific Discovery
      • Biology
        • Human Health
        • Integrative Omics
        • Microbiome Science
      • Chemistry
        • Catalysis
        • Chemical Physics
      • Computational Research
        • Artificial Intelligence
        • Computational Mathematics & Statistics
        • Graph and Data Analytics
        • High-Performance Computing
        • Software Engineering
        • Visual Analytics
      • Earth System Science
        • Plant Science
        • Atmospheric Science
        • Terrestrial Aquatics
        • Subsurface Science
        • Ecosystem Science
        • Coastal Science
      • Materials Science
        • Solid Phase Processing
        • Science of Interfaces
        • Precision Materials by Design
        • Materials in Extreme Environments
      • Nuclear & Particle Physics
        • Dark Matter
        • Neutrino Physics
        • Flavor Physics
        • Fusion Energy Science
      • Quantum Information Science
    • Energy Resiliency
      • Electric Grid Modernization
        • Distribution
        • Transmission
        • Grid Architecture
        • Grid Analytics
          • AGM Program
        • Grid Cybersecurity
        • Emergency Response
      • Energy Efficiency
        • Building Technologies
          • Building-Grid Integration
          • Advanced Lighting
        • Residential Buildings
          • Energy Efficient Technology Integration
          • Home Energy Score
          • Building America Solution Center
        • Commercial Buildings
        • Federal Buildings
          • Federal Performance Optimization
          • Resilience and Security
        • Building Energy Codes
        • Appliance and Equipment Standards
      • Energy Storage
        • Grid Energy Storage
        • Vehicle Energy Storage
      • Environmental Management
        • Environmental Remediation
        • Waste Processing
        • Radiation Measurement
      • Fossil Energy
        • Subsurface Energy Systems
        • Advanced Hydrocarbon Conversion
      • Nuclear Energy
        • Reactor Licensing
        • Reactor Operations
        • Fuel Cycle Research
        • Advanced Reactors
      • Renewable Energy
        • Hydropower
          • Environmental Performance of Hydropower
          • Hydropower and the Electric Grid
          • Hydropower Cybersecurity and Digitalization
          • Materials Science for Hydropower
          • Water + Hydropower Planning
        • Marine Energy
          • Environmental Monitoring for Marine Energy
          • Marine Biofouling and Corrosion
          • Marine Energy Resource Characterization
          • Testing for Marine Energy
          • The Blue Economy
        • Wind Energy
          • Distributed Wind
          • Offshore Wind
          • Uncertainty Quantification
          • Wildlife and Wind
          • Wind Data Archive and Portal
          • Wind Resource Characterization
        • Geothermal Energy
        • Solar Energy
      • Transportation
        • Vehicle Technologies
          • Emission Control
          • Energy-Efficient Mobility Systems
          • Lightweight Materials
          • Vehicle Electrification
        • Bioenergy Technologies
          • Algal Biofuels
          • Aviation Biofuels
          • Waste-to-Energy and Products
        • Hydrogen & Fuel Cells
    • National Security
      • Computing & Analytics
        • Artificial Intelligence
        • Computational Mathematics & Statistics
        • Graph and Data Analytics
        • High-Performance Computing
        • Software Engineering
        • Visual Analytics
      • Cybersecurity
        • Discovery and Insight
        • Proactive Defense
        • Trusted Systems
      • Nuclear Nonproliferation
        • Stakeholder Engagement
        • Technical Training
      • Weapons of Mass Effect
        • Explosives Detection
        • Chemical & Biological Signatures Science
        • Radiological & Nuclear Detection
    • Lab Objectives
    • Publications & Reports
    • S&T Capabilities
  • People
    • Inventors
    • Diversity
    • Lab Leadership
    • Lab Fellows
    • Staff Accomplishments
  • Partner with PNNL
    • Academia
      • Distinguished Graduate Research Programs
      • Internships
      • Visiting Faculty Program
      • Joint Appointments
      • Joint Institutes
    • Community
      • STEM Education
      • Philanthropy
      • Volunteering
      • Economic Impact
    • Industry
      • Industry Partnerships
      • Licensing & Technology Transfer
      • Entrepreneurial Leave
  • Facilities & Centers
    • All Facilities
      • Atmospheric Radiation Measurement User Facility
      • Bioproducts, Sciences, and Engineering Lab
      • Environmental Molecular Sciences Laboratory
      • Institute for Integrated Catalysis
      • Marine and Coastal Research Laboratory
      • Radiochemical Processing Laboratory
      • Shallow Underground Laboratory
      • Systems Engineering Building
      • Wasteform Development Laboratory
      • PNNL Seattle Research Center
      • PNNL 5G Innovation Studio

Distributed Hydrology Soil Vegetation Model

  • FAQ
  • Tutorials and Datasets
    • Tutorial for DHSVM 2.0
    • Tutorial for DHSVM 3.0
    • Tutorial for DHSVM 3.1
  • Source Code
  • Data Products
  • Documentation
    • Tools
    • Model Operation
    • Model Input Files
    • Processing of Input Files
    • Model Output
  • Publications

Processing of Input Files

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:

  1. Create Road input files
  2. Mass Wasting Model input files

Configuration files editing:

  1. Configuration file for DHSVM
  2. Configuration file for WMW

1.  Get started

  • Download the model.
  • Required Map files ( the first 4 are required):
    • a high resolution DEM ( few 10s of meters if using the mass watsing model) 
    • a mask file , ( we derive it from the DEM) 
    • a digitized soil type map 
    • a digitized vegetation map 
    • a digitized road map if using the road components 
    • a stream map is best, but not required: streams can be retrieved from the DEM
    • a digitized soil depth map is best, but not required: it can derived from the DEM, and a required minimum and maximum soil depth for the basin

2.  Process the DEM, MASK, SOIL, and VEGETATION map files

  • Derive the mask file from the DEM
  • NODATA should be converted to 0 instead of -9999 int the maskfile
  • Clipping the soil depth, soil type and vegetation map on the mask file is not necessary, but all grids should have the same domain and resolution
  • Convert coverage to grid (if necessary)
  • Convert grid to ascii
  • Remove the header
  • Convert ascii to binary

Note that mask=char, dem=float, soil=char, veg=char for the conversion into binary.
Few programs to process the map files, remove the header automatically and convert maps from ascii to binary are available in the Tools Section.

3.  Create stream and soil input files

Create the stream.network.dat and stream.map.dat

  • fill the sinks in the DEM
  • the script CREATESTREAMNETWORK , provided in the Tools page creates a soil depth grid ( if not provided) and stream network files ( and mask file if not provided either). Always read the usage recommendation before using the script. NOTEthat the cell area is hardcoded in AddAat2.java and should be edited before running the aml script. Not editing it will result in a potential erroneous channel Cut Width in stream.map.dat .
  • We want to save the ouput at the final stream segment within the stream network. This is designated within the file stream.network.dat with a value of -1 , in the first row and 6th columni ( destination channel ID) of the file. Routing results for this stream segment will be placed in the stream output file if the keyword SAVE appears in the last column of the file. Add "SAVE <basinname>" following the last column of stream.network.dat, stream segment 1. ( If not saving the output at the mouth, it should be assigned a destination channel ID 0 ).
  • The created soil depth map grid file should be converted to ascii. Then remove the header and convert it to binary.

Create the stream class file by editing the sample stream.class.dat file.

Create Initial channel state file by running the program MakeChannelState.scr.

Look at the documentation for further details on the format of the input files.

4.  Create model states

create the Interception, Snow and Soil state file for the date specified in an Info file.

Compile and run the MakeModelStateBin.c

5.  Create road input file

The program CREATEROADNETWORK creates the file road.network.dat. It requires the DEM, the soil depth grid and the existing road network coverage. Similarly to stream.network.dat, insert a "SAVE" at the end of the line for each segment to be looked at in the output files: road.network.dat.

Create the road.class.dat by editing the sample file: DHSVM 3.0 version sample file (not Rainy Creek)

#ClassID HydWidth HydDepth n Inf RoadType ERod ERod_ol d50 n surface Width 
where ERod is the Erodability, ERod_ol is the overland ( unpaved ditch ) erodability, n the Manning Coefficient, etc.

DHSVM 2.0.1 version sample file

#Class Width Depth n Inf

Look at the documentation for further details on the format of the input files. 

6.  Mass wasting model input files

A higher resolution DEM that you would normally used is required, along with a higher resolution mask file, are required. A 10 meter DEM and mask files were used to test the model by Doten et al. (2006) over Rainy Creek in the Cascades.

7.  Configuration file for DHSVM

Edit the sample configuration file and edit paths, model options and dates.

  • DHSVM 3.0 version sample file ( please adjust soils, paths, vegetation classes, etc)
  • DHSVM 2.0.1 

8.  Configuration file for WMW

Edit the sample configuration file and edit paths, model options and dates.

  • DHSVM 3.0 version sample file
  • DHSVM 2.0.1 

Look at the documentation for further details on the format of the input files.

PNNL

  • Get in Touch
    • Contact
    • Careers
    • Doing Business
    • Environmental Reports
    • Security & Privacy
  • Research
    • Scientific Discovery
    • Energy Resiliency
    • National Security
Subscribe to PNNL News
Department of Energy Logo Battelle Logo
Pacific Northwest National Laboratory (PNNL) is managed and operated by Battelle for the Department of Energy
  • YouTube
  • Facebook
  • Twitter
  • Instagram
  • LinkedIn