d.what.sites(1) 	      Grass User's Manual	       d.what.sites(1)



NNAAMMEE
       dd..wwhhaatt..ssiitteess - interactively query a single site list descriptions
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..wwhhaatt..ssiitteess
       dd..wwhhaatt..ssiitteess hheellpp
       dd..wwhhaatt..ssiitteess [--11ttqq] [ssiitteeffiillee==_n_a_m_e] [ddccoolloorr==_c_o_l_o_r] [rreeccoolloorr==_c_o_l_o_r]

DDEESSCCRRIIPPTTIIOONN
       _d_._w_h_a_t_._s_i_t_e_s outputs the east, north coordinate values and descriptions
       with site(s) nearest to the user-specified  location(s)	on  user-named
       site list.


       The  program  will query the contents of site list named by the user on
       the command line.  These site lists must exist in  the  user's  current
       mapset search path.


       The  program  activates the mouse, and expects the user to indicate the
       site location(s) to be  queried	by  depressing	a  mouse  button  over
       desired	location(s) within the current geographic region in the active
       display frame on the graphic monitor.

   FFllaagg::
       --11     Identify and query just one point location. Only one mouse click
	      is  executed. This option is provided for shell scripts and pro-
	      grams that want to obtain only one point from the user.

       --tt     Provide only terse output. This option is provided  to  simplify
	      the parsing of output by other programs.

       --qq     Load  quietly.  Do  not  show progress in loading the sites file
	      into memory.


   PPaarraammeetteerrss::
       ssiitteeffiillee==_n_a_m_e
	      Name of existing site list.

       ddccoolloorr==_n_a_m_e
	      Sets the display color to name.  Options:  red, orange,  yellow,
	      green,  blue,  indigo,  violet, magenta, brown, gray, white, and
	      black Default:  red

       rreeccoolloorr==_n_a_m_e
	      Sets the redraw color to name.  Options:	red,  orange,  yellow,
	      green,  blue,  indigo,  violet, magenta, brown, gray, white, and
	      black Default:  yellow

       ssiizzee==_v_a_l_u_e
	      Size, in pixels, in which the site icons are to be drawn.
	      Options:	0-1000
	      Default:	5

       ttyyppee==_n_a_m_e
	      The type of icon to be displayed at site locations.
	      Options:	x, diamond, box, +
	      Default:	x


EEXXAAMMPPLLEE
       It is helpful, but not necessary, to first display a site  list	to  be
       used   for  reference  in  the  active  display	frame  before  running
       _d_._w_h_a_t_._s_i_t_e_s.  For example, the user might type the following series of
       commands and receive the output below.  dd..ssiitteess ssiitteeffiillee==_w_e_l_l_s

       To  first display the well site list in the active frame.  dd..wwhhaatt..ssiitteess
       ssiitteeffiillee==_w_e_l_l_s

       User then moves the mouse to desired location  on  the  displayed  well
       site list, and presses the left mouse button to query the category con-
       tents of the nearest well location.  The program then outputs the below
       information to the user's terminal.
       the closest site is: -613988.990000 east, 804343.040000 north
       08376300 1968 1980 13
	 The  query  may  be repeated as often as desired using the left mouse
       button.	The right button on the mouse is used to quit the _d_._w_h_a_t_._s_i_t_e_s
       session.  The middle button will allow to redraw the site list.

NNOOTTEESS
       _d_._w_h_a_t_._s_i_t_e_s  will  always  print  its  output  to the terminal screen.
       _d_._w_h_a_t_._s_i_t_e_s output can be redirected into a file; however, if  it  is,
       the  output  will  go both to the screen and to the file.  For example:
       dd..wwhhaatt..ssiitteess ssiitteeffiillee==_w_e_l_l_s >> wwhhaatt..oouutt

       will both send d.what.sites output to the screen and capture its output
       in the file named _w_h_a_t_._o_u_t.

SSEEEE AALLSSOO
       _d_._s_i_t_e_s

       _d_._w_h_a_t_._r_a_s_t

       _d_._w_h_a_t_._v_e_c_t

       _d_._w_h_e_r_e

       _g_._r_e_g_i_o_n

       _p_a_r_s_e_r

AAUUTTHHOORR
       Raghavan Srinivasan, Blackland Research Center, TAES, Temple, TX 76502

       _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_3 _$



GRASS 5.0						       d.what.sites(1)
