r.mode(1)		      Grass User's Manual		     r.mode(1)



NNAAMMEE
       rr..mmooddee  - Finds the mode of values in a cover map within areas assigned
       the same category value in a user-specified base map.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..mmooddee
       rr..mmooddee hheellpp
       rr..mmooddee bbaassee==_n_a_m_e ccoovveerr==_n_a_m_e oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _r_._m_o_d_e calculates the most frequently occurring value (i. e., mode)  of
       data  contained in a _c_o_v_e_r raster map layer for areas assigned the same
       category value in the user-specified  _b_a_s_e  raster  map	layer.	 These
       modes are stored in the new _o_u_t_p_u_t map layer.


       The _o_u_t_p_u_t map is actually a _r_e_c_l_a_s_s of the _b_a_s_e map.


       If  the	user  simply  types  rr..mmooddee  on  the command line, the user is
       prompted for the parameter values through the standard parser interface
       (see _p_a_r_s_e_r manual entry).


       Alternately,  the  user	can  supply all needed parameter values on the
       command line.



   PPaarraammeetteerrss::
       bbaassee==_n_a_m_e
	      An existing raster map layer in the user's current mapset search
	      path.   For each group of cells assigned the same category value
	      in the _b_a_s_e map, the mode of the values assigned these cells  in
	      the _c_o_v_e_r map will be computed.

       ccoovveerr==_n_a_m_e
	      An existing raster map layer containing the values to be used to
	      compute the mode within each category of the _b_a_s_e map.

       oouuttppuutt==_n_a_m_e
	      The name of a new map layer to contain program output (a _r_e_c_l_a_s_s
	      of  the _b_a_s_e map).  The mode values will be stored in the _o_u_t_p_u_t
	      map.


NNOOTTEESS
       The user should use the results of _r_._m_o_d_e with care.  Since this  util-
       ity  assigns  a value to each cell which is based on global information
       (i.e., information at spatial locations other than just the location of
       the  cell  itself),  the  resultant map layer is only valid if the geo-
       graphic region and mask settings are the same as they were at the  time
       that the result map was created.


       Results are affected by the current region settings and mask.

SSEEEE AALLSSOO
       _g_._r_e_g_i_o_n  _r_._a_v_e_r_a_g_e _r_._c_a_t_s _r_._c_l_u_m_p _r_._d_e_s_c_r_i_b_e _r_._m_a_p_c_a_l_c _r_._m_a_s_k _r_._m_e_d_i_a_n
       _r_._m_f_i_l_t_e_r _r_._n_e_i_g_h_b_o_r_s _r_._r_e_c_l_a_s_s _r_._s_t_a_t_s _p_a_r_s_e_r

AAUUTTHHOORR
       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

       _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_4 _$



GRASS 5.0							     r.mode(1)
