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 loca-
       tions within the current geographic 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 asso-
       ciated with site(s) nearest to the user-specified 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,  violet,  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 loca-
       tion.



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 output 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 displayed well map
       layer, and presses the middle 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.


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



       The query may be repeated as often as desired using the left mouse but-
       ton.   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 category 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 capture 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, 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.site.edit(1)
