.TH r.kappa 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.kappa\fR\fR  - Calculate error matrix and kappa parameter for accuracy assessment of classification result.
.SH KEYWORDS
raster, statistics
.SH SYNOPSIS
\fBr.kappa\fR
.br
\fBr.kappa help\fR
.br
\fBr.kappa\fR [\-\fBwqh\fR] \fBclassification\fR=\fIname\fR \fBreference\fR=\fIname\fR  [\fBoutput\fR=\fIname\fR]   [\fBtitle\fR=\fIstring\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-w\fR" 4m
.br
Wide report
.br
132 columns (default: 80)
.IP "\fB\-q\fR" 4m
.br
Quiet
.IP "\fB\-h\fR" 4m
.br
No header in the report
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBclassification\fR=\fIname\fR" 4m
.br
Name of raster map containing classification result
.IP "\fBreference\fR=\fIname\fR" 4m
.br
Name of raster map containing reference classes
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output file containing error matrix and kappa
.IP "\fBtitle\fR=\fIstring\fR" 4m
.br
Title for error matrix and kappa
.br
Default: \fIACCURACY ASSESSMENT\fR
.PP
.SH DESCRIPTION
\fIr.kappa\fR tabulates the error matrix of classification result by
crossing classified map layer with respect to reference map layer.  Both
overall \fIkappa\fR (accompanied by its \fIvariance\fR) and
conditional \fIkappa\fR values are calculated.  This analysis program
respects the current geographic region and mask settings.
.PP
\fIr.kappa\fR calculates the error matrix of the
two map layers and prepares the table from which the report
is to be created.  \fIkappa\fR values for overall and
each classes are computed along with their variances. Also
percent of commission and ommission error, total correct
classified result by pixel counts, total area in pixel
counts and percentage of overall correctly classified
pixels are tabulated.
.PP
The report will be write to an output file which is in
plain text format and named by user at prompt of running
the program.
.PP
The body of the report is arranged in panels.  The
classified result map layer categories is arranged along
the vertical axis of the table, while the reference map
layer categories along the horizontal axis.  Each panel has
a maximum of 5 categories (9 if wide format) across the
top.  In addition, the last column of the last panel
reflects a cross total of each column for each row.  All of
the categories of the map layer arranged along the vertical
axis, i.e., the reference map layer,  are included in each
panel.  There is a total at the bottom of each column
representing the sum of all the rows in that column.
.SH NOTES
It is recommended to reclassify categories of classified
result map layer into a more manageable number before
running \fIr.kappa\fR on the classified raster map
layer. Because \fIr.kappa\fR calculates and then reports
information for each and every category.
.PP
\fINA\fR's in output file mean non-applicable in case
\fIMASK\fR exists.
.SH EXAMPLE
Example for North Carolina sample dataset:
\fC
.DS
.br
g.region rast=landclass96 \-p
.br
r.kappa \-w classification=landuse96_28m reference=landclass96
.br
.DE
\fR
.PP
Verification of classified LANDSAT scene against training areas:
\fC
.DS
.br
r.kappa \-w classification=lsat7_2002_classes reference=training
.br
.DE
\fR
.SH SEE ALSO
\fIg.region\fR,
\fIr.category\fR,
\fIr.mask\fR,
\fIr.reclass\fR,
\fIr.report\fR,
\fIr.stats\fR
.SH AUTHOR
Tao Wen, University of Illinois at Urbana-Champaign, Illinois
.PP
\fILast changed: $Date: 2014-05-05 21:40:05 +0200 (Mon, 05 May 2014) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team