Debian Codegraph @

raster/r.li/r.li.padsd/r.li.padsd.md

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