SAGA 9.3.3 | Tool Library Documentation

Overland Flow Distance to Channel Network


Description

This tool calculates overland flow distances to a channel network based on gridded digital elevation data and channel network information. The flow algorithm may be either Deterministic 8 (O'Callaghan & Mark 1984) or Multiple Flow Direction (Freeman 1991). Sediment Delivery Rates (SDR) according to Ali & De Boer (2010) can be computed optionally.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputELEVATIONA grid that contains elevation data.-
Channel Networkgrid, inputCHANNELSA grid providing information about the channel network. It is assumed that no-data cells are not part of the channel network. Vice versa all others cells are recognised as channel network members.-
Preferred Routinggrid, input, optionalROUTEDownhill flow is bound to preferred routing cells, where these are not no-data. Helps to model e.g. small ditches, that are not well represented in the elevation data.-
Fieldsgrid, input, optionalFIELDSIf set, output is given about the number of fields a flow path visits downhill. For D8 only.-
Manning-Strickler Coefficientgrid, input, optionalFLOW_KManning-Strickler coefficient for flow travel time estimation (reciprocal of Manning's Roughness Coefficient)-
Flow Depthgrid, input, optionalFLOW_Rflow depth [m] for flow travel time estimation-
OutputOverland Flow Distancegrid, outputDISTANCEThe overland flow distance in map units. It is assumed that the (vertical) elevation data use the same units as the (horizontal) grid coordinates.-
Vertical Overland Flow Distancegrid, outputDISTVERTThis is the vertical component of the overland flow-
Horizontal Overland Flow Distancegrid, outputDISTHORZThis is the horizontal component of the overland flow-
Flow Travel Timegrid, output, optionalTIMEflow travel time to channel expressed in hours based on Manning's Equation-
Sediment Yield Delivery Ratiogrid, output, optionalSDRThis is the horizontal component of the overland flow-
Fields Visitedgrid, outputPASSESNumber of fields a flow path visits downhill starting at a cell. For D8 only.-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Flow AlgorithmchoiceMETHODChoose a flow routing algorithm that shall be used for the overland flow distance calculation: - D8 - MFDAvailable Choices: [0] D8 [1] MFD Default: 1
Boundary CellsbooleanBOUNDARYTake cells at the boundary of the DEM as channel.Default: 0
Betafloating point numberFLOW_Bcatchment specific parameter for sediment delivery ratio calculationMinimum: 0.000000 Default: 1.000000
Defaultfloating point numberFLOW_K_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Default: 20.000000
Defaultfloating point numberFLOW_R_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Default: 0.050000

Command Line


Usage: saga_cmd ta_channels 4 [-ELEVATION ] [-CHANNELS ] [-ROUTE ] [-DISTANCE ] [-DISTVERT ] [-DISTHORZ ] [-TIME ] [-SDR ] [-FIELDS ] [-PASSES ] [-METHOD ] [-BOUNDARY ] [-FLOW_B ] [-FLOW_K ] [-FLOW_K_DEFAULT ] [-FLOW_R ] [-FLOW_R_DEFAULT ]
  -ELEVATION:        	Elevation
	grid, input
  -CHANNELS:         	Channel Network
	grid, input
  -ROUTE:            	Preferred Routing
	grid, input, optional
  -DISTANCE:         	Overland Flow Distance
	grid, output
  -DISTVERT:         	Vertical Overland Flow Distance
	grid, output
  -DISTHORZ:         	Horizontal Overland Flow Distance
	grid, output
  -TIME:             	Flow Travel Time
	grid, output, optional
  -SDR:              	Sediment Yield Delivery Ratio
	grid, output, optional
  -FIELDS:           	Fields
	grid, input, optional
  -PASSES:           	Fields Visited
	grid, output
  -METHOD:           	Flow Algorithm
	choice
	Available Choices:
	[0] D8
	[1] MFD
	Default: 1
  -BOUNDARY:         	Boundary Cells
	boolean
	Default: 0
  -FLOW_B:        	Beta
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -FLOW_K:           	Manning-Strickler Coefficient
	grid, input, optional
  -FLOW_K_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Default: 20.000000
  -FLOW_R:           	Flow Depth
	grid, input, optional
  -FLOW_R_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Default: 0.050000