.TH v.to.3d 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.to.3d\fR\fR  - Performs transformation of 2D vector features to 3D.
.SH KEYWORDS
vector, transformation, 3D
.SH SYNOPSIS
\fBv.to.3d\fR
.br
\fBv.to.3d help\fR
.br
\fBv.to.3d\fR [\-\fBrt\fR] \fBinput\fR=\fIname\fR \fBoutput\fR=\fIname\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBheight\fR=\fIfloat\fR]   [\fBlayer\fR=\fIinteger\fR]   [\fBcolumn\fR=\fIname\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-r\fR" 4m
.br
Reverse transformation; 3D vector features to 2D
.IP "\fB\-t\fR" 4m
.br
Do not copy table
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output vector map
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Feature type
.br
Options: \fIpoint,line,boundary,centroid\fR
.br
Default: \fIpoint,line,boundary,centroid\fR
.IP "\fBheight\fR=\fIfloat\fR" 4m
.br
Fixed height for 3D vector features
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
A single vector map can be connected to multiple database tables. This number determines which table to use.
.br
Default: \fI1\fR
.IP "\fBcolumn\fR=\fIname\fR" 4m
.br
Name of attribute column used for height
.br
Can be used for reverse transformation, to store height of points
.PP
.SH DESCRIPTION
The \fIv.to.3d\fR module is used to transform 2D vector features
to 3D. Height (z-coordinate) of 3D vector features can be specified
by \fBheight\fR parameter as fixed value or by \fBcolumn\fR
parameter.
.PP
Flag \fB-r\fR enables to perform reverse transformation, i.e.,
transform 3D vector to 2D by omitting z-coordinate.
.SH  NOTES
When transforming 2D vector features to 3D based on attribute, all
NULL values are silently converted to height 0.0.
.SH EXAMPLES
.SS Transform 2D vector features to 3D
\fC
.DS
.br
# convert z-values from string to double
.br
v.db.addcol map=geodetic_pts columns="Z_VALUE_D double precision"
.br
v.db.update map=geodetic_pts column=Z_VALUE_D qcolumn=Z_VALUE
.br
v.db.select map=geodetic_pts columns=cat,Z_VALUE,Z_VALUE_
.br
.br
# convert 2D vector point map to 3D based on attribute
.br
v.to.3d input=geodetic_pts out=geodetic_pts_3d column=Z_VALUE_D
.br
.DE
\fR
.SS Transform 3D vector features to 2D
\fC
.DS
.br
v.to.3d \-rt input=elev_lid792_bepts output=elev_lid_2d
.br
.DE
\fR
.SH SEE ALSO
\fI
v.transform,
v.extrude,
v.drape
\fR
.SH AUTHORS
Martin Landa, CTU in Prague, Czech Republic
.PP
\fILast changed: $Date: 2009-01-10 00:39:21 +0100 (Sat, 10 Jan 2009) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team