SAGA-GIS Module Library Documentation (v2.1.3)

Module Catchment Area (Recursive)

Recursive upward processing of cells for calculation of flow accumulation and related parameters. This set of algorithms processes recursively all upwards connected cells until each cell of the DEM has been processed.

References:

Deterministic 8
- O'Callaghan, J.F. / Mark, D.M. (1984):
'The extraction of drainage networks from digital elevation data',
Computer Vision, Graphics and Image Processing, 28:323-344

Rho 8:
- Fairfield, J. / Leymarie, P. (1991):
'Drainage networks from grid digital elevation models',
Water Resources Research, 27:709-717

Deterministic Infinity:
- Tarboton, D.G. (1997):
'A new method for the determination of flow directions and upslope areas in grid digital elevation models',
Water Resources Research, Vol.33, No.2, p.309-319

Multiple m_Flow Direction:
- Freeman, G.T. (1991):
'Calculating catchment area with divergent flow based on a regular grid',
Computers and Geosciences, 17:413-22

- Quinn, P.F. / Beven, K.J. / Chevallier, P. / Planchon, O. (1991):
'The prediction of hillslope flow paths for distributed hydrological modelling using digital terrain models',
Hydrological Processes, 5:59-79

Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid (input)ELEVATION--
Sink Routes (*)Grid (optional input)SINKROUTE--
Weight (*)Grid (optional input)WEIGHT--
Input for Mean over Catchment Calculation (*)Grid (optional input)VAL_INPUT--
Material (*)Grid (optional input)MATERIAL--
Accumulation Target (*)Grid (optional input)TARGET--
Target Areas (*)Grid (optional input)TARGETS--
OutputCatchment AreaGrid (output)CAREA--
Mean over CatchmentGrid (output)VAL_MEAN--
Total accumulated Material (*)Grid (optional output)ACCU_TOT--
Accumulated Material from Left Side (*)Grid (optional output)ACCU_LEFT--
Accumulated Material from Right Side (*)Grid (optional output)ACCU_RIGHT--
m_Flow Path Length (*)Grid (optional output)FLOWLEN--
OptionsStepIntegerSTEP-Minimum: 1
Default: 1
MethodChoiceMETHOD-Available Choices:
[0] Deterministic 8
[1] Rho 8
[2] Deterministic Infinity
[3] Multiple m_Flow Direction
Default: 3
ConvergenceFloating pointCONVERGENCEConvergence factor for Multiple m_Flow Direction Algorithm (Freeman 1991)Default: 1.100000
(*) optional

Command-line

Usage: saga_cmd ta_hydrology 1 -ELEVATION <str> [-SINKROUTE <str>] [-WEIGHT <str>] [-CAREA <str>] [-VAL_INPUT <str>] [-VAL_MEAN <str>] [-MATERIAL <str>] [-TARGET <str>] [-ACCU_TOT <str>] [-ACCU_LEFT <str>] [-ACCU_RIGHT <str>] [-STEP <num>] [-TARGETS <str>] [-FLOWLEN <str>] [-METHOD <str>] [-CONVERGENCE <str>]
  -ELEVATION:<str>  	Elevation
	Grid (input)
  -SINKROUTE:<str>  	Sink Routes
	Grid (optional input)
  -WEIGHT:<str>     	Weight
	Grid (optional input)
  -CAREA:<str>      	Catchment Area
	Grid (output)
  -VAL_INPUT:<str>  	Input for Mean over Catchment Calculation
	Grid (optional input)
  -VAL_MEAN:<str>   	Mean over Catchment
	Grid (output)
  -MATERIAL:<str>   	Material
	Grid (optional input)
  -TARGET:<str>     	Accumulation Target
	Grid (optional input)
  -ACCU_TOT:<str>   	Total accumulated Material
	Grid (optional output)
  -ACCU_LEFT:<str>  	Accumulated Material from Left Side
	Grid (optional output)
  -ACCU_RIGHT:<str> 	Accumulated Material from Right Side
	Grid (optional output)
  -STEP:<num>       	Step
	Integer
	Minimum: 1
	Default: 1
  -TARGETS:<str>    	Target Areas
	Grid (optional input)
  -FLOWLEN:<str>    	m_Flow Path Length
	Grid (optional output)
  -METHOD:<str>     	Method
	Choice
	Available Choices:
	[0] Deterministic 8
	[1] Rho 8
	[2] Deterministic Infinity
	[3] Multiple m_Flow Direction
	Default: 3
  -CONVERGENCE:<str>	Convergence
	Floating point
	Default: 1.100000