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  pro-
	      vided  for  shell scripts and programs 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 pro-
	      grams.

       --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 out-
       put 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  dis-
       played  well  site list, and presses the left mouse button
       to query the category contents of the nearest  well  loca-
       tion.   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 ssiittee--
       ffiillee==_w_e_l_l_s >> wwhhaatt..oouutt

       will both send d.what.sites output to the screen and  cap-
       ture 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, Tem-
       ple, 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)
