.TH r.li.mpa 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBr.li.mpa\fR\fR  - Calculates mean pixel attribute index on a raster map
.SH KEYWORDS
raster, landscape structure analysis, patch index
.SH SYNOPSIS
\fBr.li.mpa\fR
.br
\fBr.li.mpa help\fR
.br
\fBr.li.mpa map\fR=\fIname\fR \fBconf\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 "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output raster map
.PP
.SH DESCRIPTION
\fIr.li.mpa\fR 
(mean pixel attribute) calculates the average value of the attribute of all the non-null
cells in the sampling area as:
.br
with:
.br
.RS
.IP
\fBi\fR: attribute
.br
.IP
\fBm\fR: number of non-null attributes in the sampling area 
.IP
\fBwi\fR: number of cells of attribute i
.IP
\fBsize\fR: size of sampling area (in cells)
.br
.RE
.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.mpa map=my_map conf=my_conf output=my_out
.br
.DE
\fR
.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 input raster is full of null values r.li.mpa consider to
have 0 patch.
.br
If area is 0 r.li.mpa returns -1; it is possible only if the
raster 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.
.SH SEE ALSO
\fI
r.li
r.le
\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