.TH d.what.vect 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.what.vect\fR\fR  - Allows the user to interactively query a vector map layer at user-selected locations within the current geographic region.
.SH KEYWORDS
display, vector
.SH SYNOPSIS
\fBd.what.vect\fR
.br
\fBd.what.vect help\fR
.br
\fBd.what.vect\fR [\-\fB1txdfe\fR] \fBmap\fR=\fIname\fR[,\fIname\fR,...]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-1\fR" 4m
.br
Identify just one location
.IP "\fB\-t\fR" 4m
.br
Terse output. For parsing by programs
.IP "\fB\-x\fR" 4m
.br
Print information as plain text to terminal window
.IP "\fB\-d\fR" 4m
.br
Print topological information (debugging)
.IP "\fB\-f\fR" 4m
.br
Enable flashing (slower)
.IP "\fB\-e\fR" 4m
.br
Open form in edit mode
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname[,\fIname\fR,...]\fR" 4m
.br
Name of existing vector map
.PP
.SH DESCRIPTION
\fId.what.vect\fR
outputs the category value(s) associated with user-specified location(s) 
in user-specified vector map layer(s). 
.PP
The program activates the mouse, and expects the user to indicate the 
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. Query results from map(s) are by default displayed in a new 
monitor, where label values can be added or changed. Using parameter \fB-x\fR 
information will be displayed as plain text to terminal window.
.PP
This module always reports standard acres, even when the location uses
US Survey feet as the map unit.
.SH EXAMPLE
A sample \fId.what.vect\fR session is given below. Although it is not 
necessary that the user first displays a vector map to be queried in the 
active display frame, it is helpful to have a map displayed there for 
reference. 
.PP
\fBd.vect map=\fR\fIroads\fR
.PP
Displays the \fIroads\fR vector map layer on the graphics monitor. 
.PP
\fBd.what.vect map=\fR\fIroads,geology\fR
.PP
After typing this, the user moves the mouse to a desired location 
on the displayed \fIroads\fR map layer, and presses the left mouse 
button to query the category value of the \fIroads\fR and the
\fIgeology\fR vector map at this location. 
The program then outputs the category value of a line type corresponding 
to this user-selected map location, for the vector map queried by the user. 
.PP
The query may be repeated as often as desired using the left mouse button. The 
middle mouse button toggles the flash color.
The right button on the mouse is used to quit the \fId.what.vect\fR session. 
.SH SEE ALSO
\fI
d.rast
.br
d.vect
.br
d.what.rast
.br
g.region
.br
v.what
\fR
.SH AUTHOR
Jim Hinthorne,
Central Washington University
.br
Upgrades by Dennis Finch, National Park Service
and Radim Blazek, ITC-Irst, Trento, Italy
.PP
\fILast changed: $Date: 2012-02-25 14:14:51 +0100 (Sat, 25 Feb 2012) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team