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

NAME

6       v.to.3d  - Performs transformation of 2D vector features to 3D.
7

KEYWORDS

9       vector, geometry, 3D
10

SYNOPSIS

12       v.to.3d
13       v.to.3d --help
14       v.to.3d  [-rt]  input=name  [layer=string]   [type=string[,string,...]]
15       output=name  [column=name]   [height=float]    [--overwrite]   [--help]
16       [--verbose]  [--quiet]  [--ui]
17
18   Flags:
19       -r
20           Reverse transformation; 3D vector features to 2D
21
22       -t
23           Do not copy attribute table
24
25       --overwrite
26           Allow output files to overwrite existing files
27
28       --help
29           Print usage summary
30
31       --verbose
32           Verbose module output
33
34       --quiet
35           Quiet module output
36
37       --ui
38           Force launching GUI dialog
39
40   Parameters:
41       input=name [required]
42           Name of input vector map
43           Or data source for direct OGR access
44
45       layer=string
46           Layer number or name (’-1’ for all layers)
47           A  single  vector map can be connected to multiple database tables.
48           This number determines which table to use. When  used  with  direct
49           OGR access this is the layer name.
50           Default: 1
51
52       type=string[,string,...]
53           Input feature type
54           Options: point, line, boundary, centroid
55           Default: point,line,boundary,centroid
56
57       output=name [required]
58           Name for output vector map
59
60       column=name
61           Name of attribute column used for height
62           Can be used for reverse transformation, to store height of points
63
64       height=float
65           Fixed height for 3D vector features
66

DESCRIPTION

68       The  v.to.3d  module  is  used  to  transform 2D vector features to 3D.
69       Height (z-coordinate) of 3D vector features can be specified by  height
70       parameter as fixed value or by column parameter.
71
72       Flag  -r  enables to perform reverse transformation, i.e., transform 3D
73       vector to 2D by omitting z-coordinate. Height of input 3D features  can
74       be optionally stored in column.
75

NOTES

77       When transforming 2D vector features to 3D based on attribute, all NULL
78       values are silently converted to height 0.0.
79
80       Reverse transformation is possible for points and lines.   In  case  of
81       lines, the reverse transformation should be used only when all vertices
82       of a line have the same z-coordinate (for example contours).
83

EXAMPLES

85   Transform 2D vector features to 3D
86       # convert z-values from string to double
87       v.db.addcolumn map=geodetic_pts columns="Z_VALUE_D double precision"
88       v.db.update map=geodetic_pts column=Z_VALUE_D qcolumn=Z_VALUE
89       v.db.select map=geodetic_pts columns=cat,Z_VALUE,Z_VALUE_D
90       # convert 2D vector point map to 3D based on attribute
91       v.to.3d input=geodetic_pts out=geodetic_pts_3d column=Z_VALUE_D
92
93   Transform 3D vector features to 2D
94       v.to.3d -rt input=elev_lid792_bepts output=elev_lid_2d
95

SEE ALSO

97        v.transform, v.extrude, v.drape
98

AUTHOR

100       Martin Landa, Czech Technical University in Prague, Czech Republic
101

SOURCE CODE

103       Available at: v.to.3d source code (history)
104
105       Accessed: Saturday Jan 21 21:16:22 2023
106
107       Main index | Vector index | Topics index | Keywords index  |  Graphical
108       index | Full index
109
110       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
111
112
113
114GRASS 8.2.1                                                         v.to.3d(1)
Impressum