v.in.mapgen(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 v.in.mapgen — the "bring your Mapgen/Matlab maps into GRASS" era 💖

okay bestie, so this is a page from the GRASS GIS User's Manual, and the star of the show is the module v.in.mapgen(1). She's lowkey a legend: she takes Mapgen or Matlab-ASCII vector maps and yeets them straight into GRASS. 🌈

✨ NAME ✨

v.in.mapgen — Imports Mapgen or Matlab-ASCII vector maps into GRASS. 🦋

🎀 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 — Input map is in Matlab format
  • -z — Create a 3D vector points map from 3 column Matlab data
  • --overwrite — Allow output files to overwrite existing files
  • --help — Print usage summary
  • --verbose — Verbose module output
  • --quiet — Quiet module output
  • --ui — Force launching GUI dialog

🧚 Parameters 🧚

  • input=name <span style="color:red">[required]</span> — Name of input file in Mapgen/Matlab format
  • output=name — Name for output vector map (omit for display to stdout)
fr fr, input is required, no skipping her. And if you don't give an output, she just shows you the goods on stdout. 💅

💜 DESCRIPTION 💜

v.in.mapgen is literally here to let you import Mapgen or Matlab vector maps into GRASS. That's the whole vibe. Slay. ✨

🌟 NOTES 🌟

This module only imports data into vector lines. That's it, that's the lane she stays in. 🫶

You can grab 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 simply a series of "x y" data points, and lines are separated by a row containing NaN NaN. Iconic, honestly. 😭

To get that output from Matlab, use this command:

save filename.txt arrayname -ASCII

And if you wanna import 3D lines from Matlab? Just export a 3 column array and use the -z flag. Periodt. 💅

🌈 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)

Accessed: Saturday Jan 17 05:41:53 2026

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

and that's the whole page, bestie 🦋✨ this was GRASS 8.4.2, the GRASS GIS 8.4.2 Reference Manual, © 2003-2025 GRASS Development Team — mwah, no cap, she ate 💅👑

📦 where this page comes from