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.diversity - Calculate diversity indices based on a moving window using r.li packages
KEYWORDS
raster
SYNOPSIS
r.diversity
r.diversity --help
r.diversity [-t] input=name prefix=name [alpha=alpha value for Renyi entropy[,alpha value for Renyi entropy,...]] [size=moving window[,moving window,...]] [method=method[,method,...]] [exclude=exclude method[,exclude method,...]] [--overwrite] [--help] [--verbose] [--quiet] [--ui]
Flags:
- -t
- Preserve configuration files
- --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:
- input=name [required]
- Name of input raster map
- prefix=name [required]
- Prefix for output raster map(s)
- alpha=alpha value for Renyi entropy[,alpha value for Renyi entropy,...]
- Order of generalized entropy (> 0.0; undefined for 1.0)
- size=moving window[,moving window,...]
- Size of processing window (odd number only)
- Default: 3
- method=method[,method,...]
- Name of methods to use
- Options: simpson, shannon, pielou, renyi
- Default: simpson,shannon,pielou,renyi
- exclude=exclude method[,exclude method,...]
- Exclude methods
- Options: simpson, shannon, pielou, renyi
r.diversity calculates selected diversity indices by
calling various
r.li commands.
This script uses the Pielou, Renyi, Shannon and Simpson indices. The
output is a map for each index.
The user does not need to create a "conf" file with
r.li.setup
because this file will be created automatically by the script.
In size option it is possible use more values: the user can set more
values with comma (,) and a range with minus (-).
If you calculate Renyi entropy remember to add the alpha option.
Alpha option support single and multi values but not a range.
If the input raster contains NULL value cells,
r.diversity
returns -1 for these cells.
If the user wants to keep NULL values instead, run subsequently on the
resulting map:
r.null map=my_map setnull=-1
To calculate the set of indices from a NDVI map, with a moving window
of 3 x 3 pixel, run:
r.diversity input=ndvi_map prefix=diversity alpha=0.5
To calculate the set of indices from a NDVI map, with a moving window
of 7 x 7 pixel, run:
r.diversity input=ndvi_map prefix=diversity alpha=0.5 size=7
To calculate only Pielou and Simpson indices from a NDVI map, with
several moving window (3 x 3, 5 x 5, 7 x 7, 9 x 9), run:
r.diversity input=ndvi_map prefix=diversity size=3-9 method=pielou,simpson
To calculate all methods excluding Pielou from a NDVI map, with two moving
window (3 x 3, 9 x 9), run:
r.diversity input=ndvi_map prefix=diversity size=3,9 exclude=pielou alpha=3
r.li,
r.li.pielou,
r.li.renyi,
r.li.shannon,
r.li.simpson
Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy)
SOURCE CODE
Available at:
r.diversity 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