v.in.mapgen

Imports Mapgen or Matlab-ASCII vector maps into GRASS.

Command linePython (grass.script)

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

Example:

v.in.mapgen input=name

grass.script.run_command("v.in.mapgen", input, output=None, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.in.mapgen", input="name")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input file in Mapgen/Matlab format
output=name
    Name for output vector map (omit for display to stdout)
-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
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input file in Mapgen/Matlab format
    Used as: input, file, name
output : str, optional
    Name for output vector map (omit for display to stdout)
    Used as: output, vector, name
flags : str, optional
    Allowed values: f, z
    f
        Input map is in Matlab format
    z
        Create a 3D vector points map from 3 column Matlab 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

v.in.mapgen allows the user to import Mapgen or Matlab vector maps into GRASS.

NOTES

This module only imports data into vector lines.

The user 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 simply a series of "x y" data points. Lines are separated by a row containing NaN NaN. Output from Matlab with this command:

    save filename.txt arrayname -ASCII

The user can import 3D lines from Matlab by exporting a 3 column array and using the -z flag.

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: Friday Feb 07 19:16:09 2025 in commit a82a39f