SAGA-GIS Tool Library Documentation (v7.8.2)

Tool Flow Path Length

This tool calculates the average flow path length starting from the seeds, that are given by the optional 'Seeds' grid and optionally from cells without upslope contributing areas (i.e. summits, ridges). Seeds will be all grid cells, that are not 'no data' values. If seeds are not given, only summits and ridges as given by the flow routing will be taken into account. Available flow routing methods are based on the 'Deterministic 8 (D8)' (Callaghan and Mark 1984) and the 'Multiple Flow Direction (FD8)' (Freeman 1991, Quinn et al. 1991) algorithms.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputELEVATION--
Seeds (*)Grid, input, optionalSEED--
OutputFlow Path LengthGrid, outputLENGTH--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Seeds OnlyBooleanSEEDS_ONLYUse only seed cells as starting points.Default: 0
Flow Routing AlgorithmChoiceMETHOD-Available Choices:
[0] Deterministic 8 (D8)
[1] Multiple Flow Direction (FD8)
Default: 1
Convergence (FD8)Floating pointCONVERGENCEConvergence factor for the 'Multiple Flow Direction' algorithm (after Freeman 1991)Minimum: 0.001000
Default: 1.100000
(*) optional

Command-line

Usage: saga_cmd ta_hydrology 6 [-ELEVATION <str>] [-SEED <str>] [-LENGTH <str>] [-SEEDS_ONLY <str>] [-METHOD <str>] [-CONVERGENCE <double>]
  -ELEVATION:<str>     	Elevation
	Grid, input
  -SEED:<str>          	Seeds
	Grid, input, optional
  -LENGTH:<str>        	Flow Path Length
	Grid, output
  -SEEDS_ONLY:<str>    	Seeds Only
	Boolean
	Default: 0
  -METHOD:<str>        	Flow Routing Algorithm
	Choice
	Available Choices:
	[0] Deterministic 8 (D8)
	[1] Multiple Flow Direction (FD8)
	Default: 1
  -CONVERGENCE:<double>	Convergence (FD8)
	Floating point
	Minimum: 0.001000
	Default: 1.100000