m.kappa(1)	       Grass User's Manual	       m.kappa(1)



NNAAMMEE
       _m_._k_a_p_p_a	-  Calculate error matrix and kappa parameter for
       accuracy assessment of classification result.

       _(_G_R_A_S_S _S_u_p_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       mm..kkaappppaa

       mm..kkaappppaa hheellpp

       mm..kkaappppaa [--hh] [iinnppuuttnnaammee] [oouuttppuuttnnaammee] [ttiittllee""nnaammee""]

DDEESSCCRRIIPPTTIIOONN
       _m_._k_a_p_p_a	tabulates  the	error  matrix  of  classification
       result  by  reading  error  matrix.   Both  overall  kappa
       (accompanied by its variance) and conditional kappa values
       are calculated.


       The user can run the program non-interactively by specify-
       ing all needed flag settings and parameter values  on  the
       command line, in the form:


       _m_._k_a_p_p_a _[_-_h_] _[_i_n_p_u_t_n_a_m_e_] _[_o_u_t_p_u_t_n_a_m_e_] _[_t_i_t_l_e_"_n_a_m_e_"_]



   FFllaagg::
       --hh     Report without header


   PPaarraammeetteerrss::
       iinnppuuttnnaammee
	      Name  of	error  matrix  file.  If file name is not
	      specified, the program  will  obtain  error  matrix
	      from  standard input.  If file name is provided, it
	      must have the following format: the first  line  is
	      an integer N which is the number of rows/columns of
	      the matrix; the remainder of the file is the  error
	      matrix, or N lines, each containing N integers. For
	      example:

					 tab(	   );	  lnnnnnn
	      nnnnnnn.	6 28010 0 0
					 0  5235  0  17797  0 0 0
	      3368  744  56  0
					 69340 0 437 0 0 0 0 0	0
	      2118 0 0 15762
					 0  40759  0 0 0 1766 0 0
	      8126


       oouuttppuuttnnaammee
	      Name of ascii file in which to report results.   If
	      no  file	name  is  provided, the report will go to
	      standard output.

       ttiittlleennaammee
	      Title of the report file which is the first line in
	      output file.  Default: Error matrix and Kappa



       Alternately,  the  user	can  run _m_._k_a_p_p_a interactively by
       simply typing _m_._k_a_p_p_a without command line  arguments;  in
       this  case,  the  user  will  be prompted for the names of
       input error matrix.  _m_._k_a_p_p_a  then  calculates  the  kappa
       values for overall and each classes along with their vari-
       ances.  Also percentage of commission and ommission error,
       total correct in counts, total area in counts and percent-
       age of overall correct counts are tabulated.


       The report will be displayed on screen, or written  to  an
       output  file  which  is	in plain text format and named by
       user at prompt of running the program.

NNOOTTEESS
       NA's in report mean non-applicable.

SSEEEE AALLSSOO
       _r_._k_a_p_p_a

AAUUTTHHOORR
       Tao Wen, University of Illinois at Urbana-Champaign, Illi-
       nois.

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0					       m.kappa(1)
