basindelin: Delineates hydrological basins

Description Usage Arguments Details Value See Also Examples

Description

basindelin uses digital elevation data to delineate hydrological basins.

Usage

1

Arguments

dem

a raster object, two-dimensional array or matrix of elevations.

Details

If dem is a raster object, a raster onbject is returned. This function is used to delineate hydrological basins. It iteratively identifies the lowest elevation pixel of dem, and assigns any of the eight adjoining pixels to the same basin if higher. The process is repeated on all assigned adjoining pixels until no further higher pixels are found. The next lowest unassigned pixel is then identified, a new basin identity assigned and the processes repeated until all pixels are assigned to a basin. Relative to heuristic algorithms, it is slow and run time increases exponentially with size of dtm. However, in contrast to many such algorithms, all basins are correctly seperated by boundaries >0. With large datasets, with e.g. > 160,000 pixels, the calculations will be slow and basindelin_big() should be used instead.

Value

a raster object, two-dimensional array or matrix with individual basins numbered sequentially as integers.

See Also

basindelin_big() for working with large datasets.

Examples

1
2
3
dem <- aggregate(dtm1m, 20)
basins <- basindelin (dem)
plot(basins, main = "Basins")

ilyamaclean/ecohydrotools documentation built on June 10, 2019, 5:45 a.m.