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



NNAAMMEE
       rr..wwhhaatt	- Queries raster map layers on their category values and cate-
       gory labels.

       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..wwhhaatt
       rr..wwhhaatt hheellpp
       rr..wwhhaatt [--ffccii] iinnppuutt==_n_a_m_e[,_n_a_m_e,...] [ccaacchhee==_v_a_l_u_e] [nnuullll==_s_t_r_i_n_g]
       rr..wwhhaatt  [--ffccii]  iinnppuutt==_n_a_m_e[,_n_a_m_e,...]   [<   _i_n_p_u_t_f_i_l_e]	 [ccaacchhee==_v_a_l_u_e]
       [nnuullll==_s_t_r_i_n_g]

DDEESSCCRRIIPPTTIIOONN
       _r_._w_h_a_t  outputs	the  category  values  and  (optionally)  the category
       labels associated with user-specified locations on raster input map(s).
       Locations  are specified as geographic x,y coordinate pairs (i.e., pair
       of eastings and northings); the user can also (optionally) associate  a
       label with each location.


       The  program  will  be  run non-interactively if the user specifies the
       program	parameter values and (optionally) the flag setting on the com-
       mand line, using the form: rr..wwhhaatt [--ff] iinnppuutt==_n_a_m_e[,_n_a_m_e,...]

       where  each input _n_a_m_e is the name of a raster map layer whose category
       values are to be queried, and the (optional) flag --ff directs _r_._w_h_a_t  to
       also  output category labels. The user can also redirect a user-created
       ASCII input file containing a list of geographic coordinate  pairs  and
       (optionally) user-named labels, into _r_._w_h_a_t using the form: rr..wwhhaatt [--ff]
       iinnppuutt==_n_a_m_e[,_n_a_m_e,...]  [< _i_n_p_u_t_f_i_l_e]

       If the user does not redirect an input file  containing	these  coordi-
       nates into the program, the program will query the user for point loca-
       tions and labels.


       Alternately, the user can simply type: rr..wwhhaatt

       on the command line, without program arguments. In this case, the  user
       will  be  prompted  for the flag setting and parameter values using the
       standard GRASS _p_a_r_s_e_r.

OOPPTTIIOONNSS
   FFllaaggss::
       --ff     Also output the category label(s) associated with the cell(s) at
	      the user-specified location(s).

       --cc     Turn on cache reporting.

       --ii     Output integer category values, not cell values.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e[_,_n_a_m_e_,_n_a_m_e_,_._._.]
	      The  name(s)  of	one  or  more existing raster map layers to be
	      queried.

       ccaacchhee==_v_a_l_u_e
	      Size of point cache.

       nnuullll==_s_t_r_i_n_g
	      Character string to represent no data cell.


EEXXAAMMPPLLEESS
       The contents of the ASCII _i_n_p_u_t_f_i_l_e to _r_._w_h_a_t can be typed  in  at  the
       keyboard,  redirected  from a file, or piped from another program (like
       _d_._w_h_e_r_e). Each line of the input consists of an	easting,  a  northing,
       and  an	optional label, which are separated by spaces. The word eenndd is
       typed to end input of coordinates to _r_._w_h_a_t. For example:

       635342.21 7654321.09 site 1
	      653324.88 7563412.42 site 2 end

       _r_._w_h_a_t output consists of the input geographic location and label, and,
       for each user-named raster map layer, the category value, and (if _-_f is
       specified) the category label associated with the cell(s) at this  geo-
       graphic	location.  Sample  input  (in  regular font) to and output (in
       plain text) from _r_._w_h_a_t are given below.

	rr..wwhhaatt iinnppuutt=soils,aspect
	      635342.21 7654321.09 site 1 653324.88 7563412.42 site 2 end

       635342.21|7654321.09|site 1|45|21

	      653324.88|7563412.42|site 2|44|20



	rr..wwhhaatt --ff iinnppuutt==soils,aspect

	      635342.21 7654321.09 site 1

	      653324.88 7563412.42 site 2

	      end

       635342.21|7654321.09|site 1|45|NaC|21|30 degrees NW
	      653324.88|7563412.42|site 2|44|NdC|20|15 degrees NW


NNOOTTEESS
       The maximum number of raster map layers that can be queried at one time
       is 14.

SSEEEE AALLSSOO
       _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.what(1)
