SAGA 9.6.1 | Tool Library Documentation

LS-Factor, Field Based


Description

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--
Fieldsshapes, input, optionalFIELDS--
OutputField Statisticsshapes, output, optionalSTATISTICS--
Upslope Length Factorgrid, output, optionalUPSLOPE_AREA--
Effective Flow Lengthgrid, output, optionalUPSLOPE_LENGTH--
Upslope Slopegrid, output, optionalUPSLOPE_SLOPE--
LS Factorgrid, outputLS_FACTOR--
Sediment Balancegrid, 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 point numberEROSIVITY-Minimum: 0.000000 Default: 1.000000
StabilitychoiceSTABILITY-Available Choices: [0] stable [1] instable (thawing) Default: 0

Command Line


Usage: saga_cmd ta_hydrology 25 [-DEM ] [-FIELDS ] [-STATISTICS ] [-UPSLOPE_AREA ] [-UPSLOPE_LENGTH ] [-UPSLOPE_SLOPE ] [-LS_FACTOR ] [-BALANCE ] [-METHOD ] [-METHOD_SLOPE ] [-METHOD_AREA ] [-FEET ] [-STOP_AT_EDGE ] [-EROSIVITY ] [-STABILITY ]
  -DEM:           	Elevation
	grid, input
  -FIELDS:        	Fields
	shapes, input, optional
  -STATISTICS:    	Field Statistics
	shapes, output, optional
  -UPSLOPE_AREA:  	Upslope Length Factor
	grid, output, optional
  -UPSLOPE_LENGTH:	Effective Flow Length
	grid, output, optional
  -UPSLOPE_SLOPE: 	Upslope Slope
	grid, output, optional
  -LS_FACTOR:     	LS Factor
	grid, output
  -BALANCE:       	Sediment Balance
	grid, output, optional
  -METHOD:        	LS Calculation
	choice
	Available Choices:
	[0] Moore & Nieber 1989
	[1] Desmet & Govers 1996
	[2] Wischmeier & Smith 1978
	Default: 0
  -METHOD_SLOPE:  	Type of Slope
	choice
	Available Choices:
	[0] local slope
	[1] distance weighted average catchment slope
	Default: 0
  -METHOD_AREA:   	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:          	Feet Adjustment
	boolean
	Default: 0
  -STOP_AT_EDGE:  	Stop at Edge
	boolean
	Default: 1
  -EROSIVITY:  	Rill/Interrill Erosivity
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -STABILITY:     	Stability
	choice
	Available Choices:
	[0] stable
	[1] instable (thawing)
	Default: 0