WEPPcloud Documentation

WEPPcloud Documentation


The Water Erosion Prediction Project (WEPP) model is a hydrology and erosion model wildly used by academics and land managers to assess the effects of land management changes on runoff and sediment yield. Even for advanced users, data preparation is a lengthy process that involves downloading various maps and datasets, and processing and saving the data in formats that are readable by the model.

WEPPcloud is an online interface for the WEPP model that facilitates input data preparation and hydrologic simulations from any computer connected to the internet. The user can zoom to a location, identify an area of interest, and delineate a watershed. Then based on a series of options that involve selection of soils, managements, and weather information from national or locally-stored databases, the user can quickly get estimates of runoff and soil erosion for their watershed of interest. Results are displayed in the web browser as text files and as geospatial maps and are also downloadable. Most hydrologic simulations can be completed within a few minutes, depending on the size of the watershed.

WEPPcloud was mainly developed for forestry applications as a joint effort between University of Idaho and Forest Service Rocky Mountain Research Station. Other contributions to the applicaiton include USDA ARS, Swansea University, and Michigan Technological University.

Looking for more information? View the FAQ

Getting Started

Advanced Topics and Troubleshooting

Help / Feedback

For general assistance or questions please contact Mariana Dobre at mdobre@uidaho.edu.

For technical assistance please contact Roger Lew at rogerlew@uidaho.edu. Providing the url to the run in question and a screenshot of the problem would also be helpful.

For questions regarding the WEPP model please contact Anurag Srivastava at srivanu@idaho.edu.


WEPPcloud relies on publically available databases to parameterize the necessary WEPP inputs. The various WEPPcloud interfaces are more-or-less supported in the following locales:

WEPPcloud has region specific data for some locations that are used to provide better calibration. These regions include:


WEPPcloud is comprised of numerous interfaces with sometimes subtle distinctions between them. While this helps to provide backwards compatibility the result can be confusing to users. If you are unsure of what interface to use, use the general WEPPcloud Interface or the Disturbed Interface.


The WEPPcloud-Disturbed allows users to upload a burn severity map and predict erosion based on fire severity. Optionally, the user can forgo uploading a burn severity map to model unburned conditions. It uses SSURGO to create 7778 soils and NLCD to parameterize landuse for unburned conditions. For fire and treatment conditions soils and managements are procedurally generated and parameterized from the disturbed database based on soil texture and landuse. This allowing forests, shrubs, and grass to be burned based on landuse. The parameterization is intended to provide meaningful comparisons between unburned, burned, and treatment conditions. In the long-term disturbed is envisioned to replace the WEPPcloud-PEP interface.

This interface also incorporates the Wildfire Ash Transport And Risk estimation tool (WATAR).

Legacy Interfaces


Run WEPP anywhere in the continental U.S.

Elevation data is from the USGS National Elevation Set. This interface uses TOPAZ for watershed delineation. The soils are built using SURGO/STATSGO. Landcover is selected based on the USGS National Landcover dataset. Climates are generated from the CLIGEN database.

WEPP-PEP (Post Fire Erosion Prediction)

The WEPPcloud Post-Fire Erosion Prediction (PEP) allows users to upload a burn severity map and predict erosion based on fire severity. Soil textures are identified from SSURGO. Unburned conditions are assigned 2006.2 forest soils and managements based on soil texture (sand loam, silt loam, clay loam, loam), and burn severity (unburned, low/moderate, high).

The PeP interface incorporates the Wildfire Ash Transport And Risk estimation tool (WATAR).

View 15 May 2019 USDA Forest Service Webinar: An Introduction to WEPPcloud-PEP.

RRED (Rapid Response Erosion Database)

The RRED interface uses WEPP inputs generated by the Rapid Response Erosion Database (RRED). These database parameterizes 97.3 Disturbed WEPP soils and managements with with SSURGO/STATSGO soil data. Burn classes are assigned GeoWEPP burn severity managements. This interface also incorporates the Wildfire Ash Transport And Risk estimation tool (WATAR). Obtains soils and managements from the http://rred.mtri.org/rred.


Specialized tools and reports are available on some interfaces to assist with post-fire risk assessment. These tools include:

WATAR (Water Erosion Prediction Project cloud model - Wildfire Ash Transport And Risk estimation tool)

WATAR has been under developed since 2017 (Neris et al. 2017). The model predicts the probability of both ash and soil, and the potential pollutants in them, to be transported from burned hillslopes into stream channels and waterbodies and utilizes WEPP outputs.

Debris Flow

A empirical Debris Flow model is available for the US. It is parameterized from SSURGO and uses NOAA precipitation interval data.

RHEM (Rangeland Hydrology and Erosion Model)

This interface provides a watershed scale online interface for RHEM. It parameterizes soils based on cover values obtained from the NLCD 2016 Shrubland database.

Lake Tahoe-Fire

