LUCI_SEEA.RUSLE.pyt.xml

<metadata xml:lang="en"><Esri><CreaDate>20190522</CreaDate><CreaTime>12033300</CreaTime><ArcGISFormat>1.0</ArcGISFormat><SyncOnce>TRUE</SyncOnce><ModDate>20210521</ModDate><ModTime>11363300</ModTime><scaleRange><minScale>150000000</minScale><maxScale>5000</maxScale></scaleRange><ArcGISProfile>ItemDescription</ArcGISProfile></Esri><tool name="RUSLE" displayname="Calculate soil loss (RUSLE)" toolboxalias="LUCI" xmlns=""><arcToolboxHelpPath>c:\program files (x86)\arcgis\desktop10.6\Help\gp</arcToolboxHelpPath><parameters><param name="Output_folder" displayname="Output folder" type="Required" direction="Input" datatype="Folder" expression="Output_folder"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the path and folder name where output from this tool should be stored.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Preprocess_folder" displayname="Preprocessed data folder" type="Required" direction="Input" datatype="Folder" expression="Preprocess_folder"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the path an&lt;/SPAN&gt;&lt;SPAN&gt;d&lt;/SPAN&gt;&lt;SPAN&gt; folder where the output from the &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Preprocess data &lt;/SPAN&gt;&lt;SPAN&gt;tool is stored.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Rainfall_erosivity" displayname="R-factor: Rainfall erosivity dataset" type="Required" direction="Input" datatype="Raster Layer" expression="Rainfall_erosivity"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the path and filename to the rainfall erosivity raster.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="LS_option" displayname="LS-factor: Method option" type="Required" direction="Input" datatype="String" expression="Calculate based on slope and length only | Include upslope contributing area"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This tool has two options to estimate the effect of slope length and steepness:&lt;/SPAN&gt;&lt;/P&gt;&lt;UL&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Calculate based on slope and length only&lt;/SPAN&gt;&lt;SPAN&gt;: This method only accounts for slope length and steepness as specified by Morgan [2].&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Include upslope contributing area&lt;/SPAN&gt;&lt;SPAN&gt;: This method includes slope length, steepness, and upslope contributing area as specified by &lt;/SPAN&gt;&lt;SPAN&gt;Moore and Burch [3&lt;/SPAN&gt;&lt;SPAN&gt;]. This method may require more processing time if the study area is large or the DEM is high-resolution.&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;/UL&gt;&lt;P&gt;&lt;SPAN&gt;Default is Calculate based on slope and length only.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;[2] Morgan, R. P. C. (2005) Soil Erosion and Conservation. National Soil Resources Institute, Cranfield University.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;[3] Moore, I. D., &amp;amp; Burch, G. J. (1986). Physical Basis of the Length-slope Factor in the Universal Soil Loss Equation. Soil Science Society of America Journal, 50(5), 1294–1298.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="LSfactor_cutoff_angle" displayname="LS-factor: Cutoff slope angle (degrees)" type="Required" direction="Input" datatype="Double" expression="LSfactor_cutoff_angle"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the cutoff angle for calculating the LS-factor. Beyond this slope angle, only rock is expected to be found with no soil on the surface.The value of 26.6 degrees or 50% was suggested by [1]&lt;/SPAN&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN /&gt;&lt;SPAN&gt;[1] Panagos, P., Borelli, P., &amp;amp; Meusburger, K. (2015). &lt;/SPAN&gt;&lt;A href="https://www.mdpi.com/2076-3263/5/2/117"&gt;&lt;SPAN&gt;A New European Slope Length and Steepness Factor (LS-factor) for Modeling Soil Erosion by Water&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Geosciences&lt;/SPAN&gt;&lt;SPAN&gt;. 5(2). 117-126.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Kfactor_option" displayname="K-factor: Soil erodibility option" type="Required" direction="Input" datatype="String" expression="Use preprocessed soil data | Use local K-factor dataset"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This tool has two options for determining K-factor depending on the dataset that will be entered in the parameter &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;K-factor: Soils or erodibility dataset&lt;/SPAN&gt;&lt;SPAN&gt;below:&lt;/SPAN&gt;&lt;/P&gt;&lt;UL&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use preprocessed soil data&lt;/SPAN&gt;&lt;SPAN&gt;: Choose this option if the input soil dataset is from the Harmonized World Soils Database and has been preprocessed in the &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Preprocess data &lt;/SPAN&gt;&lt;SPAN&gt;tool.&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use local K-factor dataset&lt;/SPAN&gt;&lt;SPAN&gt;: Choose this option if using a pre-existing K-factor dataset for this study area.&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;/UL&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Soils" displayname="K-factor: Soil erodibility dataset" type="Optional" direction="Input" datatype="Feature Class or Raster Layer" expression="{Soils}"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;P&gt;&lt;SPAN&gt;This input depends on the K-factor option outlined above.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;If &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use preprocessed soil data &lt;/SPAN&gt;&lt;SPAN&gt;was selected, this input can be left blank. The soil dataset will be pulled from the preprocess data folder.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;If &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use local K-factor dataset &lt;/SPAN&gt;&lt;SPAN&gt;was selected, specify the path and filename to the raster, shapefile, or feature class that contains the K-factor dataset and values.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;</dialogReference></param><param name="Soil_linking_code" displayname="K-factor: Soil linking code" type="Optional" direction="Input" datatype="String" expression="{Soil_linking_code}"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the field that contains the unique identifier for the input K-factor &lt;/SPAN&gt;&lt;SPAN&gt;dataset. For rasters, this field is typically &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;VALUE&lt;/SPAN&gt;&lt;SPAN&gt;. For feature classes/shapefiles, this field is dependent on the creation of the dataset.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Cfactor_option" displayname="C-factor: Land cover option" type="Required" direction="Input" datatype="String" expression="Use preprocessed land cover data | Use local C-factor dataset"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This tool has two options for determining C-factor depending on the dataset that will be entered in the parameter &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;C-factor: Land cover or cover factor dataset&lt;/SPAN&gt;&lt;SPAN&gt; below:&lt;/SPAN&gt;&lt;/P&gt;&lt;UL&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use preprocessed land cover data&lt;/SPAN&gt;&lt;SPAN&gt;: Choose this option if the input soil dataset is from the ESA CCI global dataset and has been preprocessed in the Preprocess data tool.&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use local C-factor dataset&lt;/SPAN&gt;&lt;SPAN&gt;: Choose this option if using a pre-existing C-factor dataset for this study area.&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;/UL&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Land_cover" displayname="C-factor: Cover factor dataset" type="Optional" direction="Input" datatype="Feature Class or Raster Layer" expression="{Land_cover}"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This input depends on the C-factor option outlined above.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;If &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use preprocessed land cover data&lt;/SPAN&gt;&lt;SPAN&gt; &lt;/SPAN&gt;&lt;SPAN&gt;was selected, this input can be left blank. The land cover dataset will be pulled from the preprocess data folder.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;If &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Use local C-factor dataset&lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt; &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt; &lt;/SPAN&gt;&lt;SPAN&gt;was selected, specify the path and filename to the raster, shapefile, or feature class that contains the C-factor dataset and values.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Land_cover_linking_code" displayname="C-factor: Land cover linking code" type="Optional" direction="Input" datatype="String" expression="{Land_cover_linking_code}"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the field that contains the unique identifier for the input C-factor dataset. For rasters, this field is typically &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;VALUE&lt;/SPAN&gt;&lt;SPAN&gt;. For feature classes/shapefiles, this field is dependent on the creation of the dataset.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Pfactor_dataset" displayname="P-factor: Support practice dataset" type="Optional" direction="Input" datatype="Raster Layer" expression="{Pfactor_dataset}"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Specify the path and filename to the support practice (P-factor) raster.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Save_factor_layers" displayname="Save factor layers?" type="Required" direction="Input" datatype="Boolean" expression="Save_factor_layers"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Tick this box to save the RUSLE layers to the output folder.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param><param name="Rerun_tool" displayname="Rerun tool (will continue previous run from the point where any errors occurred)" type="Required" direction="Input" datatype="Boolean" expression="Rerun_tool"><dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Check to rerun the tool if it fails prior to completion. The rerun will start again from the point of failure rather than starting the tool from the beginning.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference></param></parameters><summary>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This tool estimates the annual soil loss (tonnes/ha/yr) using the Revised Universal Soil Loss Equation (RUSLE) [1] approach.&lt;/SPAN&gt;&lt;SPAN&gt;Before running this tool, run the &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Preprocess data &lt;/SPAN&gt;&lt;SPAN&gt;tool to run consistency checks and recondition the digital elevation model if required. &lt;/SPAN&gt;&lt;SPAN&gt;This tool requires the following datasets:&lt;/SPAN&gt;&lt;/P&gt;&lt;UL&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Digital Elevation Model&lt;/SPAN&gt;&lt;SPAN&gt;: from the Preprocess data tool, this DEM can either be the raw input DEM or the reconditioned DEM&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Soil&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Land Cover&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Rainfall erosivity&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;/UL&gt;&lt;P&gt;&lt;SPAN&gt;Instructions for which datasets to download and how to acquire &lt;/SPAN&gt;&lt;SPAN&gt;some globally-accessible land cover, soil, and rainfall erosivity datasets &lt;/SPAN&gt;&lt;SPAN&gt;can be found &lt;/SPAN&gt;&lt;A href="https://lucitools.org/luci-online-tutorials/downloading-data-for-the-rusle-tool"&gt;&lt;SPAN&gt;here&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;This tool also allows the user to input their own datasets for soil erodibility (K-factor) and cover (C-factor) if available or they have made their own parameterisation with their soil or land cover data.&lt;/SPAN&gt;&lt;SPAN /&gt;&lt;SPAN&gt;If the user has made a P-factor dataset for their study area, it can be input in the optional parameter &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;P-factor: support practice dataset&lt;/SPAN&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;[1] Renard, K., Foster, G., Weesies, G., McCool, D., &amp;amp; Yoder, D. (1997). &lt;/SPAN&gt;&lt;A href="https://www.ars.usda.gov/ARSUserFiles/64080530/RUSLE/AH_703.pdf"&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Predicting soil erosion by water: a guide to conservation planning with the Revised Universal Soil Loss Equation (RUSLE)&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. In Agricultural Handbook No. 703. https://doi.org/DC0-16-048938-5 65–100.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</summary></tool><dataIdInfo><idCitation><resTitle>Calculate soil loss (RUSLE)</resTitle></idCitation><idAbs>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;This tool estimates the annual soil loss (tonnes/ha/yr) using the Revised Universal Soil Loss Equation (RUSLE) [1] approach.&lt;/SPAN&gt;&lt;SPAN&gt;Before running this tool, run the &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Preprocess data &lt;/SPAN&gt;&lt;SPAN&gt;tool to run consistency checks and recondition the digital elevation model if required. &lt;/SPAN&gt;&lt;SPAN&gt;This tool requires the following datasets:&lt;/SPAN&gt;&lt;/P&gt;&lt;UL&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Digital Elevation Model&lt;/SPAN&gt;&lt;SPAN&gt;: from the Preprocess data tool, this DEM can either be the raw input DEM or the reconditioned DEM&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Soil&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Land Cover&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;LI&gt;&lt;P&gt;&lt;SPAN&gt;Rainfall erosivity&lt;/SPAN&gt;&lt;/P&gt;&lt;/LI&gt;&lt;/UL&gt;&lt;P&gt;&lt;SPAN&gt;Instructions for which datasets to download and how to acquire &lt;/SPAN&gt;&lt;SPAN&gt;some globally-accessible land cover, soil, and rainfall erosivity datasets &lt;/SPAN&gt;&lt;SPAN&gt;can be found &lt;/SPAN&gt;&lt;A href="https://lucitools.org/luci-online-tutorials/downloading-data-for-the-rusle-tool"&gt;&lt;SPAN&gt;here&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;This tool also allows the user to input their own datasets for soil erodibility (K-factor) and cover (C-factor) if available or they have made their own parameterisation with their soil or land cover data.&lt;/SPAN&gt;&lt;SPAN /&gt;&lt;SPAN&gt;If the user has made a P-factor dataset for their study area, it can be input in the optional parameter &lt;/SPAN&gt;&lt;SPAN STYLE="font-style:italic;"&gt;P-factor: support practice dataset&lt;/SPAN&gt;&lt;SPAN&gt;.&lt;/SPAN&gt;&lt;/P&gt;&lt;P&gt;&lt;SPAN&gt;[1] Renard, K., Foster, G., Weesies, G., McCool, D., &amp;amp; Yoder, D. (1997). &lt;/SPAN&gt;&lt;A href="https://www.ars.usda.gov/ARSUserFiles/64080530/RUSLE/AH_703.pdf"&gt;&lt;SPAN STYLE="font-style:italic;"&gt;Predicting soil erosion by water: a guide to conservation planning with the Revised Universal Soil Loss Equation (RUSLE)&lt;/SPAN&gt;&lt;/A&gt;&lt;SPAN&gt;. In Agricultural Handbook No. 703. https://doi.org/DC0-16-048938-5 65–100.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;&lt;/DIV&gt;</idAbs><searchKeys><keyword>LUCI</keyword><keyword>RUSLE</keyword></searchKeys></dataIdInfo><distInfo><distributor><distorFormat><formatName>ArcToolbox Tool</formatName></distorFormat></distributor></distInfo><mdHrLv><ScopeCd value="005"/></mdHrLv></metadata>