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 qvector=name   [layer=integer]    [qlayer=inte‐
16       ger]  column=string qcolumn=string
17
18   Parameters:
19       vector=name
20           Vector map with points for which to modify the attribute table
21
22       qvector=name
23           Vector map to be queried
24
25       layer=integer
26           Layer  of  the  vector  for  which  to  modify  the attribute table
27           Default: 1
28
29       qlayer=integer
30           Layer of the vector to be queried Default: 1
31
32       column=string
33           Column to be updated with the query result
34
35       qcolumn=string
36           Column to be queried
37

DESCRIPTION

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

NOTES

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

EXAMPLE

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

SEE ALSO

68        v.db.addcol, v.db.select, v.distance, v.what.rast
69

AUTHOR

71       Markus Neteler
72
73       Last changed: $Date: 2007/03/08 13:51:31 $
74
75       Full index
76
77
78
79GRASS 6.2.2                                                     v.what.vect(1)