Debian Codegraph @

raster/r.li/r.li.padsd/r.li.padsd.html

raw
1 <h2>DESCRIPTION</h2>
2
3 <em>r.li.padsd</em> calculates the standard deviation of patch
4 area sizes in hectares as:<br>
5 <img src="rlipadsd_formula.png" alt="r.li.padsd formula"> <br>
6 with:<br>
7 <ul>
8 <li><b>MPS</b>: mean patch area size</li>
9 <li><b>a<small><small>i</small></small></b>: area of patch i</li>
10 <li><b>N<small>patch</small></b>: number of patches</li>
11 </ul>
12
13 <p>
14 This index is calculated using a 4 neighbour algorithm, diagonal cells
15 are ignored when tracing a patch.
16
17 <h2>NOTES</h2>
18
19 Do not use absolute path names for the <b>config</b> and <b>output</b>
20 file/map parameters.
21
22 If the "moving window" method was selected in <b>g.gui.rlisetup</b>, then the
23 output will be a raster map, otherwise an ASCII file will be generated in
24 the folder <code>C:\Users\userxy\AppData\Roaming\GRASS8\r.li\output\</code>
25 (MS-Windows) or <code>$HOME/.grass8/r.li/output/</code> (GNU/Linux).
26 <p>
27 The result is NULL if the sample area contains only NULL values.
28
29 <h2>EXAMPLES</h2>
30
31 To calculate patch area distribution standard deviation index on map <em>my_map</em>, using
32 <em>my_conf</em> configuration file (previously defined with
33 <em>g.gui.rlisetup</em>) and saving results in <em>my_out</em>, run:
34 <div class="code"><pre>
35 r.li.padsd input=my_map conf=my_conf output=my_out
36 </pre></div>
37 <p>
38
39 Forest map (Spearfish sample dataset) example:
40 <div class="code"><pre>
41 g.region raster=landcover.30m -p
42 r.mapcalc "forests = if(landcover.30m &gt;= 41 &amp;&amp; landcover.30m &lt;= 43,1,null())"
43 r.li.padsd input=forests conf=movwindow7 out=forests_padsd_mov7
44 r.univar forests_padsd_mov7
45 </pre></div>
46 <p>
47
48 Forest map (North Carolina sample dataset) example:
49 <div class="code"><pre>
50 g.region raster=landclass96 -p
51 r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
52 r.li.padsd input=forests conf=movwindow7 out=forests_padsd_mov7
53
54 # verify
55 r.univar forests_padsd_mov7
56 r.to.vect input=forests output=forests type=area
57 d.mon wx0
58 d.rast forests_padsd_mov7
59 d.vect forests type=boundary
60 </pre></div>
61
62 <h2>SEE ALSO</h2>
63
64 <em>
65 <a href="r.li.html">r.li</a> (package overview),
66 <a href="g.gui.rlisetup.html">g.gui.rlisetup</a>
67 </em>
68
69 <h2>REFERENCES</h2>
70
71 McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern
72 analysis program for quantifying landscape structure. USDA For. Serv.
73 Gen. Tech. Rep. PNW-351. (<a href="https://doi.org/10.2737/PNW-GTR-351">PDF</a>)
74
75 <h2>AUTHORS</h2>
76
77 Michael Shapiro - CERL (patch identification)<br>
78 Markus Metz (statistics)