v.in.lines(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

✨ v.in.lines ✨

okay bestie, welcome to v.in.lines, straight outta the GRASS GIS User's Manual 💖 this is the lil tool that imports ASCII x,y[,z] coordinates as a series of lines. yes she's a vector-importing queen and yes she's about to eat 👑

🌈 NAME 🌈

v.in.lines — imports ASCII x,y[,z] coordinates as a series of lines 💅

🎀 KEYWORDS 🎀

vector, import, line, point 🦋

✨ SYNOPSIS ✨

v.in.lines
v.in.lines --help
v.in.lines [-z] input=name output=name  [separator=character]
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

  • -z — creates a 3D line from 3-column data, no cap 🫶
  • --overwrite — lets the output files overwrite existing files, she's assertive like that 💅
  • --help — prints the usage summary, iykyk 📖
  • --verbose — verbose module output, she tells you everything 🙈
  • --quiet — quiet module output, she says nothing at all 🤫
  • --ui — force-launches the GUI dialog, main character energy 🖥️✨

🧚 Parameters 🧚

  • input=name [required] — name of the input file (or "-" to read from stdin, our little stream queen 🍓)
  • output=name [required] — name for the output vector map, gotta name her 💖
  • separator=character — the field separator 🌸
    • Special characters: pipe, comma, space, tab, newline
    • Default: pipe

💜 DESCRIPTION 💜

Imports a stream of ASCII x,y[,z] coordinates as a line or a series of lines. that's the whole vibe. simple, iconic, done 💅

🦋 NOTES 🦋

okay so listen. the input ASCII coordinates are literally just a series of "x y" data points. nothing fancy, we love her for that ✨

Lines are separated by a row containing "NaN NaN". yep. that's the divider. not me using NaN NaN as a breakup text 😭

You can import 3D lines by providing 3 columns of data in the input stream and using the -z flag. three columns, one flag, infinite glow-up 🌈

This script is a simple wrapper around the v.in.mapgen module — she's little, but she's mighty 👑

🌸 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 how the NaN,NaN splits two_lines into two whole lines?? obsessed. that's the whole trick 🎀

👀 SEE ALSO 👀

d.graph, v.centroids, v.in.ascii, v.in.mapgen, v.in.region, v.out.ascii, r.in.poly

(the whole friend group fr fr 🫶)

👑 AUTHOR 👑

Hamish Bowman Dunedin, New Zealand 🌏

💻 SOURCE CODE 💻

Available at: v.in.lines source code (history) 🔗

Accessed: Saturday Jan 17 05:41:53 2026 ⏰

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual 💖

and that's a wrap bestie!! GRASS 8.4.2, page v.in.lines(1), signed sealed and slayed ✨💅🎀 go import some lines, you got this 🦋💖

📦 where this page comes from