GRASS logo

Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

r.basin - Morphometric characterization of river basins

KEYWORDS

raster, hydrology, watershed

SYNOPSIS

r.basin
r.basin --help
r.basin [-ac] map=name prefix=prefix coordinates=east,north dir=name [threshold=threshold] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a
Use default threshold (1km^2)
-c
No maps output
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

map=name [required]
Name of elevation raster map
prefix=prefix [required]
output prefix (must start with a letter)
coordinates=east,north [required]
coordinates of the outlet (east,north)
dir=name [required]
Directory where the output will be found
threshold=threshold
threshold

Table of contents

DESCRIPTION

r.basin generates the main morphometric parameters of the basin starting from the digital elevation model and the coordinates of the basin's closing section (outlet). Important: r.basin works in projected locations, geographic or xy-locations are not supported.

The closing section's coordinates must belong to the river network generated by r.stream.extract. It is suggested to run it beforehand. In GRASS GIS 7, r.basin has been improved to take in input coordinates not exactly belonging to the river network (but not too far from it). It basically snaps to the closest point belonging to the network. This feature is experimental and might not produce the expected result. To check if the snapped outlet is acceptable, at the end of the computation, two outlet vector maps are produced: the one with the coordinates inserted by the user and the snapped one. If the user is not happy with this latter, should tweak the coordinates to match with the river network.

Morphometric parameters of basin

The main parameters are:
mean slope

where N is the topological diameter, i.e. the number of links in which the main channel can be divided on the basis of the junctions.
concentration time

where A is the area, L the length of the main channel and H the difference between the highest and the lowest elevation of the basin.

Plots

EXAMPLE

North Carolina sample dataset example:
g.region raster=elevation -p
r.basin map=elevation prefix=my_basin coord=637304.924954,218617.100523 \
 dir=/tmp/my_basin threshold=1000

# visualize some results
d.mon wx0
d.rast my_basin_elevation_hack

d.rast my_basin_elevation_dist2out

d.his i=aspect h=my_basin_elevation_dist2out

r.basin results

Dependencies

Known issues

SEE ALSO

r.hypso (Addon), r.stream.basins (Addon), r.stream.channel (Addon), r.stream.distance (Addon), r.stream.extract, r.stream.order (Addon), r.stream.segment (Addon), r.stream.slope (Addon), r.stream.snap (Addon), r.stream.stats (Addon), r.watershed, r.width.funct (Addon)
Related Wiki page

CITE AS

Di Leo Margherita, Di Stefano Massimo (2013) An Open-Source Approach for Catchment's Physiographic Characterization, Abstract H52E-06 presented at 2013 Fall Meeting, AGU, San Francisco, CA, USA 9-13 Dec. abstract

REFERENCES

AUTHORS

Margherita Di Leo (grass-dev AT lists DOT osgeo DOT org ), Massimo Di Stefano

SOURCE CODE

Available at: r.basin source code (history)

Latest change: Monday Jun 28 12:12:50 2021 in commit: 9ac565873d0a52736c1d190498b8dea23d09dd77


Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.9dev Reference Manual