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:
- J: Pielou eveness index
- H': Shannon index
- S: number of classes
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 17:49:21 +0100 (Wed, 24 Nov 2010) $
Full index
© 2003-2011 GRASS Development Team