~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to vector/v.extrude/v.extrude.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>v.extrude</em> creates faces, kernels or 3D lines based on input
 
4
2D vector features. Points are converted to 3D vertical lines, lines
 
5
to faces and areas to volumes (composition of closed set of faces and
 
6
kernel).
 
7
 
 
8
<p>
 
9
If <b>elevation</b> parameter is used then 3D vector features follow
 
10
the elevation model by using individual elevation values for the
 
11
vertices. Height for vertices is interpolated from elevation raster
 
12
map using given interpolation <b>method</b>.
 
13
 
 
14
<h2>NOTES</h2>
 
15
 
 
16
<em>v.extrude</em> extrudes vector features which means that points
 
17
are converted to vertical lines. Lines and area boundaries are
 
18
extruded to a set of faces, each segment defines one face. Area
 
19
centroids are written as kernels. Area as a composition of boundaries
 
20
and centroid is stored as a closed set of faces and kernel which
 
21
define a volume.
 
22
 
 
23
<p>
 
24
For conversion of 2D points or lines to 3D can be
 
25
used <em><a href="v.to.3d.html">v.to.3d</a></em>
 
26
or <em><a href="v.drape.html">v.drape</a></em>. In opposite
 
27
to <em>v.extrude</em>, these modules do not extrude vector features,
 
28
they defines z-coordinate for the features from given parameters or by
 
29
sampling elevation raster map values. It means that no feature type
 
30
conversion is applied, points remain still points in the output vector
 
31
map. Same applies for the lines.
 
32
 
 
33
<p>
 
34
<em>v.extrude</em> modifies only features geometry. Feature categories
 
35
remain untouched and attribute data is copied from input vector map to
 
36
the output.
 
37
 
 
38
<p>
 
39
By default, all features (including features without category) from
 
40
input vector map are processed (<b>layer=-1</b>). Feature selection
 
41
can be applied by <b>layer</b>, <b>cats</b> or <b>where</b>
 
42
parameter.
 
43
 
 
44
<h2>EXAMPLES</h2>
 
45
 
 
46
<h3>3D houses with fixed height</h3>
 
47
 
 
48
<div class="code"><pre>
 
49
v.extrude input=houses output=houses3D height=5 type=area
 
50
</pre></div>
 
51
 
 
52
<h3>3D houses with individual height</h3>
 
53
 
 
54
<div class="code"><pre>
 
55
v.extrude input=houses output=houses3D elevation=dem height_column=height type=area
 
56
</pre></div>
 
57
 
 
58
<h3>Convert 2D points to 3D vertical lines with fixed height</h3>
 
59
 
 
60
<div class="code"><pre>
 
61
v.extrude input=geodetic_pts output=points3D height=200 type=point
 
62
</pre></div>
 
63
 
 
64
<h2>SEE ALSO</h2>
 
65
 
 
66
<em>
 
67
<a href="v.transform.html">v.transform</a>,
 
68
<a href="v.extrude.html">v.extrude</a>,
 
69
<a href="v.drape.html">v.drape</a>,
 
70
<a href="v.to.3d.html">v.to.3d</a>
 
71
</em>
 
72
 
 
73
<p>
 
74
<em>
 
75
<a href="wxGUI.nviz.html">wxGUI 3D viewer</a>
 
76
</em>
 
77
 
 
78
<h2>AUTHORS</h2>
 
79
 
 
80
Jachym Cepicky,<br>
 
81
Updated for GRASS 7 by Martin Landa, FBK-irst,
 
82
Italy and Czech Technical University in Prague, Czech Republic
 
83
 
 
84
<p>
 
85
<i>Last changed: $Date: 2014-11-28 17:25:40 +0100 (Fri, 28 Nov 2014) $</i>