r.li.edgedensity(1grass)

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

NAME

6       r.li.edgedensity   -  Calculates  edge  density  index on a raster map,
7       using 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
63           ·   k: patch type
64
65           ·   m: number of patch types
66
67           ·   n: number of edge segments of patch type k
68
69           ·   eik :total edge length in the landscape involving patch type k
70
71           ·   Area: 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
77       parameters.    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\GRASS7\r.li\output\            (MS-Windows)             or
81       $HOME/.grass7/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
91       results 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

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
130       Last changed: $Date: 2015-08-24 05:56:52 +0200 (Mon, 24 Aug 2015) $
131

SOURCE CODE

133       Available at: r.li.edgedensity source code (history)
134
135       Main index | Raster index | Topics index | Keywords index  |  Graphical
136       index | Full index
137
138       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
139
140
141
142GRASS 7.6.0                                                r.li.edgedensity(1)