v.in.lines
Imports ASCII x,y[,z] coordinates as a series of lines.
v.in.lines [-z] input=name output=name [separator=character] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]
Example:
v.in.lines input=name output=name
grass.script.run_command("v.in.lines", input, output, separator="pipe", flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("v.in.lines", input="name", output="name")
Parameters
input=name [required]
Name of input file (or "-" to read from stdin)
output=name [required]
Name for output vector map
separator=character
Field separator
Special characters: pipe, comma, space, tab, newline
Default: pipe
-z
Create a 3D line from 3 column data
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
input : str, required
Name of input file (or "-" to read from stdin)
Used as: input, file, name
output : str, required
Name for output vector map
Used as: output, vector, name
separator : str, optional
Field separator
Special characters: pipe, comma, space, tab, newline
Used as: input, separator, character
Default: pipe
flags : str, optional
Allowed values: z
z
Create a 3D line from 3 column data
overwrite: bool, optional
Allow output files to overwrite existing files
Default: False
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
Imports a stream of ASCII x,y[,z] coordinates as a line or series of lines.
NOTES
Input ASCII coordinates are simply a series of "x y" data points. Lines
are separated by a row containing "NaN NaN
".
The user can import 3D lines by providing 3 columns of data in the input stream and using the -z flag.
This script is a simple wrapper around the v.in.mapgen module.
EXAMPLE
v.in.lines in=- out=two_lines separator=, <<EOF
167.846717,-46.516653
167.846663,-46.516645
167.846656,-46.516644
167.846649,-46.516644
167.846642,-46.516643
NaN,NaN
167.846520,-46.516457
167.846528,-46.516461
167.846537,-46.516464
167.846535,-46.516486
167.846544,-46.516489
167.846552,-46.516493
EOF
SEE ALSO
d.graph, v.centroids, v.in.ascii, v.in.mapgen, v.in.region, v.out.ascii, r.in.poly
AUTHOR
Hamish Bowman
Dunedin, New Zealand
SOURCE CODE
Available at: v.in.lines source code
(history)
Latest change: Wednesday Mar 05 14:10:57 2025 in commit 8605efe