SAGA-GIS Tool Library Documentation (v7.3.0)

Tool LS-Factor, Field Based

Calculation of slope length (LS) factor as used for the Universal Soil Loss Equation (USLE), based on slope and (specific) catchment area, latter as substitute for slope length. This tool takes only a Digital Elevation Model (DEM) as input and derives catchment areas according to Freeman (1991). Optionally field polygons can be supplied. Is this the case, calculations will be performed field by field, i.e. catchment area calculation is restricted to each field's area.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid (input)DEM--
Fields (*)Shapes (optional input)FIELDS--
OutputField Statistics (*)Shapes (optional output)STATISTICS--
Upslope Length Factor (*)Grid (optional output)UPSLOPE_AREA--
Effective Flow Length (*)Grid (optional output)UPSLOPE_LENGTH--
Upslope Slope (*)Grid (optional output)UPSLOPE_SLOPE--
LS FactorGrid (output)LS_FACTOR--
Sediment Balance (*)Grid (optional output)BALANCE--
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
LS CalculationChoiceMETHOD-Available Choices:
[0] Moore & Nieber 1989
[1] Desmet & Govers 1996
[2] Wischmeier & Smith 1978
Default: 0
Type of SlopeChoiceMETHOD_SLOPE-Available Choices:
[0] local slope
[1] distance weighted average catchment slope
Default: 0
Specific Catchment AreaChoiceMETHOD_AREA-Available Choices:
[0] specific catchment area (contour length simply as cell size)
[1] specific catchment area (contour length dependent on aspect)
[2] catchment length (square root of catchment area)
[3] effective flow length
Default: 1
Stop at EdgeBooleanSTOP_AT_EDGE-Default: 1
Rill/Interrill ErosivityFloating pointEROSIVITY-Minimum: 0.000000
Default: 1.000000
StabilityChoiceSTABILITY-Available Choices:
[0] stable
[1] instable (thawing)
Default: 0
(*) optional

Command-line

Usage: saga_cmd ta_hydrology 25 [-DEM <str>] [-FIELDS <str>] [-STATISTICS <str>] [-UPSLOPE_AREA <str>] [-UPSLOPE_LENGTH <str>] [-UPSLOPE_SLOPE <str>] [-LS_FACTOR <str>] [-BALANCE <str>] [-METHOD <str>] [-METHOD_SLOPE <str>] [-METHOD_AREA <str>] [-STOP_AT_EDGE <str>] [-EROSIVITY <double>] [-STABILITY <str>]
  -DEM:<str>           	Elevation
	Grid (input)
  -FIELDS:<str>        	Fields
	Shapes (optional input)
  -STATISTICS:<str>    	Field Statistics
	Shapes (optional output)
  -UPSLOPE_AREA:<str>  	Upslope Length Factor
	Grid (optional output)
  -UPSLOPE_LENGTH:<str>	Effective Flow Length
	Grid (optional output)
  -UPSLOPE_SLOPE:<str> 	Upslope Slope
	Grid (optional output)
  -LS_FACTOR:<str>     	LS Factor
	Grid (output)
  -BALANCE:<str>       	Sediment Balance
	Grid (optional output)
  -METHOD:<str>        	LS Calculation
	Choice
	Available Choices:
	[0] Moore & Nieber 1989
	[1] Desmet & Govers 1996
	[2] Wischmeier & Smith 1978
	Default: 0
  -METHOD_SLOPE:<str>  	Type of Slope
	Choice
	Available Choices:
	[0] local slope
	[1] distance weighted average catchment slope
	Default: 0
  -METHOD_AREA:<str>   	Specific Catchment Area
	Choice
	Available Choices:
	[0] specific catchment area (contour length simply as cell size)
	[1] specific catchment area (contour length dependent on aspect)
	[2] catchment length (square root of catchment area)
	[3] effective flow length
	Default: 1
  -STOP_AT_EDGE:<str>  	Stop at Edge
	Boolean
	Default: 1
  -EROSIVITY:<double>  	Rill/Interrill Erosivity
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -STABILITY:<str>     	Stability
	Choice
	Available Choices:
	[0] stable
	[1] instable (thawing)
	Default: 0