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

NAME

6       v.drape   -  Converts 2D vector features to 3D by sampling of elevation
7       raster map.
8

KEYWORDS

10       vector, geometry, sampling, 3D, surface information
11

SYNOPSIS

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

DESCRIPTION

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
89       region 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

NOTES

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

EXAMPLES

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

SEE ALSO

120        v.extrude,  v.to.3d,  r.out.pov,  v.in.region,  v.out.pov,  v.overlay,
121       v.split, v.what.rast
122

AUTHORS

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

SOURCE CODE

129       Available at: v.drape source code (history)
130
131       Main index | Vector index | Topics index | Keywords index  |  Graphical
132       index | Full index
133
134       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
135
136
137
138GRASS 7.8.2                                                         v.drape(1)
Impressum