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 specifying 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 cor-
       rect in counts, total area in counts and percentage 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, Illinois.

       _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)
