v.in.mapgen(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

💖 v.in.mapgen 💖

okay bestie, welcome to v.in.mapgen from the GRASS User's Manual — she's the module that imports Mapgen or Matlab-ASCII vector maps into GRASS, and she is lowkey a whole vibe. ✨

🌸 NAME 🌸

v.in.mapgen — imports Mapgen or Matlab-ASCII vector maps into GRASS. that's it, that's the girl. 💅

🏷️ KEYWORDS 🏷️

vector, import

✨ SYNOPSIS ✨

v.in.mapgen
v.in.mapgen --help
v.in.mapgen [-fz] input=name  [output=name]   [--overwrite]  [--help]
[--verbose]  [--quiet]  [--ui]

🎀 Flags 🎀

  • -f — bestie, this means the input map is in Matlab format 🧚
  • -z — makes a 3D vector points map out of 3 column Matlab data. elevation era fr fr 🔥
  • --overwrite — lets output files overwrite existing files. she's bold, she's brave 🫶
  • --help — prints the usage summary, classic
  • --verbose — verbose module output, she will tell you EVERYTHING 😭
  • --quiet — quiet module output, she will tell you nothing 🤫
  • --ui — forces launching the GUI dialog, main character energy 👑

🦋 Parameters 🦋

  • input=name [required] — name of input file in Mapgen/Matlab format. yeah you gotta give her this one, no skipping 🍓
  • output=name — name for output vector map (omit it and she'll display to stdout instead 👀)

💜 DESCRIPTION 💜

Not me explaining this so u get it: v.in.mapgen lets the user import Mapgen or Matlab vector maps into GRASS. that's the whole serve. iconic behavior, no cap. ⭐

🌈 NOTES 🌈

so like, important tea: this module only imports data into vector lines. that's her lane, she's staying in it. 💅

u can get coastline data in Mapgen or Matlab format from NOAA's Coastline Extractor at:

https://www.ngdc.noaa.gov/mgg/shorelines/shorelines.html

Matlab vector line maps are literally just a series of "x y" data points. lines are separated by a row containing NaN NaN. yes, that's the divider, that's how she knows. 🙈

Output from Matlab with this command:

save filename.txt arrayname -ASCII

And if u wanna import 3D lines from Matlab? export a 3 column array and use the -z flag. go off, 3D queen 👑✨

👀 SEE ALSO 👀

  • v.in.ascii

🫶 AUTHORS 🫶

  • Based on v.in.mapgen.sh for GRASS 5.0 by Andreas Lange
  • Rewritten for GRASS 6 by Hamish Bowman

🔥 SOURCE CODE 🔥

Available at: v.in.mapgen source code (history)

Latest change: Thursday Nov 06 22:27:54 2025 in commit: 298b38614712934179355ea767403d6bfea8f5f9

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

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

okay that's the whole page bestie, ty for coming to my ted talk 💖 this was the GRASS 8.5.0 manual page for v.in.mapgen, and she's serving it fr fr. now go import some coastlines or whatever, slay 🌸💅🦋

📦 where this page comes from