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



NNAAMMEE
       rr..ccaattss - Prints category values and labels associated with
       user-specified 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 categories (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 listing 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 sepa-
       rate  the  category  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 spec-
       ified 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 categories 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 separating the category  val-
	      ues from the category values in the output.

       Example output:


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


NNOOTTEESS
       Any  ASCII  TAB	characters  which may be in the label are
       replaced by spaces.


       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)
