1r.li.dominance(1)           GRASS GIS User's Manual          r.li.dominance(1)
2
3
4

NAME

6       r.li.dominance   -  Calculates  dominance’s diversity index on a raster
7       map
8

KEYWORDS

10       raster, landscape structure analysis, diversity index
11

SYNOPSIS

13       r.li.dominance
14       r.li.dominance --help
15       r.li.dominance  input=name   config=name   output=name    [--overwrite]
16       [--help]  [--verbose]  [--quiet]  [--ui]
17
18   Flags:
19       --overwrite
20           Allow output files to overwrite existing files
21
22       --help
23           Print usage summary
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31       --ui
32           Force launching GUI dialog
33
34   Parameters:
35       input=name [required]
36           Name of input raster map
37
38       config=name [required]
39           Configuration file
40
41       output=name [required]
42           Name for output raster map
43

DESCRIPTION

45       r.li.dominance calculates the "dominance diversity index" as:
46       with:
47
48           ·   i: patch type
49
50           ·   m: number of different patch types
51
52           ·   pi: proportional abundance of patch type i
53

NOTES

55       Do  not  use  absolute  path  names  for the config and output file/map
56       parameters.   If  the  "moving   window"   method   was   selected   in
57       g.gui.rlisetup,  then  the  output  will  be a raster map, otherwise an
58       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
59       Data\Roaming\GRASS7\r.li\output\             (MS-Windows)            or
60       $HOME/.grass7/r.li/output/ (GNU/Linux).
61
62       If the input raster map contains only NULL values  then  r.li.dominance
63       returns NULL.
64

EXAMPLES

66       To calculate the dominance diversity index on map my_map, using my_conf
67       configuration file (previously defined with g.gui.rlisetup) and  saving
68       results in my_out, run:
69       r.li.dominance input=my_map conf=my_conf output=my_out
70
71       Forest map (Spearfish sample dataset) example:
72       g.region raster=landcover.30m -p
73       r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
74       r.li.dominance input=forests conf=movwindow7 out=forests_dominance_mov7
75       r.univar forests_dominance_mov7
76
77       Forest map (North Carolina sample dataset) example:
78       g.region raster=landclass96 -p
79       r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
80       r.li.dominance input=forests conf=movwindow7 out=forests_dominance_mov7
81       # verify
82       r.univar forests_dominance_mov7
83       r.to.vect input=forests output=forests type=area
84       d.mon wx0
85       d.rast forests_dominance_mov7
86       d.vect forests type=boundary
87

SEE ALSO

89        r.li - package overview
90       g.gui.rlisetup
91

REFERENCES

93       McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analy‐
94       sis program for quantifying landscape structure. USDA For. Serv.   Gen.
95       Tech. Rep. PNW-351. (PDF)
96

AUTHORS

98       Serena  Pallecchi  student  of  Computer  Science  University  of  Pisa
99       (Italy).
100       Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
101       Markus Metz
102

SOURCE CODE

104       Available at: r.li.dominance source code (history)
105
106       Main index | Raster index | Topics index | Keywords index  |  Graphical
107       index | Full index
108
109       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
110
111
112
113GRASS 7.8.5                                                  r.li.dominance(1)
Impressum