<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: v.in.mapgen</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>v.in.mapgen</b></em> - Import Mapgen or Matlab vector maps into GRASS.
<h2>KEYWORDS</h2>
vector, import
<h2>SYNOPSIS</h2>
<b>v.in.mapgen</b><br>
<b>v.in.mapgen help</b><br>
<b>v.in.mapgen</b> [-<b>fz</b>] <b>input</b>=<em>string</em> [<b>output</b>=<em>string</em>] [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-f</b></DT>
<DD>Input map is in Matlab format</DD>
<DT><b>-z</b></DT>
<DD>Create a 3D vector points map from 3 column Matlab data</DD>
<DT><b>--overwrite</b></DT>
<DD>Allow output files to overwrite existing files</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>input</b>=<em>string</em></DT>
<DD>Name of input file in Mapgen/Matlab format</DD>
<DT><b>output</b>=<em>string</em></DT>
<DD>Name for output vector map (omit for display to stdout)</DD>
</DL>
<H2>DESCRIPTION</H2>
<EM>v.in.mapgen</EM> allows the user to import Mapgen or Matlab vector maps
into GRASS.
<H2>NOTES</H2>
This module only imports data into vector lines.
<P>
You can get coastline data in Mapgen or Matlab format from NOAA's Coastline
Extractor at <a href="http://www.ngdc.noaa.gov/mgg/shorelines/shorelines.html">http://www.ngdc.noaa.gov/mgg/shorelines/shorelines.html</a>.
<P>
Matlab vector line maps are simply a series of "x y" data points. Lines
are separated by a row containing <tt>NaN NaN</tt>.
Output from Matlab with this command:
<BR>
<div class="code"><pre>
save filename.txt arrayname -ASCII
</pre></div>
<P>
You can import 3D lines from Matlab by exporting a 3 column array and
using the <B>-z</B> flag.
<H2>SEE ALSO</H2>
<EM><A HREF="v.in.ascii.html">v.in.ascii</A></EM><BR>
<BR>
<P>
<H2>AUTHORS</H2>
Based on <em>v.in.mapgen.sh</em> for GRASS 5.0 by Andreas Lange
<BR>Rewritten for GRASS 6 by Hamish Bowman
<BR>
<p>
<i>Last changed: $Date: 2007-10-08 10:24:47 +0200 (Mon, 08 Oct 2007) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="vector.html">vector index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
