Hello, Guest Log In or Register
Now: Tue, Dec 03 2024 Current Version: RHEM Web Tool v2.4 Update 1

Documentation

RHEM engine version used in this interface: RHEM_08Jun2015

RHEM Model Technical Documentation

RHEM Parameter Estimation Equations

RHEM Parameter File Descriptions

RHEM Executable

Download the latest version of the RHEM executable:

In order to run the RHEM executable, the following files are needed:
  • .RUN - description of the files needed to perform the run
  • .PAR - the input parameter file
  • .PRE - the storm file create for the selected climate station

Source Code

RHEM-related Github repositories

NAL Ag Data Commons

RHEM Web Tool dataset entry on Ag Data Commons:

Other RHEM applications

RHEM is being used in other applications such as the following:

Related Publications

National Climate Stations

The list of national climate stations (name, ID, coordinates, etc.) is available as a CSV file.


International Climate Stations

We have been working on expanding the coverage of the RHEM Web Tool (interface).  You now have the ability to use international climate stations.  In the “Climate Station” panel, you will see a tab for “International” stations. At the moment, we have international stations for multiple countries.   We are also working on expanding the international stations coverage by continent (using gridded data).


International CLIGEN datasets have been published to Ag Data Commons.


Related Projects

RHEM Batch Script

This script is able to run RHEM in batch mode based on the RHEM Model-as-a-Service (MaaS) using the Cloud Services Innovation Platform (CSIP). More inormation about MaaS and CSIP can be read in this publication. This functionality enables you to run RHEM with multiple scenarios in batch format using a Python script. In order for you to run RHEM in batch mode, you are required to have:

  1. An internet-enabled computer
  2. Python 3
  3. pip or conda (Python package installers)
  4. Spredsheet editing software (Excel, OpenOffice, Google Sheets, etc.)

The workflow to run the script:

  1. Download the script, the template spreadsheet, and the requirements.txt file (this is used to install required Python packages) from this location: https://github.com/ARS-SWRC/rhem_batch_csip
  2. Install the Python dependencies (from the requirements.txt file)
  3. Populate the Excel spreadsheet with the scenarios you would like to run
  4. Run the Python script
  5. After the Python script finishes running, the results will be saved to the same spreadsheet and the parameter files and summary outputs from RHEM will be saved in an output folder

RHEM Web Tool Versions Documentation

Version: 2.4 Update 1 (August 14 2023)

  • Climate Station panel: Added new panel to select international stations by continent (for South America and Africa). In this option, the user is able to click on any point within the continent boundary. The tool will select the closest climate station based on the selected point.
  • Scenario tables (comparison and risk assessment tables): Clip long climate station names (the "CLIMATE STATION" column). Full name is available on hover.  This is similar how the "SCENARIO NAME" column is presented. 
  • Scenario sharing: Allow users to share a scenario. In order to do this, the list of scenarios under the "Manage User Scenarios" includes functionality (a "Share" button in the first column) to copy a scenario URL that can be shared with others. A message is presented to the user when the URL is copied to the clipboard. The user can then paste the URL to a browser to be able to copy and run the scenario. 
  • Documentation updates: Simplified the documentation to make it easier for user to understand concepts such as daily totals, risk assessment, etc. Especifically, the "RETURN FREQUENCY RESULTS FOR YEARLY MAXIMUM DAILY" help screen.
  • CSIP RunRHEM Web Service: The RHEM Web Tool now runs all scenarios (including CONUS climate stations) using CSIP web services.  We are no longer using local (ARS Tucson) servers to run any of the RHEM scenarios.

Version: 2.4 (January 21 2022)

  • Climate Station panel:Added a new "International All" tab which includes a list of international stations.  This option runs the RHEM engine using the CSIP web service. This publications describes the creation of input parameters used to run CLIGEN to create the list of international stations: https://doi.org/10.5194/essd-13-435-2021
  • Climate Station panel:Added a new "CLIGrid " tab to run the RHEM engine using the coupled RHEM and CLIGEN with PRISM CSIP web services.
  • Scenario Comparison report:
    • Both Annual Average Graphs and Return Frequency Graphs now include the numeric scales in the y-axis.
    • A new "Change chart colors" link is available above the Scenario Inputs table.  This will change the colors of the graphs and the table headers with the scenario names. 
  • Risk Assessment report:
    • The probability values on the "Probability of Occurrence (yearly soil losses)" graphic appeared distorted when the probability of occurrence ranges were very low.  The annotations in the graphic have been changed to show all probability of occurrence labels in their own vertical space. 
    • The x-axis scenario labels now include both the scenario names and the scenario indices (e.g. Scenario 1, Scenario 2, etc)
  • Ke Equations Update: The equations for estimating the effective hydraulic conductivity (Ke) for Sand, Loamy Sand, Silty Clay, and Clay were updated to agree with the saturated hydraulic conductivity (Ks) 25% percentile values reported by Rawls et al. (1998). For Silty Clay Loam, we used the saturated hydraulic conductivity value reported by Stone et al. (1992). To test the model, we used ground cover and foliar canopy cover from NRI and BLM rangeland on-site data collected in 17 western states and soil texture information from SoilGrids and gSSURGO. The output showed a reduction of runoff and soil loss, which is a good empirical fit to observed behavior.
  • RHEM Batch Script:A Python script with a corresponding Excel spreadsheet (to define inputs) is available in the case the user would like to run RHEM scenarios in batch format.  The script and workbook have been updated to pull return frequency results from each RHEM run. 
  • Include MAX_SAT in database:Add max_sat column to RHEM database from Mariano's table. This is used to add the SMAX parameter to the RHEM input file.

