NAME

d.site.edit - Allows the user to interactively query and update/delete the category contents of single site map layer at user- specified locations within the current geographic region. (GRASS Display Program)

SYNOPSIS

d.site.edit
d.site.edit help
d.site.edit [input=old_site_name] [output=output_site] [dcolor=color]

DESCRIPTION

d.site.edit outputs the east, north coordinate values and labels associated 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:

input=old_site_name Name of existing site map layer.

output=new_site_name Name of a new site map layer.

dcolor=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 location.

EXAMPLE

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.
d.sites map=wells

To first display the soils map in the active frame.

d.site.edit input=wells output=new_wells

User then moves the mouse to desired location on the displayed well map layer, and presses the middle mouse button to query the category contents 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 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 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.

NOTES


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: .nf d.site.edit input=wells output=new_wells > what.out .fi will both send d.site.edit output to the screen and capture its output in the file named what.out.

SEE ALSO

d.sites
d.what.site
d.what.rast
d.what.vect
d.where
g.region
parser

AUTHOR

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

Last changed: $Date$