Tca3d¶
The total contributing area usually counts the cells draining into each cell, so it measures the plan area. On steep terrain the real surface of a cell is larger than its plan area: on a slope of 45 degrees, about 1.4 times. Tca3d sums the real, three-dimensional surface of the cells, computed from the triangles between each cell and its neighbours, so that the areas grow more on the steep slopes.
Parameters¶
Calculates the total contributing areas as the real, three-dimensional surface of the cells draining into each cell, instead of their number: on steep terrain the surface of a cell is larger than its plan area.
Toolbox folder: Geomorphology
Status: Certified
Keywords: Geomorphology, Contributing area, 3D
Authors: Daniele Andreis, Antonello Andrea, Erica Ghesla, Cozzini Andrea, Franceschi Silvia, Pisoni Silvano, Rigon Riccardo
Class: org.hortonmachine.modules.Tca3d
Inputs
Parameter |
Type |
Unit |
Default |
Description |
|---|---|---|---|---|
|
raster file |
m |
The map of the depitted elevation. |
|
|
raster file |
The map of the drainage directions. |
Outputs
Parameter |
Type |
Unit |
Description |
|---|---|---|---|
|
output file |
m² |
The map of the three-dimensional total contributing areas. |
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.Tca3d
// the folder with the elevation model: change it to yours
var folder = "/data/flanginec/"
var tca3d = new Tca3d()
tca3d.inPit = folder + "pit.tif"
tca3d.inFlow = folder + "drain.tif"
tca3d.outTca = folder + "tca3d.tif"
tca3d.process()
The three-dimensional total contributing area of the sample area, in m².¶