GRASS logo


r.topidx - Creates a topographic index (wetness index) raster map from an elevation raster map.


raster, hydrology, wetness, topographic index


r.topidx --help
r.topidx input=name output=name [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


input=name [required]
Name of input elevation raster map
output=name [required]
Name for output topographic index raster map

Table of contents


r.topidx creates topographic index (wetness index), ln(a/tan(beta)), map from elevation map where
the area of the hillslope per unit contour length that drains through any point,
the local surface topographic slope (delta vertical) / (delta horizontal).

Input maps may have NULL values. For example, if you have a MASK for a watershed (basin map from r.water.outlet), the following command will create a masked elevation map (belev):

r.mapcalc "belev = if(isnull(basin), basin, elev)"

r.stats -Anc prints out averaged statistics for topographic index.

Unprojected lat/long locations are not supported. If data is not projected in a lat/long location, please create a new location in a projected coordinate system and reproject the data into the new projected location. Please run r.topidx from that location.


Running the command below will generate the topographic index map shown in the figure:
g.region raster=elevation -p
r.topidx input=elevation output=topidx_elevation
r.topidx example
Figure: topographic index map derived from elevation map


Cho, H., 2000. GIS Hydrological Modeling System by Using Programming Interface of GRASS. Master's Thesis, Department of Civil Engineering, Kyungpook National University, Korea.

Moore, I.D., R.B. Grayson, and A.R. Ladson, 1991. Digital Terrain Modeling: A Review of Hydrological, Geomorphological, and Biological Applications. Hydrological Processes 5:3-30.


r.topmodel, r.water.outlet, r.mapcalc
Known issues


Huidae Cho
Hydro Laboratory, Kyungpook National University, South Korea

Based on GRIDATB.FOR by Keith Beven.


Available at: r.topidx source code (history)

Latest change: Monday Mar 11 20:26:40 2024 in commit: a4b31882f5ca36f4c0d85fc7ef4e2f942281592c

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

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual