SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Upslope Area

This tool allows you to specify target cells, for which the upslope contributing area shall be identified. The result will give for each cell the percentage of its flow that reaches the target cell(s).
_______

This version uses all valid cells (not 'no data' values) of a given target grid to determine the contributing area. In case no target grid is provided as input, the specified x/y coordinates are used as target point.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputTarget Area (*)Grid, input, optionalTARGET--
ElevationGrid, inputELEVATION--
Sink Routes (*)Grid, input, optionalSINKROUTE--
OutputUpslope AreaGrid, outputAREA--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Target X coordinateFloating pointTARGET_PT_XThe x-coordinate of the target point in world coordinates [map units]Default: 0.000000
Target Y coordinateFloating pointTARGET_PT_YThe y-coordinate of the target point in world coordinates [map units]Default: 0.000000
MethodChoiceMETHOD-Available Choices:
[0] Deterministic 8
[1] Deterministic Infinity
[2] Multiple Flow Direction
[3] Multiple Triangular Flow Directon
[4] Multiple Maximum Downslope Gradient Based Flow Directon
Default: 2
ConvergenceFloating pointCONVERGEConvergence factor for Multiple Flow Direction algorithmMinimum: 0.001000
Default: 1.100000
Contour LengthBooleanMFD_CONTOURInclude (pseudo) contour length as additional weighting factor in multiple flow direction routing, reduces flow to diagonal neighbour cells by a factor of 0.71 (s. Quinn et al. 1991 for details).Default: 0
(*) optional

Command-line

Usage: saga_cmd ta_hydrology 4 [-TARGET <str>] [-TARGET_PT_X <double>] [-TARGET_PT_Y <double>] [-ELEVATION <str>] [-SINKROUTE <str>] [-AREA <str>] [-METHOD <str>] [-CONVERGE <double>] [-MFD_CONTOUR <str>]
  -TARGET:<str>        	Target Area
	Grid, input, optional
  -TARGET_PT_X:<double>	Target X coordinate
	Floating point
	Default: 0.000000
  -TARGET_PT_Y:<double>	Target Y coordinate
	Floating point
	Default: 0.000000
  -ELEVATION:<str>     	Elevation
	Grid, input
  -SINKROUTE:<str>     	Sink Routes
	Grid, input, optional
  -AREA:<str>          	Upslope Area
	Grid, output
  -METHOD:<str>        	Method
	Choice
	Available Choices:
	[0] Deterministic 8
	[1] Deterministic Infinity
	[2] Multiple Flow Direction
	[3] Multiple Triangular Flow Directon
	[4] Multiple Maximum Downslope Gradient Based Flow Directon
	Default: 2
  -CONVERGE:<double>   	Convergence
	Floating point
	Minimum: 0.001000
	Default: 1.100000
  -MFD_CONTOUR:<str>   	Contour Length
	Boolean
	Default: 0