GRASS logo

NAME

r.li.pielou - Calculates Pielou's diversity index on a raster map

KEYWORDS

raster, landscape structure analysis, diversity index

SYNOPSIS

r.li.pielou
r.li.pielou help
r.li.pielou map=name conf=string output=name [--overwrite] [--verbose] [--quiet]

Flags:

--overwrite
Allow output files to overwrite existing files
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

map=name
Name of input raster map
conf=string
Configuration file
output=name
Name for output raster map

DESCRIPTION

r.li.pielou calculates the "pielou's diversity index" as:

with:

NOTES

Do not use absolute path names for output files. They are raster if moving window disposition was selected, otherwise they are in ~/.r.li/output/ folder.
If the input raster contains NULL value cells, r.li.pielou returns -1 for these cells.
If you want to keep NULL values instead, run subsequently on the resulting map:
r.null setnull=-1 map=my_map

EXAMPLES

To calculate Pielou's diversity index on the map "my_map", using the previously created "my_conf" configuration file (r.li.setup) and saving results in "my_out" raster map, run:
r.li.pielou map=my_map conf=my_conf output=my_out

REFERENCES

McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analysis program for quantifying landscape structure. USDA For. Serv. Gen. Tech. Rep. PNW-351. (PDF)

SEE ALSO

r.li, r.li.setup

AUTHORS

Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy), based on the r.li.shannon code developed by Serena Pallecchi student of Computer Science University of Pisa (Italy).

Last changed: $Date: 2010-11-24 08:49:21 -0800 (Wed, 24 Nov 2010) $


Main index - raster index - Full index

© 2003-2010 GRASS Development Team