H2cA

H2cA gives each hillslope cell the value that a map has on the network cell into which the hillslope drains. It connects the hillslopes to the properties of their channels: the number of the link, the contributing area, the elevation of the channel.

With the elevation, the difference between the elevation of each cell and that of its channel is the height above the nearest drainage (HAND): low values are the areas that a rise of the channel can flood, high values the areas well above it. All the paths must end in a channel or in an outlet marked with the value 10, for example with MarkOutlets.

Parameters

Gives each hillslope cell the value that a map has on the network cell into which the hillslope drains. For example, with the elevation it gives the elevation of the channel each cell drains into, and its difference with the elevation is the height above the nearest drainage.

Toolbox folder: Hillslope
Status: Certified
Keywords: Hillslope, Network, Attribute
Authors: Antonello Andrea, Franceschi Silvia, Andreis Daniele, Erica Ghesla, Cozzini Andrea, Pisoni Silvano, Rigon Riccardo
Class: org.hortonmachine.modules.H2cA

Inputs

Parameter

Type

Unit

Default

Description

inFlow

raster file

The map of the drainage directions.

inNet

raster file

The map of the network.

inAttribute

raster file

The map whose values on the network are given to the hillslopes.

Outputs

Parameter

Type

Unit

Description

outAttribute

output file

The map of the values of the network cells into which each cell drains.

References

  • D’Odorico, P., Rigon, R. (2003). Hillslope and channel contributions to the hydrologic response. Water Resources Research, 39(5), 1113.

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.H2cA
import org.hortonmachine.modules.Mapcalc

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

// the elevation of the channel into which each cell drains, in the basin of ExtractBasin:
// all the paths must end in a channel or in a marked outlet
var h2ca = new H2cA()
h2ca.inFlow = folder + "drain_marked.tif"
h2ca.inNet = folder + "net_basin.tif"
h2ca.inAttribute = folder + "pit.tif"
h2ca.outAttribute = folder + "channel_elev.tif"
h2ca.process()

// the height above the nearest drainage
var mapcalc = new Mapcalc()
mapcalc.inRaster1 = folder + "pit.tif"
mapcalc.inRaster2 = folder + "channel_elev.tif"
// the module needs the full Jiffle script, with the maps declared in the images block
mapcalc.pFunction = """
images {
    pit = read;
    channel_elev = read;
    hand = write;
}
hand = pit - channel_elev;
"""
mapcalc.outRaster = folder + "hand.tif"
mapcalc.process()
The height above the nearest drainage of the basin of ExtractBasin, in meters: the elevation minus the elevation of the channel each cell drains into, computed with the Mapcalc module. The colors span from the 2nd to the 98th percentile of the values.

The height above the nearest drainage of the basin of ExtractBasin, in meters: the elevation minus the elevation of the channel each cell drains into, computed with the Mapcalc module. The colors span from the 2nd to the 98th percentile of the values.