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

NAME

6       v.what.rast3   - Uploads 3D raster values at positions of vector points
7       to the table.
8

KEYWORDS

10       vector, sampling, raster, position, querying, attribute table,  surface
11       information
12

SYNOPSIS

14       v.what.rast3
15       v.what.rast3 --help
16       v.what.rast3   map=name    [layer=string]   raster_3d=name  column=name
17       [where=sql_query]   [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       --help
21           Print usage summary
22
23       --verbose
24           Verbose module output
25
26       --quiet
27           Quiet module output
28
29       --ui
30           Force launching GUI dialog
31
32   Parameters:
33       map=name [required]
34           Name of vector points map for which to edit attributes
35           Or data source for direct OGR access
36
37       layer=string
38           Layer number or name
39           Vector features can have category values in different layers.  This
40           number  determines  which  layer  to use. When used with direct OGR
41           access this is the layer name.
42           Default: 1
43
44       raster_3d=name [required]
45           Name of existing 3D raster map to be queried
46
47       column=name [required]
48           Name of attribute column to be updated with the query result
49
50       where=sql_query
51           WHERE conditions of SQL statement without ’where’ keyword
52           Example: income < 1000 and population >= 10000
53

DESCRIPTION

55       v.what.rast3 reads 3D raster value for each point  in  the  vector  and
56       updates  col column in vector attribute table by this value. The column
57       should be type double. This module is based on v.what.rast.
58       If more points have the same category, attribute value is set to  NULL.
59       If 3D raster values is NULL, attribute value is set to NULL.
60

NOTES

EXAMPLES

63       A)  Reading  values  from  3D  raster map at position of vector points,
64       writing these values into a column of the attribute table connected  to
65       the vector map:
66       v.what.rast3 map=pnts raster3d=plume column=concentration
67
68       B)  In case of a vector map without attached attribute table, first add
69       a new attribute table. This table is then populated with values queried
70       from the raster map:
71       # create new random 3d vector points map
72       v.random -z output=pnts npoints=100 zmin=0  zmax=50
73       # add new table, link to map
74       v.db.addtable map=pnts column="concentration double precision"
75       # query raster map and upload values to vector table into specified column
76       g.region raster3d=plume -p
77       v.what.rast3 map=pnts raster3d=plume column=concentration
78       # verify new attribute table:
79       v.db.select map=pnts
80       # verify statistics of uploaded values:
81       v.univar map=pnts column=concentration type=point
82

SEE ALSO

84        v.db.addtable, v.db.select, v.what.rast, v.what.vect, v.univar
85

AUTHOR

87       Soeren Gebbert, heavily based on v.what.rast by Radim Blazek
88

SOURCE CODE

90       Available at: v.what.rast3 source code (history)
91
92       Main  index  | Vector index | Topics index | Keywords index | Graphical
93       index | Full index
94
95       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
96
97
98
99GRASS 7.8.2                                                    v.what.rast3(1)
Impressum