Ab

The contributing area per unit contour length, a/b, is the area that drains through each metre of contour line crossing a cell: the specific contributing area. It measures how much water reaches a cell better than the total contributing area alone, because the same area spreads on divergent slopes and concentrates in convergent ones. It is used by the steady-state hydrological models, like the one of Shalstab.

The contour length b is estimated from the planar curvature of the cell, from the Curvatures module: it is longer on divergent, convex cells, and shorter on convergent, concave ones, between 0.1 and 1.9 times the cell size; on planar cells it is the cell size.

Details

The contour length b is derived from the planar curvature k of the cell: the contour line is approximated by an arc of radius r = 1/k, whose ends, a cell size L apart, enclose the angle α = 2 arcsin(L/2r). The length of the arc at the downslope side of the cell is taken as b: b = 2 arcsin(L/2r) (r - L).

In convergent cells (positive curvature) the contour shrinks downslope and b is smaller than L, in divergent cells (negative curvature) it widens and b is larger than L. On planar cells b is L. The values are limited between 0.1 L and 1.9 L, which are also used where the radius is smaller than the cell.

Parameters

Calculates the contributing area per unit contour length (a/b) of each cell, the specific contributing area used by the hydrological and slope stability models. The contour length b is estimated from the planar curvature, between 0.1 and 1.9 times the cell size.

Toolbox folder: Geomorphology
Status: Certified
Keywords: Geomorphology, Contributing area, Specific contributing area
Authors: Andrea Antonello, Erica Ghesla, Rigon Riccardo, Andrea Cozzini, Silvano Pisoni
Class: org.hortonmachine.modules.Ab

Inputs

Parameter

Type

Unit

Default

Description

inTca

raster file

cells

The map of the total contributing area, in cells.

inPlan

raster file

1/m

The map of the planar curvature, as computed by the Curvatures module.

Outputs

Parameter

Type

Unit

Description

outAb

output file

m

The map of the contributing area per unit contour length.

outB

output file

m

The map of the contour length.

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.Ab

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

var ab = new Ab()
ab.inTca = folder + "tca.tif"
ab.inPlan = folder + "plan.tif"
ab.outAb = folder + "ab.tif"
ab.outB = folder + "b.tif"
ab.process()
The contributing area per unit contour length of the sample area, in m.

The contributing area per unit contour length of the sample area, in m.