GRASS logo

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.width.funct - Calculates the Width Function of a watershed basin.

KEYWORDS

raster, hydrology

SYNOPSIS

r.width.funct
r.width.funct --help
r.width.funct map=name image=image [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--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]
Distance to outlet map (from r.stream.distance)
image=image [required]
Name for output graph file (png)

Table of contents

DESCRIPTION

r.width.funct produces the Width Function of a basin. The Width Function W(x) gives the number of the cells in a basin at a flow distance x from the outlet (it is also referred as distance-area function). It is important to underline the fact that the distance is not the euclidean one, but it is measured along the flowpath towards the outlet.

Input

Distance to outlet map: Input map, required. It is obtained by r.stream.distance (with the option: distance to outlet, flag -o).

Output plot: Path and name of the plot.

Output

It provides the quantiles of the area - distance distribution and the plot of the Width Function. In x axis is reported the distance and in y axis is the area.

EXAMPLE

North Carolina sample dataset example:
g.region raster=elevation -p

# Calculate flow direction
r.stream.extract elevation=elevation threshold=1000 \
direction=direction 

# Create outlet point 
echo "637304.924954,218617.100523" | v.in.ascii input=- sep=',' out=outlet

# Convert outlet point to raster
v.to.rast input=outlet type=point output=outlet use=cat

# Calculate distance to outlet map
r.stream.distance -o stream_rast=outlet \
direction=direction distance=dist2out

# Calculate width function
r.width.funct map=dist2out image=/tmp/my_basin

Dependencies

SEE ALSO

r.stream.distance, r.basin,

REFERENCES

AUTHORS

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

SOURCE CODE

Available at: r.width.funct source code (history)

Latest change: Mon Jun 28 07:54:09 2021 in commit: 1cfc0af029a35a5d6c7dae5ca7204d0eb85dbc55


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.8dev Reference Manual