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

NAME

6       r.li.edgedensity   - Calculates edge density index on a raster map, us‐
7       ing a 4 neighbour algorithm
8

KEYWORDS

10       raster, landscape structure analysis, patch index
11

SYNOPSIS

13       r.li.edgedensity
14       r.li.edgedensity --help
15       r.li.edgedensity    [-b]     input=name     config=name     output=name
16       [patch_type=string]    [--overwrite]   [--help]  [--verbose]  [--quiet]
17       [--ui]
18
19   Flags:
20       -b
21           Exclude border edges
22
23       --overwrite
24           Allow output files to overwrite existing files
25
26       --help
27           Print usage summary
28
29       --verbose
30           Verbose module output
31
32       --quiet
33           Quiet module output
34
35       --ui
36           Force launching GUI dialog
37
38   Parameters:
39       input=name [required]
40           Name of input raster map
41
42       config=name [required]
43           Configuration file
44
45       output=name [required]
46           Name for output raster map
47
48       patch_type=string
49           The value of the patch type
50           It can be integer, double or float; it will be changed in  function
51           of map type
52

DESCRIPTION

54       r.li.edgedensity calculates:
55
56           •   the density of all edges of patch type k , or
57
58           •   the density of all edges in the sampling area if k is not spec‐
59               ified,
60
61       with:
62
63k: patch type
64
65m: number of patch types
66
67n: number of edge segments of patch type k
68
69eik :total edge length in the landscape involving patch type k
70
71Area: total landscape area
72
73       The unit is meters per hectare.
74

NOTES

76       Do not use absolute path names for the config and output  file/map  pa‐
77       rameters.    If   the   "moving   window"   method   was   selected  in
78       g.gui.rlisetup, then the output will be  a  raster  map,  otherwise  an
79       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
80       Data\Roaming\GRASS8\r.li\output\            (MS-Windows)             or
81       $HOME/.grass8/r.li/output/ (GNU/Linux).
82
83       If the input raster map contains only NULL values then r.li.edgedensity
84       consider to have 0 patches.
85       If area is 0 r.li.edgedensity returns NULL; this is  only  possible  if
86       input raster is masked.
87

EXAMPLES

89       To  calculate  the edge density index on map my_map, using my_conf con‐
90       figuration file (previously defined with g.gui.rlisetup) and saving re‐
91       sults in my_out, run:
92       r.li.edgedensity input=my_map conf=my_conf output=my_out
93       To  calculate edge density index of patch_type 34, using "my_conf" con‐
94       figuration file and on map "my_map", saving results  in  "my_out"  file
95       run:
96       r.li.edgedensity input=my_map conf=my_conf output=my_out patch_type=34
97
98       Forest map (Spearfish sample dataset) example:
99       g.region raster=landcover.30m -p
100       r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
101       r.li.edgedensity input=forests conf=movwindow7 out=forests_edgedens_mov7
102       r.univar forests_edgedens_mov7
103
104       Forest map (North Carolina sample dataset) example:
105       g.region raster=landclass96 -p
106       r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
107       r.li.edgedensity input=forests conf=movwindow7 out=forests_edgedensity_mov7
108       # verify
109       r.univar forests_edgedensity_mov7
110       r.to.vect input=forests output=forests type=area
111       d.mon wx0
112       d.rast forests_edgedensity_mov7
113       d.vect forests type=boundary
114

SEE ALSO

116        r.li - package overview
117       g.gui.rlisetup
118

REFERENCES

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

AUTHORS

125       Serena  Pallecchi  student  of  Computer  Science  University  of  Pisa
126       (Italy).
127       Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
128       Markus Metz
129

SOURCE CODE

131       Available at: r.li.edgedensity source code (history)
132
133       Accessed: Saturday Jan 21 21:14:51 2023
134
135       Main index | Raster index | Topics index | Keywords index  |  Graphical
136       index | Full index
137
138       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
139
140
141
142GRASS 8.2.1                                                r.li.edgedensity(1)
Impressum