1r.li.pielou(1) GRASS GIS User's Manual r.li.pielou(1)
2
3
4
6 r.li.pielou - Calculates Pielou’s diversity index on a raster map
7
9 raster, landscape structure analysis, diversity index
10
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
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
54 Do not use absolute path names for the config and output file/map pa‐
55 rameters. 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\GRASS8\r.li\output\ (MS-Windows) or
59 $HOME/.grass8/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
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 re‐
67 sults 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
88 r.li - package overview
89 g.gui.rlisetup
90
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
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
102 Available at: r.li.pielou source code (history)
103
104 Accessed: Saturday Jan 21 20:38:46 2023
105
106 Main index | Raster index | Topics index | Keywords index | Graphical
107 index | Full index
108
109 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
110
111
112
113GRASS 8.2.1 r.li.pielou(1)