Skip to content

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