r.li.shannon(1)

1r.li.shannon(1)               Grass User's Manual              r.li.shannon(1)
2
3
4

NAME

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

KEYWORDS

9       raster, landscape structure analysis, diversity index
10

SYNOPSIS

12       r.li.shannon
13       r.li.shannon help
14       r.li.shannon  map=name  conf=string output=name  [--overwrite]  [--ver‐
15       bose]  [--quiet]
16
17   Flags:
18       --overwrite
19           Allow output files to overwrite existing files
20
21       --verbose
22           Verbose module output
23
24       --quiet
25           Quiet module output
26
27   Parameters:
28       map=name
29           Name of input raster map
30
31       conf=string
32           Configuration file
33
34       output=name
35           Name for output raster map
36

DESCRIPTION

38       r.li.shannon calculates the "shannon's diversity index" as:
39       with:
40
41                     i: patch type
42
43                     m: number of patch type
44
45                     pi: proportion of the landscape occupied by patch type i
46

REFERENCES

48       McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analy‐
49       sis  program for quantifying landscape structure. USDA For. Serv.  Gen.
50       Tech. Rep. PNW-351.
51

EXAMPLES

53       To calculate shannon's diversity index on  map  my_map,  using  my_conf
54       configuration file and saving results in my_out file run:
55
56       r.li.shannon map=my_map conf=my_conf output=my_out
57
58

NOTES

60       Do  not  use  absolute  path names for output files. They are raster if
61       moving  window  disposition  was  selected,  otherwise  they   are   in
62       ~/.r.li/output folder.
63       If input raster is full of null values r.li.shannon returns -1.
64       If you want to have null values instead run
65
66       r.null setnull=-1 map=my_map
67        after index calculation.
68

AUTHORS

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

BUGS

78       Please send bugs reports to pallecch@cli.di.unipi.it
79
80       Last changed: $Date: 2007-02-08 17:52:53 +0100 (Thu, 08 Feb 2007) $
81
82       Full index
83
84       © 2003-2008 GRASS Development Team
85
86
87
88GRASS 6.3.0                                                    r.li.shannon(1)