d.site.edit(1)	       Grass User's Manual	   d.site.edit(1)



NNAAMMEE
       dd..ssiittee..eeddiitt  -  Allows the user to interactively query and
       update/delete the category contents  of	single	site  map
       layer at user- specified locations within the current geo-
       graphic region.	(GRASS Display Program)

SSYYNNOOPPSSIISS
       dd..ssiittee..eeddiitt

       dd..ssiittee..eeddiitt help

       dd..ssiittee..eeddiitt   [iinnppuutt=old_site_name]   [oouuttppuutt=output_site]
       [ddccoolloorr=color]




DDEESSCCRRIIPPTTIIOONN
       d.site.edit  outputs the east, north coordinate values and
       labels associated with site(s) nearest to the  user-speci-
       fied location(s) on user-named site map layer.


       The  program  will  query  the  contents of site map layer
       named by the user on the command line and allow to  either
       update  the  description  of a site or remove a site.  The
       input site layer 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.


       Parameters:


       iinnppuutt=old_site_name	     Name  of  existing  site map
       layer.


       oouuttppuutt=new_site_name	    Name of a new site map layer.


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



       d.site.edit  allows to edit or display the contents of the
       geographic coordinates of a location pointed to, and,  for
       the site map layer, and category label nearest site in the
       named site map layers at this location.



EEXXAAMMPPLLEE
       It is helpful, but not necessary, to first display  a  map
       to  be  used  for  reference  in  the active display frame
       before running d.site.edit.  For example, the  user  might
       type the following series of commands and receive the out-
       put below.  dd..ssiitteess mmaapp_=_w_e_l_l_s



       To first display the soils map in the active frame.


       dd..ssiittee..eeddiitt iinnppuutt==_w_e_l_l_s oouuttppuutt==_n_e_w___w_e_l_l_s



       User then moves the mouse to desired location on the  dis-
       played well map layer, and presses the middle 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.


       -613988.990000 east, 804343.040000  north,  08376300  1968
       1980 1 3



       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.site.edit  session.  The left button will
       allow get into update menu where using left click the cat-
       egory  information  can	be  updated,  using  middle mouse
       option a site could be deleted and the right mouse  option
       will bring back to main menu.



NNOOTTEESS
       d.site.edit  will  always print its output to the terminal
       screen.	d.site.edit 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:
       d.site.edit input=wells output=new_wells > what.out
       will both send d.site.edit output to the screen	and  cap-
       ture its output in the file named what.out.

SSEEEE AALLSSOO
       d.sites

       d.what.site

       d.what.rast

       d.what.vect

       d.where

       g.region

       parser



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.site.edit(1)
