1v.drape(1) GRASS GIS User's Manual v.drape(1)
2
3
4
6 v.drape - Converts 2D vector features to 3D by sampling of elevation
7 raster map.
8
10 vector, geometry, sampling, 3D, surface information
11
13 v.drape
14 v.drape --help
15 v.drape input=name [layer=string] [cats=range] [where=sql_query]
16 [type=string[,string,...]] output=name elevation=name [method=string]
17 [scale=float] [null_value=float] [--overwrite] [--help] [--ver‐
18 bose] [--quiet] [--ui]
19
20 Flags:
21 --overwrite
22 Allow output files to overwrite existing files
23
24 --help
25 Print usage summary
26
27 --verbose
28 Verbose module output
29
30 --quiet
31 Quiet module output
32
33 --ui
34 Force launching GUI dialog
35
36 Parameters:
37 input=name [required]
38 Name of input vector map
39 Or data source for direct OGR access
40
41 layer=string
42 Layer number or name (’-1’ for all layers)
43 A single vector map can be connected to multiple database tables.
44 This number determines which table to use. When used with direct
45 OGR access this is the layer name.
46 Default: -1
47
48 cats=range
49 Category values
50 Example: 1,3,7-9,13
51
52 where=sql_query
53 WHERE conditions of SQL statement without ’where’ keyword
54 Example: income < 1000 and population >= 10000
55
56 type=string[,string,...]
57 Input feature type
58 Options: point, line, boundary, centroid
59 Default: point,line,boundary,centroid
60
61 output=name [required]
62 Name for output vector map
63
64 elevation=name [required]
65 Elevation raster map for height extraction
66
67 method=string
68 Sampling interpolation method
69 Options: nearest, bilinear, bicubic
70 Default: nearest
71 nearest: Nearest-neighbor interpolation
72 bilinear: Bilinear interpolation
73 bicubic: Bicubic interpolation
74
75 scale=float
76 Scale factor sampled raster values
77 Default: 1.0
78
79 null_value=float
80 Height for sampled raster NULL values
81
83 v.drape converts 2D/3D vector data into 3D vector format via sampling
84 of an elevation surface. Three sampling algorithms adapted from v.sam‐
85 ple were incorporated into this module: nearest neighbor, bilinear, and
86 cubic convultion.
87
88 v.drape will skip vector features outside of current computational re‐
89 gion or where raster map has NULL value. It’s possible to include all
90 vector features by specifying height value that will be assigned to
91 verticles whose values can not be determined from raster map.
92
94 Additional vertices can be added to the input 2D vector map with
95 v.split.
96
97 The module can be used in conjunction with v.out.pov and r.out.pov to
98 export a complete set of vector and raster data for display in POVRAY.
99
101 Spearfish example:
102 v.drape in=roads elevation=elevation.10m method=bilinear out=roads3d
103 v.info roads3d
104
105 Create 3D vector roads map containing only "unimproved" roads. Set road
106 height to 1000 m for all parts without height information.
107 v.drape input=roads type=line elevation=elevation.dem output=roads_3d \
108 method=nearest scale=1.0 where=’cat=5’ layer=1 null_value=1000
109
110 POVRAY example
111 #export the vector data
112 v.drape in=roads out=roads3d elevation=elevation.10m
113 v.out.pov roads3d out=roads3d.pov
114 #export the raster data
115 r.out.pov elevation.10m tga=elevation.tga
116 r.out.png landcover.30m out=landcover30m.png
117 # now write a complete povray-script and launch povray
118
120 v.extrude, v.to.3d, r.out.pov, v.in.region, v.out.pov, v.overlay,
121 v.split, v.what.rast
122
124 Dylan Beaudette, University of California at Davis.
125 Updated for GRASS 7 by Martin Landa, Czech Technical University in
126 Prague, Czech Republic
127
129 Available at: v.drape source code (history)
130
131 Accessed: Saturday Jan 21 21:15:57 2023
132
133 Main index | Vector index | Topics index | Keywords index | Graphical
134 index | Full index
135
136 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
137
138
139
140GRASS 8.2.1 v.drape(1)