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



NNAAMMEE
       rr..wwhhaatt  - Queries raster map layers on their category val-
       ues and category 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  geo-
       graphic	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  command 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 coordinates into the program, the program will query
       the user for point locations 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 lay-
	      ers 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 geographic loca-
       tion. 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)
