DESCRIPTION

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.

NOTES

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 setnull=-1 map=my_map

EXAMPLES

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 out=test 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 out=test 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 out=test 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 out=test size=3,9 exclude=pielou alpha=2

SEE ALSO

r.li, r.li.pielou, r.li.renyi, r.li.shannon, r.li.simpson

AUTHOR

Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy)

Last changed: $Date$