Debian Codegraph @

raster/r.li/r.li.pielou/r.li.pielou.html

raw
1 <h2>DESCRIPTION</h2>
2
3 <em>r.li.pielou</em> calculates the "Pielou's diversity index" as: <br>
4 <img src="r_li_pielou.png" alt="r.li.pielou formula"> <br>
5 with:
6 <ul>
7 <li><b>J</b>: Pielou eveness index</li>
8 <li><b>H'</b>: Shannon index</li>
9 <li><b>S</b>: number of classes</li>
10 </ul>
11
12 <h2>NOTES</h2>
13
14 Do not use absolute path names for the <b>config</b> and <b>output</b>
15 file/map parameters.
16
17 If the "moving window" method was selected in <b>g.gui.rlisetup</b>, then the
18 output will be a raster map, otherwise an ASCII file will be generated in
19 the folder <code>C:\Users\userxy\AppData\Roaming\GRASS8\r.li\output\</code>
20 (MS-Windows) or <code>$HOME/.grass8/r.li/output/</code> (GNU/Linux).
21 <p>
22 <!-- TODO: verify next: -->
23 If the input raster contains NULL value cells, <em>r.li.pielou</em>
24 returns NULL for these cells.
25
26 <h2>EXAMPLES</h2>
27
28 To calculate Pielou's diversity index on map <em>my_map</em>, using
29 <em>my_conf</em> configuration file (previously defined with
30 <em>g.gui.rlisetup</em>) and saving results in <em>my_out</em>, run:
31 <div class="code"><pre>
32 r.li.pielou input=my_map conf=my_conf output=my_out
33 </pre></div>
34 <p>
35
36 Forest map (Spearfish sample dataset) example:
37 <div class="code"><pre>
38 g.region raster=landcover.30m -p
39 r.mapcalc "forests = if(landcover.30m &gt;= 41 &amp;&amp; landcover.30m &lt;= 43,1,null())"
40 r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
41 r.univar forests_pielou_mov7
42 </pre></div>
43 <p>
44
45 Forest map (North Carolina sample dataset) example:
46 <div class="code"><pre>
47 g.region raster=landclass96 -p
48 r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
49 r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
50
51 # verify
52 r.univar forests_pielou_mov7
53 r.to.vect input=forests output=forests type=area
54 d.mon wx0
55 d.rast forests_pielou_mov7
56 d.vect forests type=boundary
57 </pre></div>
58
59 <h2>SEE ALSO</h2>
60
61 <em>
62 <a href="r.li.html">r.li</a> (package overview),
63 <a href="g.gui.rlisetup.html">g.gui.rlisetup</a>
64 </em>
65
66 <h2>REFERENCES</h2>
67
68 McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern
69 analysis program for quantifying landscape structure. USDA For. Serv.
70 Gen. Tech. Rep. PNW-351. (<a href="https://doi.org/10.2737/PNW-GTR-351">PDF</a>)
71
72 <h2>AUTHORS</h2>
73
74 Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy), based on the <em>r.li.shannon</em> code
75 developed by Serena Pallecchi, student of Computer Science University of Pisa (Italy)