.TH r.li.cwed 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBr.li.cwed\fR\fR  - Calculates contrast weighted edge density index on a raster map
.SH KEYWORDS
raster, landscape structure analysis, patch index
.SH SYNOPSIS
\fBr.li.cwed\fR
.br
\fBr.li.cwed help\fR
.br
\fBr.li.cwed map\fR=\fIname\fR \fBconf\fR=\fIstring\fR \fBpath\fR=\fIstring\fR \fBoutput\fR=\fIname\fR  [--\fBoverwrite\fR]  [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Flags:
.IP "\fB--overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB--verbose\fR" 4m
.br
Verbose module output
.IP "\fB--quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input raster map
.IP "\fBconf\fR=\fIstring\fR" 4m
.br
Configuration file
.IP "\fBpath\fR=\fIstring\fR" 4m
.br
Input file that contains the weight to calculate the index
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output raster map
.PP
.SH DESCRIPTION
\fIr.li.cwed\fR (contrast weighted edge density) calculates the edge density
between patch types specified:
.PP
.PP
with:
.RS
.IP
 \fBk\fR: attribute
.br
.IP
 \fBm\fR: number of non-null attributes in the sampling area
.br
.IP
 \fBeik\fR: total length of edge in landscape between patch types i and k
.br
.IP
\fB dik\fR: dissimilarity (edge contrast weight) between patch types i and k
.br
.IP
 \fBArea\fR: total landscape area
.br
.RE
.br
The input file have a row for each couple of patch type that we want to
consider in the calculation. Each row must to have this syntax:
.br
patchType1,patchType2,dissimilarityBetweenPatchType1andPatchType2
.br
.SH EXAMPLES
To calculate mean pixel attribute index on map my_map, using
my_conf configuration file and saving results in
my_out file run:
.br
\fC
.DS
.br
r.li.cwed map=my_map conf=my_conf path=my_file output=my_out
.br
.DE
\fR
.br
Example of input file:
12,16,0.65
.br
44,123,0.32
.br
56,12,0.54
.br
23,66,0.99
.br
.SH NOTES
Do not use absolute path names for output files. They are raster if
moving window disposition was selected, otherwise they are in
~/.r.li/output folder.
.br
If the raster is full of null value it is considered to have 0 patch and CWED=0.
If Area is 0 r.li.cwed returns -1. This is possible
only if the map is masked.
.br
If you want to have null values instead run 
.br
\fC
.DS
.br
r.null setnull=-1 map=my_map
.br
.DE
\fR
after index calculation.
.br
.br
.SH REFERENCES
McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern
analysis program for quantifying landscape structure. USDA For. Serv.
Gen. Tech. Rep. PNW-351.
.SH SEE ALSO
\fIr.li\fR package overview 
.br
\fIr.li.daemon\fR
.br
\fIr.li.setup\fR
.SH AUTHORS
Serena Pallecchi student of Computer Science University of Pisa (Italy).
.br
Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
.PP
\fILast changed: $Date: 2011-08-16 11:13:05 +0200 (Tue, 16 Aug 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team