Geografic-Information-System/scripts/v.out.gps/v.out.gps.html

<h2>DESCRIPTION</h2>

<em>v.out.gps</em> allows the user to export waypoint, route, and track
data from a vector map into a locally connected GPS receiver or as a file in
many common GPS data formats. Translation is done via the 
<em><a href="http://www.gpsbabel.org">GPSBabel</a></em> program. 

<p>Do not use as a primary means of navigation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License (GPL) for more details.

<h2>NOTES</h2>

<em>v.out.gps</em> automatically reprojects data from the 
projection settings of the current location to Lat/Lon WGS84.
<p>GPX format is used for data interchange between GRASS and GpsBabel.
If the requested output is GPX, then <tt>gpsbabel</tt> is never run.
<p>OGR's GPX driver knows a number of standard field names. If an attribute
column matches the name it will be used in that field. Otherwise the
attribute will be placed within the <tt>&lt;extensions&gt;</tt> metadata
section of the record. Not all fields names are used with all feature
types (e.g. DOP fix error is not meaningful for route lines). You can
use the <em>v.db.renamecolumn</em> module to rename columns.
<p>These are the standard GPX data fields known to OGR:
<div class="code"><pre>
ageofdgpsdata
cmt:	 Comment
course
desc
dgpsid:	 DGPS station type
ele:	 Elevation
fix
geoidheight
hdop:	 Horizontal dillution of precision (estimated fix error)
magvar:	 Magnetic variation
name
number
pdop:	 Positional dillution of precision (estimated fix error)
route_fid
route_point_id
sat
speed
src
sym
time
track_fid
track_seg_id
track_seg_point_id
type
url
urlname
vdop:	 Vertical dillution of precision (estimated fix error)
</pre></div>


<h2>EXAMPLES</h2>

<h3>GPX Export</h3>

Export a vector lines map to a GPX track file:
<div class="code"><pre>
v.out.gps -t input=trail output=trail.gpx
</pre></div>


<h3>GPS device connected via USB adapter</h3>

Export vector maps named <i>waypoints, tracks, routes</i> to a Garmin GPS
connected to /dev/ttyUSB0:
<div class="code"><pre>
v.out.gps -w input=waypoints format=garmin output=/dev/ttyUSB0
v.out.gps -t input=tracks format=garmin output=/dev/ttyUSB0
v.out.gps -r input=routes format=garmin output=/dev/ttyUSB0
</pre></div>


<h2>SEE ALSO</h2>
<em>
<a href="m.proj.html">m.proj</a><br>
<a href="v.in.ascii.html">v.in.ascii</a><br>
<a href="v.out.ascii.html">v.out.ascii</a><br>
<a href="v.in.garmin.html">v.in.garmin</a><br>
<a href="v.in.gpsbabel.html">v.in.gpsbabel</a><br>
<a href="v.db.renamecolumn.html">v.db.renamecolumn</a><br>
<a href="v.extract.html">v.extract</a>
</em>
<br>
<br>

<a href="http://www.gpsbabel.org">GpsBabel.org</a><br>
The <a href="http://www.gdal.org/ogr/drv_gpx.html">GDAL/OGR GPX format page</a><br>
cs2cs from <a href="http://proj.osgeo.org">PROJ.4</a><br>


<h2>AUTHOR</h2>
Hamish Bowman, Dunedin New Zealand

<p><i>Last changed: $Date$</i>