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



NNAAMMEE
       rr..cclluummpp	 -  Recategorizes data in a raster map layer by grouping cells
       that form physically discrete areas into unique categories.
       _(_G_R_A_S_S Raster Program)

SSYYNNOOPPSSIISS
       rr..cclluummpp
       rr..cclluummpp help
       rr..cclluummpp [--qq] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e [TTIITTLLEE==_"_s_t_r_i_n_g_"]

DDEESSCCRRIIPPTTIIOONN
       _r_._c_l_u_m_p finds all areas of contiguous cell category values in the input
       raster  map layer _n_a_m_e. It assigns a unique category value to each such
       area ("clump") in the resulting output raster map layer _n_a_m_e.   If  the
       user  does  not provide input and output map layer names on the command
       line, the program will prompt the user for these names, using the stan-
       dard parser interface (see manual entry for _p_a_r_s_e_r).  Category distinc-
       tions in the input raster map layer are preserved.  This means that  if
       distinct  category  values  are	adjacent,  they  will  NOT  be clumped
       together.  (The user can run _r_._r_e_c_l_a_s_s prior to _r_._c_l_u_m_p to recategorize
       cells and reassign cell category values.)



   FFllaagg::
       --qq     Run  quietly,  without  printing messages on program progress to
	      standard output.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of an existing raster map layer being used for input.

       oouuttppuutt==_n_a_m_e
	      Name of new raster map layer to contain program output.

       TTIITTLLEE== Optional TITLE for output raster map layer, in quotes.   If  the
	      user fails to assign a TITLE for the _o_u_t_p_u_t map layer, none will
	      be assigned it.


AALLGGOORRIITTHHMM
       _r_._c_l_u_m_p moves a 2x2 matrix over the input raster map layer.  The  lower
       right-hand  corner of the matrix is grouped with the cells above it, or
       to the left of it.  (Diagonal cells are not considered.)

NNOOTTEESS
       _r_._c_l_u_m_p works properly with raster map layers that contain  only  "fat"
       areas  (more than a single cell in width).  Linear elements (lines that
       are a single cell wide) may or may not be clumped together depending on
       the direction of the line -- horizontal and vertical lines of cells are
       considered to be contiguous, but diagonal lines of cells are  not  con-
       sidered to be contiguous and are broken up into separate clumps.


       A random color table and other support files are generated for the _o_u_t_-
       _p_u_t raster map layer.

SSEEEE AALLSSOO
       _r_._a_v_e_r_a_g_e

       _r_._b_u_f_f_e_r

       _r_._c_o_m_b_i_n_e

       _r_._g_r_o_w
	_r_._i_n_f_e_r

       _r_._m_a_p_c_a_l_c

       _r_._m_f_i_l_t_e_r

       _r_._n_e_i_g_h_b_o_r_s

       _r_._p_o_l_y

       _r_._r_e_c_l_a_s_s

       _r_._s_u_p_p_o_r_t

       _r_._w_e_i_g_h_t

       _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.clump(1)
