RescaledDistance¶
The distance of each cell from the outlet, along the drainage directions, gives the width function of the basin: how many cells are at each distance. Divided by a velocity, it tells when the water of each cell reaches the outlet.
The water is however much faster in the channels than on the hillslopes. The rescaled distance multiplies the hillslope part of each path by the ratio r between the channel and the hillslope velocities, so that the whole distance becomes proportional to the travel time at the channel velocity. Low ratios (5 to 20) describe the fast surface runoff, high ratios (50 to 200) the slow subsurface flow: Peakflow uses one of each.
The outlets are found from the maps: they are the network cells that drain out of the map, or into no-data cells. With an elevation map, the distances are measured in 3D.
Parameters¶
Calculates the rescaled distance of each cell from the outlet along the drainage directions: the distance along the hillslopes is multiplied by the ratio between the channel and the hillslope velocities, so that it becomes proportional to the travel time. The outlets are the network cells draining out of the map.
Toolbox folder: Basin
Status: Certified
Keywords: Basin, Geomorphology, Width function, Distance to outlet
Authors: Antonello Andrea, Franceschi Silvia, Daniele Andreis, Erica Ghesla, Cozzini Andrea, Pisoni Silvano, Rigon Riccardo
Class: org.hortonmachine.modules.RescaledDistance
Inputs
Parameter |
Type |
Unit |
Default |
Description |
|---|---|---|---|---|
|
raster file |
The map of the drainage directions. |
||
|
raster file |
The map of the network. |
||
|
raster file |
The optional map of the elevation, to measure the distances in 3D. |
||
|
double |
|
The ratio between the velocity in the channels and on the hillslopes, usually from 5 to 200. With 0, the hillslope paths add nothing to the distance. |
Outputs
Parameter |
Type |
Unit |
Description |
|---|---|---|---|
|
output file |
m |
The map of the rescaled distances. |
References
D’Odorico, P., Rigon, R. (2003). Hillslope and channel contributions to the hydrologic response. Water Resources Research, 39(5), 1113. doi:10.1029/2002WR001708
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.RescaledDistance
// the folder with the elevation model: change it to yours
var folder = "/data/flanginec/"
var rescaledDistance = new RescaledDistance()
rescaledDistance.inFlow = folder + "drain_basin.tif"
rescaledDistance.inNet = folder + "net_basin.tif"
// the water is 10 times faster in the channels than on the hillslopes
rescaledDistance.pRatio = 10
rescaledDistance.outRescaled = folder + "rescaled.tif"
rescaledDistance.process()
The rescaled distance from the outlet of the basin, in m, with a ratio of 10 between the channel and the hillslope velocities: the hillslopes far from the network get the largest values.¶