SAGA 9.3.3 | Tool Library Documentation

Channel Network


Description

This tool derives a channel network based on gridded digital elevation data. Use the initiation options to determine under which conditions channels shall start.


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputELEVATIONA grid that contains elevation data.-
Flow Directiongrid, input, optionalSINKROUTEAn optional grid that provides information about flow directions. Values between 1 to 8 force the flow of a cell to be given to one its adjacent neighbor cells (1->NE, 2->E, 3->SE, 4->S, 5->SW, 6->W, 7->NW, 8->N). In case of other values the algorithm will use its own routing scheme. This option is in particular useful to supply the algorithm with routes that lead the flow through closed depression. -
Initiation Gridgrid, inputINIT_GRIDDependent on the chosen 'Initiation Type' and 'Initiation Threshold' the values of this grid control where a channel is initiated.-
Divergencegrid, input, optionalDIV_GRIDTracing: Convergence-
Tracing: Weightgrid, input, optionalTRACE_WEIGHTTracing: Weight-
OutputChannel Networkgrid, outputCHNLNTWRKIf a cell is part of a channel its value equals the channel order. Otherwise the cell is marked as no-data.-
Channel Directiongrid, outputCHNLROUTEIf a cell is part of a channel then its value shows the flow direction of the channel (1->NE, 2->E, 3->SE, 4->S, 5->SW, 6->W, 7->NW, 8->N). Otherwise the cell is marked as no-data.-
Channel Networkshapes, outputSHAPESThis shapes layer will contain the resulting channel network in vector format (lines).-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Initiation TypechoiceINIT_METHODOptions: - Less than - Equals - Greater than Controls under which condition a channel is initiated.Available Choices: [0] Less than [1] Equals [2] Greater than Default: 2
Initiation Thresholdfloating point numberINIT_VALUEDependent on the chosen 'Initiation Grid' and 'Initiation Type' this value controls under which condition a channel is initiated.Default: 0.000000
Tracing: Max. Divergenceinteger numberDIV_CELLSTracing: Stop after x cells with divergent flowMinimum: 1 Default: 5
Min. Segment Lengthinteger numberMINLENMinimum Segment Length (Cells)Default: 10

Command Line


Usage: saga_cmd ta_channels 0 [-ELEVATION ] [-SINKROUTE ] [-CHNLNTWRK ] [-CHNLROUTE ] [-SHAPES ] [-INIT_GRID ] [-INIT_METHOD ] [-INIT_VALUE ] [-DIV_GRID ] [-DIV_CELLS ] [-TRACE_WEIGHT ] [-MINLEN ]
  -ELEVATION:    	Elevation
	grid, input
  -SINKROUTE:    	Flow Direction
	grid, input, optional
  -CHNLNTWRK:    	Channel Network
	grid, output
  -CHNLROUTE:    	Channel Direction
	grid, output
  -SHAPES:       	Channel Network
	shapes, output
  -INIT_GRID:    	Initiation Grid
	grid, input
  -INIT_METHOD:  	Initiation Type
	choice
	Available Choices:
	[0] Less than
	[1] Equals
	[2] Greater than
	Default: 2
  -INIT_VALUE:	Initiation Threshold
	floating point number
	Default: 0.000000
  -DIV_GRID:     	Divergence
	grid, input, optional
  -DIV_CELLS:    	Tracing: Max. Divergence
	integer number
	Minimum: 1
	Default: 5
  -TRACE_WEIGHT: 	Tracing: Weight
	grid, input, optional
  -MINLEN:       	Min. Segment Length
	integer number
	Default: 10