1v.what.vect(1)                Grass User's Manual               v.what.vect(1)
2
3
4

NAME

6       v.what.vect   -  Uploads vector values at positions of vector points to
7       the table.
8

KEYWORDS

10       vector, database, attribute table
11

SYNOPSIS

13       v.what.vect
14       v.what.vect help
15       v.what.vect vector=name   [layer=integer]   column=string  qvector=name
16       [qlayer=integer]  qcolumn=string  [--verbose]  [--quiet]
17
18   Parameters:
19       vector=name
20           Points vector map to modify
21
22       layer=integer
23           Layer in the vector to be modified
24           Default: 1
25
26       column=string
27           Column to be updated with the query result
28
29       qvector=name
30           Vector map to be queried
31
32       qlayer=integer
33           Layer of the query vector containg data
34           Default: 1
35
36       qcolumn=string
37           Column to be queried
38

DESCRIPTION

40       v.what.vect transfers attributes from the qvector's map attribute table
41       into the attribute table of points  present  in  the  vector  map.  The
42       script is based on v.distance.
43

NOTES

45       The  upload  column,  into  which the query results are stored, must be
46       present in the vector map. Use v.db.addcol to add one if needed.
47
48       This module only uploads attributes which exist at the exact  positions
49       of  the  input's vector points. For a "nearest feature" fit, use v.dis‐
50       tance instead.
51
52       In case of a multipoint input vector map, with  several  points  having
53       the same category number, it can happen, that the query result is NULL,
54       if the same category number falls into different qvector polygons.
55

EXAMPLE

57       In this example, the 'archsites' point map in the Spearfish location is
58       copied  to  the current mapset, a new attribute column is added and the
59       owner names from the  'fields'  polygon  map  are  transferred  to  the
60       'myarchsites' map at points' locations:
61       g.copy vect=archsites,myarchsites
62       v.db.addcol myarchsites col="owner varchar(25)"
63       v.what.vect myarchsites qvect=fields column=owner qcolumn=label
64       # verification:
65       v.db.select myarchsites
66
67

SEE ALSO

69        v.db.addcol, v.db.select, v.distance, v.rast.stats, v.what.rast
70

AUTHOR

72       Markus Neteler
73
74       Last changed: $Date: 2007-06-10 13:23:21 +0200 (Sun, 10 Jun 2007) $
75
76       Full index
77
78       © 2003-2008 GRASS Development Team
79
80
81
82GRASS 6.3.0                                                     v.what.vect(1)