.TH v.in.lines 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.in.lines\fR\fR  - Import ASCII x,y[,z] coordinates as a series of lines.
.SH KEYWORDS
vector, import
.SH SYNOPSIS
\fBv.in.lines\fR
.br
\fBv.in.lines help\fR
.br
\fBv.in.lines\fR [\-\fBz\fR] \fBinput\fR=\fIstring\fR \fBoutput\fR=\fIstring\fR  [\fBfs\fR=\fIcharacter\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-z\fR" 4m
.br
Create a 3D line from 3 column data
.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=\fIstring\fR" 4m
.br
Name of input file (or "-" to read from stdin)
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
Name for output vector map
.IP "\fBfs\fR=\fIcharacter\fR" 4m
.br
Field separator
.br
Default: \fI|\fR
.PP
.SH DESCRIPTION
Imports a stream of ASCII x,y[,z] coordinates as a line or series of lines.
.SH NOTES
Input ASCII coordinates are simply a series of "x y" data points.
Lines are separated by a row containing "NaN NaN".
.PP
The user can import 3D lines by providing 3 columns of data in the input
stream and using the \fB-z\fR flag.
.PP
This script is a simple wrapper around the \fIv.in.mapgen\fR module.
.SH EXAMPLE
\fC
.DS
.br
v.in.lines in=- out=two_lines fs=, <<EOF
.br
167.846717,-46.516653
.br
167.846663,-46.516645
.br
167.846656,-46.516644
.br
167.846649,-46.516644
.br
167.846642,-46.516643
.br
NaN,NaN
.br
167.846520,-46.516457
.br
167.846528,-46.516461
.br
167.846537,-46.516464
.br
167.846535,-46.516486
.br
167.846544,-46.516489
.br
167.846552,-46.516493
.br
EOF
.br
.br
v.category in=two_lines out=lines_with_cats option=add
.br
.DE
\fR
.SH SEE ALSO
\fI
v.in.ascii,
v.in.mapgen,
v.out.ascii,
d.graph,
r.in.poly
\fR
.SH AUTHOR
Hamish Bowman
.br
Dunedin, New Zealand
.PP
\fILast changed: $Date: 2011-09-04 15:23:30 +0200 (Sun, 04 Sep 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team