This interface is for the Lake Tahoe Basin. Soil Burn Severity is estimated from a random forest classification model developed specifically for Lake Tahoe. This interface also incorporates phosphorus soil data.

The WEPP Model

Model Background

The WEPP model is a physically-based hydrology and erosion model (Flanagan and Nearing, 1995, Flanagan et al., 2007), initially developed to be applied at hillslope scales or in small agricultural catchments. The advantage of WEPP is its ability to estimate the spatial and temporal distribution of soil loss or deposition along a hillslope, as well as sediment yield at the bottom of a hillslope. WEPP is based on the fundamentals of hydrology, plant science, hydraulics, and erosion mechanics (Flanagan and Nearing, 1995). For the detailed description of model components and processes please refer to the WEPP User Summary (Flanagan and Livingston, 1995) and WEPP Technical Documentation (Flanagan and Nearing, 1995).

Developments such as the incorporation of baseflow algorithms and channel routing methods have extended the applicability of the model to larger watersheds. The model has been tested for several undisturbed watersheds and for forest management effects on water and sediment yield from watersheds in Pacific Northwest (Brooks et al., 2016; Srivastava et al., 2020).

Following are the brief description of model components and processes:

Watershed Delineation

Watershed delineation can be performed by TOPAZ or TauDEM


Hydrology and Hydraulics

WEPP first executes hydrological and erosion calculations for each hillslope and channel. The flow and sediment yield from each of the hillslopes are fed to those of the associated channel and are routed through the channels to the watershed outlet.

Hillslope Erosion

Channel Hydrology and Erosion

Recent Developments

Windows WEPP

Several WEPP interfaces are available for different applications. The USDA Agricultural Research Service National Soil Erosion Research Lab (NSERL) is the agency the manages the model development and handles all the updates and releases (Laflen et al., 1991; Flanagan and Nearing, 1995). The WEPP Windows interface can be ran on personal computers for individual hillslopes or small agricultural catchments. For a complete list of model documentation, updates, and other information related to the WEPP model see: https://www.ars.usda.gov/midwest-area/west-lafayette-in/national-soil-erosion-research/docs/wepp/


NSERL is also the developer of an online interface for the WEPP model (Frankenberger et al., 2011), which allows the WEPP model to be set up for small watersheds and ran using a web browser: https://milford.nserl.purdue.edu/ol/wepp/verify.php

Additionally, researchers at NSERL are working on developing other online interfaces at both hillslope and watershed scales for land managers interested in evaluating the effects of runoff and erosion from various agricultural practices.


An ArcGIS version of the model (GeoWEPP, Renschler, C.S., 2003) has been developed for users that are familiar with GIS: http://geowepp.geog.buffalo.edu

GeoWEPP guides users through a series of questions that facilitate data preparation and model runs. The model is ArcMap dependent and a user needs to update GeoWEPP with every ArcMap update.

Platform Architecture

WEPPcloud is a Python Flask web interface for running WEPP (and other hydrological) models in the cloud (remote servers). WEPPcloud uses the wepppy library to acquire and process GIS data from a variety of sources. wepppy contains a scientific Python-based hillslope abstraction routine and functionality for running WEPP at the watershed scale. This eliminates the need for TopWEPP (a.k.a. TopWEPP2, prepwepp) and improves the flexibility and reliability of the process. WEPPcloud automates the delineation of hillslopes by running Digital Elevation Models (DEMs) through TOPAZ. The climates can be stochastically generated or observed daily climate input files are created with the assistance of CLIGEN. Additional climate processing functionality is available (dependent on the region) to spatialize climates on monthly gridded daily temperature minimums, maximums, and precipitations. In the US there is support for generating daily observed (historical) climate files from DAYMET or GRIDMET.

Platform Architecture

Change Log

