SAGA 9.12.0 | Tool Library Documentation

Convergence Index


Description

This tool calculates an index of convergence (or divergence) with respect to overland flow direction. Its meaning is similar to that of plan or horizontal curvature, but produces much smoother results. The calculation uses the aspects of surrounding cells, i.e. it looks to which degree surrounding cells point to the center cell. Index values are percentages, with negative values corresponding to convergent, positive to divergent flow conditions. Plus 100 would be the peak of a summit, 0 an even slope, and minus 100 a pit.


Examples for index values with arrows indicating the aspect direction (a=+100%, b=0%, c=-100%)

Fig. 1: Examples for index values with arrows indicating the aspect direction (a=+100%, b=0%, c=-100%).


Real landscape example with contour lines and arrows indicating aspect direction

Fig. 2: Real landscape example with contour lines and arrows indicating aspect direction.



References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputELEVATION--
OutputConvergence Indexgrid, outputRESULT--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
DirectionschoiceMETHODUse either aspect only or the full gradient (including the sloping).Available Choices: [0] Aspect [1] Gradient Default: 0
NeighbourhoodchoiceNEIGHBOURSNeighbourhood used for aspect/slope calculation. Chosing '3x3' will give smoother results than '2x2'.Available Choices: [0] 2 x 2 [1] 3 x 3 Default: 0

Command Line


Usage: saga_cmd ta_morphometry 1 [-ELEVATION ] [-RESULT ] [-METHOD ] [-NEIGHBOURS ]
  -ELEVATION:    Elevation
	grid, input
  -RESULT:       Convergence Index
	grid, output
  -METHOD:       Directions
	choice
	Available Choices:
	[0] Aspect
	[1] Gradient
	Default: 0
  -NEIGHBOURS:   Neighbourhood
	choice
	Available Choices:
	[0] 2 x 2
	[1] 3 x 3
	Default: 0

Description Editor(s): O.Conrad (2026)