Debian Codegraph @

raster/r.li/r.li.dominance/r.li.dominance.md

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