SAGA-GIS Tool Library Documentation (v8.2.1)

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, inputDEM--
Fields (*)Shapes, input, optionalFIELDS--
OutputField Statistics (*)Shapes, output, optionalSTATISTICS--
Upslope Length Factor (*)Grid, output, optionalUPSLOPE_AREA--
Effective Flow Length (*)Grid, output, optionalUPSLOPE_LENGTH--
Upslope Slope (*)Grid, output, optionalUPSLOPE_SLOPE--
LS FactorGrid, outputLS_FACTOR--
Sediment Balance (*)Grid, output, optionalBALANCE--
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
Feet AdjustmentBooleanFEETNeeded if area and lengths come from coordinates measured in feet.Default: 0
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>] [-FEET <str>] [-STOP_AT_EDGE <str>] [-EROSIVITY <double>] [-STABILITY <str>]
  -DEM:<str>           	Elevation
	Grid, input
  -FIELDS:<str>        	Fields
	Shapes, input, optional
  -STATISTICS:<str>    	Field Statistics
	Shapes, output, optional
  -UPSLOPE_AREA:<str>  	Upslope Length Factor
	Grid, output, optional
  -UPSLOPE_LENGTH:<str>	Effective Flow Length
	Grid, output, optional
  -UPSLOPE_SLOPE:<str> 	Upslope Slope
	Grid, output, optional
  -LS_FACTOR:<str>     	LS Factor
	Grid, output
  -BALANCE:<str>       	Sediment Balance
	Grid, output, optional
  -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
  -FEET:<str>          	Feet Adjustment
	Boolean
	Default: 0
  -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