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



NNAAMMEE
       rr..ccaattss  - Prints category values and labels associated with user-speci-
       fied raster map layers.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..ccaattss
       rr..ccaattss hheellpp
       rr..ccaattss	mmaapp==_n_a_m_e   [ccaattss==_r_a_n_g_e[,_r_a_n_g_e,...]]   [ffss==_c_h_a_r_a_c_t_e_r|_s_p_a_c_e|_t_a_b]
       [vvaallss==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _r_._c_a_t_s  prints  the category values and labels for the raster map layer
       specified by mmaapp==_n_a_m_e to standard output.


       The user can specify all needed parameters on the command line, and run
       the  program  non-interactively. If the user does not specify any cate-
       gories (e.g., using the optional ccaattss==_r_a_n_g_e[,_r_a_n_g_e,...] argument), then
       all  the category values and labels for the named raster map layer that
       occur  in  the  map  are  printed.   The  entire  _m_a_p  is  read,  using
       _r_._d_e_s_c_r_i_b_e,  to determine which categories occur in the _m_a_p. If a list-
       ing of categories is specified, then the labels	for  those  categories
       only  are printed. The _c_a_t_s may be specified as single category values,
       or as ranges of values. The user may also (optionally) specify  that  a
       field separator other than a space or tab be used to separate the cate-
       gory value from its corresponding category  label  in  the  output,  by
       using  the  ffss==_c_h_a_r_a_c_t_e_r|_s_p_a_c_e|_t_a_b  option  (see  example below). If no
       field separator is specified by the user, a tab	is  used  to  separate
       these fields in the output, by default.


       The  output  is sent to standard output in the form of one category per
       line, with the category value first on the  line,  then	an  ASCII  TAB
       character (or whatever single character or space is specified using the
       ffss parameter), then the label for the category.


       If the user simply types rr..ccaattss without arguments on the  command  line
       the  program  prompts  the user for parameter values using the standard
       GRASS parser interface.

   PPaarraammeetteerr::
       vvaallss==_v_a_l_u_e
	      Comma separated value list: e.g. 1.4, 3.8, 13


EEXXAAMMPPLLEESS
	rr..ccaattss mmaapp==_s_o_i_l_s
	      prints the values and labels associated with all	of  the  cate-
	      gories in the _s_o_i_l_s raster map layer;

	rr..ccaattss mmaapp==_s_o_i_l_s ccaattss==_1_0_,_1_2_,_1_5_-_2_0
	      prints  only  the category values and labels for _s_o_i_l_s map layer
	      categories 10, 12, and 15 through 20; and

	rr..ccaattss map=soils cats=10,20 fs= :
	      prints the values and labels for _s_o_i_l_s map layer	categories  10
	      and  20,	but uses ":" (instead of a tab) as the character sepa-
	      rating the category values from the category values in the  out-
	      put.

       Example output:


       10:Dumps, mine, Cc
       20:Kyle clay, KaA


NNOOTTEESS
       Any ASCII TAB characters which may be in the label are replaced by spa-
       ces.


       The output from _r_._c_a_t_s can be redirected into a	file,  or  piped  into
       another program.

SSEEEE AALLSSOO
       UNIX Manual entries for _a_w_k and _s_o_r_t


       _r_._c_o_i_n

       _r_._d_e_s_c_r_i_b_e

       _d_._w_h_a_t_._r_a_s_t

       _r_._s_u_p_p_o_r_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.cats(1)
