TopIndex

The topographic index, ln(a/tan β), expresses how much a cell tends to saturate: cells with a large contributing area a and a gentle slope β, typically the concave areas near the network, saturate first. It depends only on the morphology, and is the base of the TOPMODEL family of models, where the cells with the same index behave the same way.

Here the contributing area is the total contributing area in cells, from DrainDir, and the slope is the one along the drainage directions, from Slope.

Where the slope is 0, the index is not defined and the cell is left as no-data. These cells, with a very gentle slope, are the most prone to saturate: in models like Peakflow they are usually set to the highest value of the map, with the Map Calculator.

Parameters

Calculates the topographic index, ln(a/tan β), the natural logarithm of the contributing area over the slope: the higher it is, the more the cell tends to saturate. It depends only on the morphology. It is not defined where the slope is 0, which is left as no-data.

Toolbox folder: Basin
Status: Certified
Keywords: Topographic index, Saturation, Hydrology
Authors: Daniele Andreis, Antonello Andrea, Erica Ghesla, Cozzini Andrea, Franceschi Silvia, Pisoni Silvano, Rigon Riccardo
Class: org.hortonmachine.modules.TopIndex

Inputs

Parameter

Type

Unit

Default

Description

inTca

raster file

cells

The map of the total contributing area, in cells.

inSlope

raster file

m/m

The map of the slope along the drainage directions, as the tangent of the slope angle.

Outputs

Parameter

Type

Unit

Description

outTopindex

output file

The map of the topographic index.

References

  • Beven, K. J., Kirkby, M. J. (1979). A physically based, variable contributing area model of basin hydrology. Hydrological Sciences Bulletin, 24(1), 43-69.

Example

The example runs on the sample elevation model of the manual, dtm_flanginec.tif in docs/manual/modules/maps/data, each module on the outputs of the previous ones:

import org.hortonmachine.modules.TopIndex

// the folder with the elevation model: change it to yours
var folder = "/data/flanginec/"

var topIndex = new TopIndex()
topIndex.inTca = folder + "tca.tif"
topIndex.inSlope = folder + "slope.tif"
topIndex.outTopindex = folder + "topindex.tif"
topIndex.process()
The topographic index of the sample area: the highest values are along the network, where the soil saturates first.

The topographic index of the sample area: the highest values are along the network, where the soil saturates first.