Version: 2.3 Update 5 (July 29 2019

  • Added a new checkbox and SAR input box to the Soil Texture panel for saline scanarios.
  • When a scenario is ran with this SAR value, a new row will appear in the Annual Averages table showing the "Salt Load".

  • RHEM v2.3 Update 5 now includes a new capacity for saline soils.

    The RHEM Web Tool has been updated with the capacity to account for the effect of saline soils on erosion and to provide estimates of salt loads associated with runoff and erosion events.

    The web interface now has an option under the Soil Texture Class tab. When checked, the user will be prompted to input the SAR (sodium adsorption ratio) value of the soil. If the box is not checked the model works as previously.

    Saline soils have greater erodibility and produce more erosion.  The equations used here to adjust the soil erodibility are based on the work of Nouwakpo et al., 2018. In addition, if the salinity option is active, the model will predict salt loads from the hillslope, also based on equations of Nouwakpo et al., 2018 on work done in the upper Colorado basin in Utah and Colorado. The salt load prediction is reported in the Annual Averages output table.

    Nouwakpo, S. K., Weltz, M. A., Arslan, A., Green, C. H., & Al-Hamdan, O. Z. (2018). Process-Based Modeling of Infiltration, Soil Loss, and Dissolved Solids on Saline and Sodic Soils. Transactions of the American Society of Agricultural and Biological Engineers ISSN 2151-0032 https://doi.org/10.13031/trans.12705

Version: 2.3 Update 4 (April 19 2018)

  • Ability to export report graphics as SVG - this feature will enable users to export each of the report graphics in vector format (SVG). These files can later be transformed to other formats such as EPS or PDF using tools such as Adobe Illustrator or Inkscape. The report graphics will also be available for download as PNG images.
  • Added a "Yearly Totals" table to the return period table when running single scenarios - In addition to viewing the yearly maximum daily values for return frequency results, the user will now see yearly totals. Note that scenarios will have to be rerun in order for users to see this new section in their scenario results.
  • Added ability to define the order of the scenarios when running a scenario comparison. - This functionality is useful when the user needs to define a specific order of appearance for the scenario comparison report. This functionality is based on the selection order (click order) of the scenarios. An orange label (number) will appear next to each scenario selected.
  • Metric units in the output reports have been changed from tonne/ha to Mg/ha (4-3-2019)

Version: 2.3 Update 3 (February 2 2017)

  • International climate stations are now supported. Users can submit CLIGEN .PAR files (with station statistics) to create a new climate station.
  • Slope length is defaulted to 50m (164ft). The slope length input box in the "Slope" panel has been removed.

Version: 2.3 Update 2 (September 9 2016)

  • Slope length is now default to 50m (164ft).
  • The input parameter modification tool now allows the user to modify the LEN parameter (slope length).
  • Application has been scaled up allowing scenarios to run about 40% faster.

Version: 2.3 Update 1

  • This update provides a risk assessment (probability-based) approach to natural rangeland conditions erosion modeling, and provides the frequency of occurrence for each alternative scenario based on annual soil loss return levels.

Version: 2.3

  • New set of parameter estimation equations were developed to estimate the splash and sheet erodibility coefficient on natural rangeland conditions
  • Improvement to the rainfall disaggregation algorithm
  • In general, you may find that RHEM version 2.3 produces greater soil loss predictions than the previous version

Version: 2.2

  • New set of parameter estimation equations were developed for the Smith-Parlange infiltration equation
  • Minor adjustment done to the splash and sheet erodibility parameter estimation equation (11) and (12) described in Nearing et al. 2011 to account for an improved calibration factor and for better representing slope steepness
  • Erodibility coefficient Kω has been slightly increased to better represent concentrated flow erosion in undisturbed rangelands
  • Model version used to run scenarios can be seen in the scenarios listing

Version: 2.1

  • Multiply Kss for all cases by 1.3 in order to account for the bias in the log transformation (relative to Duan 1989)
  • Ability to rename scenarios through the scenarios list by clicking on scenario name
  • A graphical (PNG) report can be created from a scenario comparison
  • User account section added to control detailed output reports and manual input file modifications

Version: 2.0

  • A prototype next-generation version (version 2) of the Rangeland Decision Support System (RHEM) is under development.

Version: 1.2

  • Updated Kc and Tc.

Version: 1.1

  • Updated model equations.

Version: 1.0


Built with:

  1. CSIP
  2. Cligen Weather Generator (v5.3)
  3. CodeIgniter
  4. MySQL

Home | About | Documentation | Contact Us
© Copyright USDA-ARS-SWRC