.TH v.what 1grass "" "GRASS 8.3.2" "GRASS GIS User's Manual"
.SH NAME
\fI\fBv.what\fR\fR  \- Queries a vector map at given locations.
.SH KEYWORDS
vector, querying, position
.SH SYNOPSIS
\fBv.what\fR
.br
\fBv.what \-\-help\fR
.br
\fBv.what\fR [\-\fBdagjm\fR] \fBmap\fR=\fIname\fR[,\fIname\fR,...]  [\fBlayer\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]  \fBcoordinates\fR=\fIeast,north\fR  [\fBdistance\fR=\fIfloat\fR]   [\fBcolumns\fR=\fIname\fR[,\fIname\fR,...]]   [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\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\-j\fR" 4m
.br
Print the stats in JSON
.IP "\fB\-m\fR" 4m
.br
Print multiple features if overlapping features are found
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBmap\fR=\fIname[,\fIname\fR,...]\fR \fB[required]\fR" 4m
.br
Name of vector map(s)
.IP "\fBlayer\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Layer number or name (\(cq\-1\(cq for all layers)
.br
A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
.br
Default: \fI\-1\fR
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Input feature type
.br
Options: \fIpoint, line, boundary, centroid, area, face, kernel\fR
.br
Default: \fIpoint,line,area,face\fR
.IP "\fBcoordinates\fR=\fIeast,north\fR \fB[required]\fR" 4m
.br
Coordinates for query
.br
\(cq\-\(cq for standard input
.IP "\fBdistance\fR=\fIfloat\fR" 4m
.br
Query threshold distance
.br
Default: \fI0\fR
.IP "\fBcolumns\fR=\fIname[,\fIname\fR,...]\fR" 4m
.br
Name of attribute column(s)
.br
Default: all columns
.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:
.br
.nf
\fC
v.what zipcodes_wake coordinates=637502.25,221744.25
\fR
.fi
.PP
Find closest hospital to given position within given distance (search radius):
.br
.nf
\fC
v.what hospitals coordinates=542690.4,204802.7 distance=2000000
\fR
.fi
.SH SEE ALSO
\fI
d.what.rast,
d.what.vect,
v.rast.stats,
v.vect.stats,
v.what.rast,
v.what.rast3,
v.what.vect
\fR
.SH AUTHOR
Trevor Wiens
.br
Edmonton, Alberta, Canada
.SH SOURCE CODE
.PP
Available at:
v.what source code
(history)
.PP
Accessed: Friday Mar 08 07:35:15 2024
.PP
Main index |
Vector index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2024
GRASS Development Team,
GRASS GIS 8.3.2 Reference Manual