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

NAME

6       r.li.cwed   -  Calculates  contrast  weighted  edge  density index on a
7       raster map
8

KEYWORDS

10       raster, landscape structure analysis, patch index
11

SYNOPSIS

13       r.li.cwed
14       r.li.cwed --help
15       r.li.cwed input=name config=name path=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       path=name [required]
42           Name of file that contains the weight to calculate the index
43
44       output=name [required]
45           Name for output raster map
46

DESCRIPTION

48       r.li.cwed  (contrast weighted edge density) calculates the edge density
49       between patch types specified:
50
51       with:
52
53           ·   k: attribute
54
55           ·   m: number of non-null attributes in the sampling area
56
57           ·   eik: total length of edge in landscape between  patch  types  i
58               and k
59
60           ·
61                dik:  dissimilarity (edge contrast weight) between patch types
62               i and k
63
64           ·   Area: total landscape area
65       The input file contains a row for each couple of  patch  type  that  we
66       want  to consider in the calculation. Each row must be saved using this
67       syntax:
68       patchType1,patchType2,dissimilarityBetweenPatchType1andPatchType2
69

NOTES

71       Do not use absolute path names  for  the  config  and  output  file/map
72       parameters.    If   the   "moving   window"   method  was  selected  in
73       g.gui.rlisetup, then the output will be  a  raster  map,  otherwise  an
74       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
75       Data\Roaming\GRASS7\r.li\output\            (MS-Windows)             or
76       $HOME/.grass7/r.li/output/ (GNU/Linux).
77
78       If the sample area contains only NULL values it is considered to have 0
79       patch and CWED=0. If Area is 0 r.li.cwed returns -1.  This is only pos‐
80       sible if the map is masked.
81       If  you want to change these -1 values to NULL, run subsequently on the
82       resulting map:
83       r.null setnull=-1 input=my_map
84       after index calculation.
85

EXAMPLES

87       To calculate the contrast weighted edge density index  on  map  my_map,
88       using    my_conf    configuration   file   (previously   defined   with
89       g.gui.rlisetup) and saving results in my_out, run:
90       r.li.cwed input=my_map conf=my_conf output=my_out \
91                 path=/path/to/weights.csv
92       Example for input "weights.csv" file:
93       12,16,0.65
94       44,123,0.32
95       56,12,0.54
96       23,66,0.99
97

SEE ALSO

99        r.li - package overview
100       g.gui.rlisetup
101

REFERENCES

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

AUTHORS

108       Serena  Pallecchi  student  of  Computer  Science  University  of  Pisa
109       (Italy).
110       Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
111       Markus Metz
112

SOURCE CODE

114       Available at: r.li.cwed source code (history)
115
116       Main  index  | Raster index | Topics index | Keywords index | Graphical
117       index | Full index
118
119       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
120
121
122
123GRASS 7.8.5                                                       r.li.cwed(1)
Impressum