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 |
|---|---|---|---|---|
|
raster file |
cells |
The map of the total contributing area, in cells. |
|
|
raster file |
1/m |
The map of the planar curvature, as computed by the Curvatures module. |
Outputs
Parameter |
Type |
Unit |
Description |
|---|---|---|---|
|
output file |
m |
The map of the contributing area per unit contour length. |
|
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.¶