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 result-
       ing 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 standard parser interface (see manual entry for
       _p_a_r_s_e_r).  Category distinctions 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 recatego-
       rize 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).  Lin-
       ear 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 considered 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)