</tr> </tbody> </table> # References see [References](/References.html)
DateNotable Change
February 10, 2021Correct bulk density in ssurgo/statsgo soils based on rock content.
December 8, 2020TauDEM alpha release. Ash Transport gridded alpha release. Fractional zoom for map. Disturbed has ability to remove SBS. Channel shape export has discharge in m^3. Some other miscellaneous changes.
Noveber 19, 2020Tillage and surface effects removed from Tahoe/Disturbed WEPP files.
November 18, 2020All channel managements set to a default management specific for channels instead of assigning all the channels the dominate management of the channels.
November 17, 2020Disturbed uses the Tahoe 20-yr Old Forest for forest conditions instead of an outdated management that would result in increased erosion with Current Conditions.
November 15, 2020Forking revised for improved reliability. Forking now provides a console that outputs status of the forking process. Once the forking is complete a link to the new run should be provided at the bottom of the page.
October 29, 2020Bug fix for properly reloading RRED projects. Link to export preparation details. wepp_aa57a1d with extended formatting loss report for larger watersheds. Disturbed interface will always use latest version of wepp.
October 27, 2020Write 2006.2 channel soils if hillslope soils are 9x.x or 2006.2.
October 20, 2020Combined Watershed Viewer units support and bug fixes.
October 16, 2020WEPPcloud-Disturbed Beta release
October 14, 2020Report WEPP channel width in channel table of preparation details.
October 12, 2020Cligen 5.3.2 fix for running observed climates.
October 6, 2020Ability to export without WEPP results. US Gage Locations as map overlay. Simple soil texture classes incorporated in BAER.
October 2, 2020User pages bug fixes.
September 28, 2020Ability to clear landuse selection. Average Annual Water balance Streamflow includes runoff and latqcc. StreamFlow graph is stacked
September 23, 2020GRIDMET support for current year.
September 4, 2020GHCN climates added to interface.
August 28, 2020Adjustment to how field capacity and wilt point are calculated to not double correct for rock (EB).
August 27, 2020No soil specialization for water. PortlandMod implementation. Water restrictive layer set to 1 10000 100 (AS).
July 15, 2020No water in channel soils.
July 7, 2020Landuse change enabled on general interface.
July 2, 2020Use gdal for projection transformations were possible.
June 26, 2020PyProj multiple import fix.
June 18, 2020Bug fix for soil specialization.
May 11, 2020PMETPARA input file preparation
April 1, 2020Fixed project forking bug.
March 18, 2020AshPost implementation to optimize interface. Ash support added to PowerUser Panel.
March 4, 2020NaN checking for Loss Summary.
March 1, 2020Support for discontinuous temperature adjustment to climate files. Ability to control whether pmet, frost, baseflow, and tcr WEPP sub-routines are ran.
February 29, 2020Portland bedrock attributes updated.
February 28, 2020Cligen5.32 integrated into interface. This includes a fix for tpeak values when building from observed datasets. Phosphorus added to Loss Summary. Portland bedrock attributes updated (jimf).
February 21, 2020Calibration soils for LT.
January 27, 2020WEPPcloud-PEP wepp channel type set to OnRock 2. (md)
June 17, 2019Hillslope and Watershed ash transport modeling for WEPPcloud-PEP. Single Storm climate fully implemented.
May 17, 2019Annual climate precip, tmax, tmin in station summary and .cli summary. Phosphorus variables removed from freq flood report when not ran. Units fixed for runoff on combined watershed viewer. Summary for wepp run is now populated. Mary Ellen's soil texture classification incorporated. Soil texture based on surgo data in ERMiT download. ERMiT meta data file contains climate station information (state, station description, par). Link to FSWEPP batch processing scripts below the ERMiT csv. Units pretty much everywhere rounding to 2 significant digits. MCL and CSA inputs respect the units of the project (m and ha or ft and acre). Tab titles now include project name if a project name is defined.
March 29, 2019Various usability enhancements. 10-min and 30-min peak rainfall intensities added to return period analysis. soil fix for channels and hillslopes with dominate water.
February 14, 2019Hazard SEES - FireEarth Data Portals added.
January 14, 2019Miscellaneous interface improvements and bug fixes.
December 3, 2018Bug fix for building DAYMET Climates with small extents.
November 2, 2018Changed default parameters for running TOPAZ and WEPP.
August 27, 2018Combined Watershed URL Generator. Ability to reassign landuse to different management. Zack Holden's WRF Precipitation dataset integrated into Debris Flow model over bounds of [-117.386, 34.694, 48.756, -96.980].
August 13, 2018Debris flow enhancements (liquid limit from surgo, SBS area based on grid).
July 31, 2018Fixed layout bug with screens with 1280px width.
July 30, 2018Updated phosphorus maps for Lake Tahoe. New WEPP binary to fix missing chanwb output. Bug fix for hillslope delineation in locations below 1m in elevation.
July 20, 2018frost submodule removed from hillslope processing. WEPP bug fix for empty chanwb outputs.
June 14, 2018Disturbed WEPP managements added to single landuse selection. Single landuse selection added. Support for 98.4 management files.
June 10, 2018Minor map and interface enhancements.
June 8, 20182006.2 WEPP soil support added, county level soil database for NSERL.
June 3, 2018Coeur d'Alene added.
May 31, 2018Lake Tahoe (LT) Homepage added.
May 18, 2018Observed climates for Lake Tahoe added to interface.
May 15, 2018WEPP runs hillslopes in parallel.
May 11, 2018Debris flow model added.
April 23, 2018Soil restrictive layer scaled by 1/100.
April 7, 2018Power User Panel added to interface.
April 5, 2018Total yearly water balance report.
April 4, 2018totalwatsed export added.
April 3, 2018Watershed preparation details added.
April 3, 2018Watershed preparation details added.
Mar 26, 2018Projects can be set READONLY and PUBLIC.
Mar 21, 2018Project archive export added.
Mar 20, 2018Return Period Analysis implemented.