r.li.shannon.1grass

Langue: en

Autres versions - même langue

Version: 337063 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

r.li.shannon - Calculates Shannon's diversity index on a raster map

KEYWORDS

raster, landscape structure analysis, diversity index

SYNOPSIS

r.li.shannon
r.li.shannon help
r.li.shannon 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.shannon calculates the "shannon's diversity index" as:
with:
i: patch type
m: number of patch type
pi: proportion of the landscape occupied by patch type i

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.

EXAMPLES

To calculate shannon's diversity index on map my_map, using my_conf configuration file and saving results in my_out file run:

r.li.shannon map=my_map conf=my_conf output=my_out

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 input raster is full of null values r.li.shannon returns -1.
If you want to have null values instead run

r.null setnull=-1 map=my_map
after index calculation.

SEE ALSO

r.li

AUTHORS

Serena Pallecchi student of Computer Science University of Pisa (Italy).
Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)

BUGS

Please send bugs reports to pallecch@cli.di.unipi.it

Last changed: $Date: 2007-02-08 17:52:53 +0100 (gio, 08 feb 2007) $

Full index

© 2003-2010 GRASS Development Team