Skip to main content

PNNL

  • About
  • News & Media
  • Careers
  • Events
  • Research
    • Scientific Discovery
      • Biology
        • Chemical Biology
        • Computational Biology
        • Ecosystem Science
        • Human Health
          • Cancer Biology
          • Exposure Science & Pathogen Biology
          • Metabolic Inflammatory Diseases
        • Integrative Omics
          • Advanced Metabolomics
          • Chemical Biology
          • Mass Spectrometry-Based Measurement Technologies
          • Spatial and Single-Cell Proteomics
          • Structural Biology
        • Microbiome Science
          • Biofuels & Bioproducts
          • Human Microbiome
          • Soil Microbiome
          • Synthetic Biology
      • Chemistry
        • Computational Chemistry
        • Chemical Separations
        • Chemical Physics
        • Catalysis
      • Earth & Coastal Sciences
        • Atmospheric Science
          • Atmospheric Aerosols
          • Human-Earth System Interactions
          • Modeling Earth Systems
        • Coastal Science
        • Ecosystem Science
        • Plant Science
        • Subsurface Science
        • Terrestrial Aquatics
      • Materials Sciences
        • Materials in Extreme Environments
        • Precision Materials by Design
        • Science of Interfaces
        • Solid Phase Processing
          • Cold Spray
          • Friction Stir Welding & Processing
          • ShAPE
      • Nuclear & Particle Physics
        • Dark Matter
        • Flavor Physics
        • Fusion Energy Science
        • Neutrino Physics
      • Quantum Information Sciences
    • Sustainable Energy
      • Electric Grid Modernization
        • Emergency Response
        • Grid Analytics
          • AGM Program
          • Tools and Capabilities
        • Grid Architecture
        • Grid Cybersecurity
        • Grid Energy Storage
        • Grid Resilience and Decarbonization
          • Earth System Modeling
          • Energy System Modeling
        • Transmission
        • Distribution
      • Energy Efficiency
        • Appliance and Equipment Standards
        • Building Energy Codes
        • Building Technologies
          • Advanced Building Controls
          • Advanced Lighting
          • Building-Grid Integration
        • Building and Grid Modeling
        • Commercial Buildings
        • Federal Buildings
          • Federal Performance Optimization
          • Resilience and Security
        • Grid Resilience and Decarbonization
        • Residential Buildings
          • Building America Solution Center
          • Energy Efficient Technology Integration
          • Home Energy Score
        • Energy Efficient Technology Integration
      • Energy Storage
        • Electrochemical Energy Storage
        • Flexible Loads and Generation
        • Grid Integration, Controls, and Architecture
        • Regulation, Policy, and Valuation
        • Science Supporting Energy Storage
        • Chemical Energy Storage
      • Environmental Management
        • Waste Processing
        • Radiation Measurement
        • Environmental Remediation
      • Fossil Energy
        • Subsurface Energy Systems
        • Carbon Management
          • Carbon Capture
          • Carbon Storage
          • Carbon Utilization
        • Advanced Hydrocarbon Conversion
      • Nuclear Energy
        • Fuel Cycle Research
        • Advanced Reactors
        • Reactor Operations
        • Reactor Licensing
      • Renewable Energy
        • Solar Energy
        • Wind Energy
          • Distributed Wind
          • Wildlife and Wind
          • Wind Data Management
          • Wind Resource Characterization
        • Energy Equity & Health
        • Marine Energy
          • Environmental Monitoring for Marine Energy
          • Marine Biofouling and Corrosion
          • Marine Energy Resource Characterization
          • Testing for Marine Energy
          • The Blue Economy
        • Hydropower
          • Environmental Performance of Hydropower
          • Hydropower Cybersecurity and Digitalization
          • Hydropower and the Electric Grid
          • Materials Science for Hydropower
          • Pumped Storage Hydropower
          • Water + Hydropower Planning
        • Grid Integration of Renewable Energy
        • Geothermal Energy
      • Transportation
        • Bioenergy Technologies
          • Algal Biofuels
          • Aviation Biofuels
          • Waste-to-Energy and Products
        • Hydrogen & Fuel Cells
        • Vehicle Technologies
          • Emission Control
          • Energy-Efficient Mobility Systems
          • Lightweight Materials
          • Vehicle Electrification
          • Vehicle Grid Integration
    • National Security
      • Cybersecurity
        • Discovery and Insight
        • Proactive Defense
        • Trusted Systems
      • Nuclear Material Science
      • Nuclear Nonproliferation
        • Radiological & Nuclear Detection
        • Nuclear Forensics
        • Ultra-Sensitive Nuclear Measurements
        • Nuclear Explosion Monitoring
        • Global Nuclear & Radiological Security
      • Stakeholder Engagement
        • Disaster Recovery
        • Global Collaborations
        • Legislative and Regulatory Analysis
        • Technical Training
      • Systems Integration & Deployment
        • Additive Manufacturing
        • Deployed Technologies
        • Rapid Prototyping
        • Systems Engineering
      • Threat Analysis
        • Advanced Wireless Security
          • 5G Security
          • RF Signal Detection & Exploitation
        • Climate Security
        • Grid Resilience and Decarbonization
        • Internet of Things
        • Maritime Security
      • Chemical & Biothreat Signatures
        • Contraband Detection
        • Pathogen Science & Detection
        • Explosives Detection
        • Threat-Agnostic Biodefense
    • Data Science & Computing
      • Artificial Intelligence
      • Graph and Data Analytics
      • Software Engineering
      • Computational Mathematics & Statistics
      • High-Performance Computing
      • Visual Analytics
    • Lab Objectives
    • Publications & Reports
    • Featured Research
  • People
    • Inventors
    • Diversity & Inclusion
    • Lab Leadership
    • Lab Fellows
    • Staff Accomplishments
  • Partner with PNNL
    • Academia
      • Distinguished Graduate Research Programs
      • Internships
      • Visiting Faculty Program
      • Joint Appointments
      • Joint Institutes
      • Linus Pauling Distinguished Postdoctoral Fellowship
      • Minority-serving Institutions
    • Community
      • Regional Impact
      • STEM Education
        • Resources
        • Student STEM Ambassadors
        • STEM Ambassadors in the Classroom
      • Philanthropy
      • Volunteering
    • Industry
      • Available Technologies
      • Industry
      • Industry Partnerships
      • Licensing & Technology Transfer
      • Entrepreneurial Leave
  • Facilities & Centers
    • All Facilities
      • Atmospheric Radiation Measurement User Facility
      • Electricity Infrastructure Operations Center
      • Energy Sciences Center
      • Environmental Molecular Sciences Laboratory
      • Grid Storage Launchpad
      • Institute for Integrated Catalysis
      • Interdiction Technology and Integration Laboratory
      • PNNL Seattle Research Center
      • PNNL-Sequim
      • Radiochemical Processing Laboratory
      • Shallow Underground Laboratory

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
    • Vulnerability Disclosure Program
  • Research
    • Scientific Discovery
    • Sustainable Energy
    • 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