r.li.pielou(1grass)

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

NAME

6       r.li.pielou  - Calculates Pielou’s diversity index on a raster map
7

KEYWORDS

9       raster, landscape structure analysis, diversity index
10

SYNOPSIS

12       r.li.pielou
13       r.li.pielou --help
14       r.li.pielou input=name config=name output=name  [--overwrite]  [--help]
15       [--verbose]  [--quiet]  [--ui]
16
17   Flags:
18       --overwrite
19           Allow output files to overwrite existing files
20
21       --help
22           Print usage summary
23
24       --verbose
25           Verbose module output
26
27       --quiet
28           Quiet module output
29
30       --ui
31           Force launching GUI dialog
32
33   Parameters:
34       input=name [required]
35           Name of input raster map
36
37       config=name [required]
38           Configuration file
39
40       output=name [required]
41           Name for output raster map
42

DESCRIPTION

44       r.li.pielou  calculates the "Pielou’s diversity index" as:
45       with:
46
47           ·   J: Pielou eveness index
48
49           ·   H’: Shannon index
50
51           ·   S: number of classes
52

NOTES

54       Do not use absolute path names  for  the  config  and  output  file/map
55       parameters.    If   the   "moving   window"   method  was  selected  in
56       g.gui.rlisetup, then the output will be  a  raster  map,  otherwise  an
57       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
58       Data\Roaming\GRASS7\r.li\output\            (MS-Windows)             or
59       $HOME/.grass7/r.li/output/ (GNU/Linux).
60
61       If the input raster contains NULL value cells, r.li.pielou returns NULL
62       for these cells.
63

EXAMPLES

65       To calculate Pielou’s diversity index on map my_map, using my_conf con‐
66       figuration  file  (previously  defined  with g.gui.rlisetup) and saving
67       results in my_out, run:
68       r.li.pielou input=my_map conf=my_conf output=my_out
69
70       Forest map (Spearfish sample dataset) example:
71       g.region raster=landcover.30m -p
72       r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
73       r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
74       r.univar forests_pielou_mov7
75
76       Forest map (North Carolina sample dataset) example:
77       g.region raster=landclass96 -p
78       r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
79       r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
80       # verify
81       r.univar forests_pielou_mov7
82       r.to.vect input=forests output=forests type=area
83       d.mon wx0
84       d.rast forests_pielou_mov7
85       d.vect forests type=boundary
86

REFERENCES

92       McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analy‐
93       sis  program for quantifying landscape structure. USDA For. Serv.  Gen.
94       Tech. Rep. PNW-351. (PDF)
95

AUTHORS

97       Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy), based on
98       the r.li.shannon code developed by Serena Pallecchi student of Computer
99       Science University of Pisa (Italy).
100
101       Last changed: $Date: 2014-12-19 22:17:36 +0100 (Fri, 19 Dec 2014) $
102

SOURCE CODE

104       Available at: r.li.pielou source code (history)
105
106       Main index | Raster index | Topics index | Keywords index  |  Graphical
107       index | Full index
108
109       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
110
111
112
113GRASS 7.6.0                                                     r.li.pielou(1)