.TH v.what 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.what\fR\fR  - Queries a vector map layer at given locations.
.SH KEYWORDS
vector, querying
.SH SYNOPSIS
\fBv.what\fR
.br
\fBv.what help\fR
.br
\fBv.what\fR [\-\fBdag\fR] \fBmap\fR=\fIname\fR[,\fIname\fR,...]  [\fBeast_north\fR=\fIeast,north\fR[,\fIeast,north\fR,...]]   [\fBdistance\fR=\fIfloat\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-d\fR" 4m
.br
Print topological information (debugging)
.IP "\fB\-a\fR" 4m
.br
Print attribute information
.IP "\fB\-g\fR" 4m
.br
Print the stats in shell script style
.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 input vector map
.IP "\fBeast_north\fR=\fIeast,north[,\fIeast,north\fR,...]\fR" 4m
.br
Coordinates for query
.br
If not given reads from standard input
.IP "\fBdistance\fR=\fIfloat\fR" 4m
.br
Query threshold distance
.br
Default: \fI0\fR
.PP
.SH DESCRIPTION
\fIv.what\fR outputs the category number value(s) associated with 
user-specified location(s) in user-specified vector map layer(s).  
This module was derived from the \fId.what.vect\fR module by 
removing all interactive code and modification of the output for 
easy parsing. Using the \fI-g\fR flag generates script-style 
output which is easily parsable.
.SH EXAMPLE
North Carolina sample dataset example:
.PP
Query polygon at given position:
\fC
.DS
.br
v.what zipcodes_wake east_north=637502.25,221744.25
.br
.DE
\fR
.PP
Find closest hospital to given position within given distance (search radius):
\fC
.DS
.br
v.what hospitals east_north=542690.4,204802.7 distance=2000000
.br
.DE
\fR
.SH SEE ALSO
\fI
d.what.vect
\fR
.SH AUTHOR
Trevor Wiens
.br
Edmonton, Alberta, Canada
.PP
\fILast changed: $Date: 2014-02-10 23:43:18 +0100 (Mon, 10 Feb 2014) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team