SAGA 9.12.0 | Tool Library Documentation

Flow Accumulation (Flow Tracing)


Description

Flow tracing algorithms for calculations of flow accumulation and related parameters. These algorithms trace the flow of each cell in a DEM separately until it finally leaves the DEM or ends in a sink. The Rho 8 implementation (Fairfield & Leymarie 1991) adopts the original algorithm only for the flow routing and will give quite different results.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputELEVATION--
Sink Routesgrid, input, optionalSINKROUTE--
Weightsgrid, input, optionalWEIGHTS--
Sinksgrid, input, optionalSINKSA grid indicating sink (terminal) cells. Cells with valid values (i.e. not NoData) act as sinks that capture all incoming flow and sediment and do not route anything downslope.-
Input for Mean over Catchmentgrid, input, optionalVAL_INPUT--
Material for Accumulationgrid, input, optionalACCU_MATERIAL--
Accumulation Targetgrid, inputACCU_TARGET--
OutputFlow Accumulationgrid, outputFLOW--
Mean over Catchmentgrid, outputVAL_MEAN--
Accumulated Materialgrid, output, optionalACCU_TOTAL--
Accumulated Material (Left Side)grid, output, optionalACCU_LEFT--
Accumulated Material (Right Side)grid, output, optionalACCU_RIGHT--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Stepinteger numberSTEPFor testing purposes. Only generate flow at cells with step distance (each step row/column).Minimum: 1 Default: 1
Flow Accumulation UnitchoiceFLOW_UNIT-Available Choices: [0] number of cells [1] cell area Default: 1
MethodchoiceMETHOD-Available Choices: [0] Rho 8 [1] Kinematic Routing Algorithm [2] DEMON Default: 1
Flow CorrectionbooleanCORRECT-Default: 1
Minimum DQVfloating point numberMINDQVDEMON - Minimum Drainage Quota Volume (DQV) for traced flow tubesMinimum: 0.000000 Maximum: 1.000000 Default: 0.000000

Command Line


Usage: saga_cmd ta_hydrology 2 [-ELEVATION ] [-SINKROUTE ] [-WEIGHTS ] [-SINKS ] [-FLOW ] [-VAL_INPUT ] [-VAL_MEAN ] [-ACCU_MATERIAL ] [-ACCU_TARGET ] [-ACCU_TOTAL ] [-ACCU_LEFT ] [-ACCU_RIGHT ] [-STEP ] [-FLOW_UNIT ] [-METHOD ] [-CORRECT ] [-MINDQV ]
  -ELEVATION:       Elevation
	grid, input
  -SINKROUTE:       Sink Routes
	grid, input, optional
  -WEIGHTS:         Weights
	grid, input, optional
  -SINKS:           Sinks
	grid, input, optional
  -FLOW:            Flow Accumulation
	grid, output
  -VAL_INPUT:       Input for Mean over Catchment
	grid, input, optional
  -VAL_MEAN:        Mean over Catchment
	grid, output
  -ACCU_MATERIAL:   Material for Accumulation
	grid, input, optional
  -ACCU_TARGET:     Accumulation Target
	grid, input
  -ACCU_TOTAL:      Accumulated Material
	grid, output, optional
  -ACCU_LEFT:       Accumulated Material (Left Side)
	grid, output, optional
  -ACCU_RIGHT:      Accumulated Material (Right Side)
	grid, output, optional
  -STEP:            Step
	integer number
	Minimum: 1
	Default: 1
  -FLOW_UNIT:       Flow Accumulation Unit
	choice
	Available Choices:
	[0] number of cells
	[1] cell area
	Default: 1
  -METHOD:          Method
	choice
	Available Choices:
	[0] Rho 8
	[1] Kinematic Routing Algorithm
	[2] DEMON
	Default: 1
  -CORRECT:         Flow Correction
	boolean
	Default: 1
  -MINDQV:       Minimum DQV
	floating point number
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.000000