1v.what(1)                   GRASS GIS User's Manual                  v.what(1)
2
3
4

NAME

6       v.what  - Queries a vector map at given locations.
7

KEYWORDS

9       vector, querying, position
10

SYNOPSIS

12       v.what
13       v.what --help
14       v.what    [-dagjm]   map=name[,name,...]    [layer=string[,string,...]]
15       [type=string[,string,...]]   coordinates=east,north    [distance=float]
16       [columns=name[,name,...]]   [--help]  [--verbose]  [--quiet]  [--ui]
17
18   Flags:
19       -d
20           Print topological information (debugging)
21
22       -a
23           Print attribute information
24
25       -g
26           Print the stats in shell script style
27
28       -j
29           Print the stats in JSON
30
31       -m
32           Print multiple features if overlapping features are found
33
34       --help
35           Print usage summary
36
37       --verbose
38           Verbose module output
39
40       --quiet
41           Quiet module output
42
43       --ui
44           Force launching GUI dialog
45
46   Parameters:
47       map=name[,name,...] [required]
48           Name of vector map(s)
49
50       layer=string[,string,...]
51           Layer number or name (’-1’ for all layers)
52           A  single  vector map can be connected to multiple database tables.
53           This number determines which table to use. When  used  with  direct
54           OGR access this is the layer name.
55           Default: -1
56
57       type=string[,string,...]
58           Input feature type
59           Options: point, line, boundary, centroid, area, face, kernel
60           Default: point,line,area,face
61
62       coordinates=east,north [required]
63           Coordinates for query
64           ’-’ for standard input
65
66       distance=float
67           Query threshold distance
68           Default: 0
69
70       columns=name[,name,...]
71           Name of attribute column(s)
72           Default: all columns
73

DESCRIPTION

75       v.what outputs the category number value(s) associated with user-speci‐
76       fied location(s) in user-specified vector map  layer(s).   This  module
77       was  derived  from  the  d.what.vect module by removing all interactive
78       code and modification of the output for easy parsing. Using the -g flag
79       generates script-style output which is easily parsable.
80

EXAMPLE

82       North Carolina sample dataset example:
83
84       Query polygon at given position:
85       v.what zipcodes_wake coordinates=637502.25,221744.25
86
87       Find  closest  hospital to given position within given distance (search
88       radius):
89       v.what hospitals coordinates=542690.4,204802.7 distance=2000000
90

SEE ALSO

92        d.what.rast,  d.what.vect,  v.rast.stats,  v.vect.stats,  v.what.rast,
93       v.what.rast3, v.what.vect
94

AUTHOR

96       Trevor Wiens
97       Edmonton, Alberta, Canada
98

SOURCE CODE

100       Available at: v.what source code (history)
101
102       Accessed: Saturday Oct 28 18:18:51 2023
103
104       Main  index  | Vector index | Topics index | Keywords index | Graphical
105       index | Full index
106
107       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
108
109
110
111GRASS 8.3.1                                                          v.what(1)
Impressum