Geografic-Information-System/scripts/v.in.gpsbabel/v.in.gpsbabel.html

<H2>DESCRIPTION</H2>

<EM>v.in.gpsbabel</EM> allows the user to import waypoint, route, and track
data from a locally connected GPS receiver or a text file containing 
GPS data of many common formats. Translation is done via the 
<EM><A HREF="http://www.gpsbabel.org">gpsbabel</a></EM> program. 

<P>
This software is not intended as a primary means of navigation.

<H2>NOTES</H2>

<em>v.in.gpsbabel</em> automatically reprojects data using the 
projection settings of the current location.

The default input data projection is lat/lon WGS84. If your GPS outputs data
using another projection or map datum, you may include the 
<EM><A HREF="http://proj.maptools.org">PROJ.4</a></EM>
parameters defining your projection in the <b>proj</b> option and 
<em>v.in.gpsbabel</em> will reproject your data accordingly.
Great care must be taken to get these parameters correct!

The automatic transform may be skipped by using the <b>-k</b> flag in which 
case the data will be imported unprojected, as it appears in the <b>input</b>.

<P>
Route and Track data may be uploaded as a series of points by using the <B>-p</B> 
flag, otherwise they will be imported as lines. You can run <EM>v.in.gpsbabel</EM>
multiple times and merge the line and point vectors with the <EM>v.patch</EM>
command if you want, but take care when merging dissimilar attribute tables.

<H2>EXAMPLES</H2>

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

Import waypoints, tracks, routes from /dev/ttyUSB0 and save
to a GRASS vector map:
<div class="code"><pre>
v.in.gpsbabel -w input=/dev/ttyUSB0 format=garmin output=waypoints
v.in.gpsbabel -t input=/dev/ttyUSB0 format=garmin output=tracks
v.in.gpsbabel -r input=/dev/ttyUSB0 format=garmin output=routes
</pre></div>

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

Import waypoint data from a Garmin GPS connected at /dev/ttyS0 and save
to a GRASS vector map named <i>waypoints</i>:
<div class="code"><pre>
v.in.gpsbabel -w input=/dev/ttyS0 format=garmin output=waypoints
</pre></div>

<h3>Import track data from a GPX</h3>

Import track data from a GPX text file and save to a GRASS vector map 
named <i>tracks</i>.
<!-- (currently buggy) The gpxlogger program distributed with 
<a href="http://gpsd.berlios.de/">GPSd</a> >2.30 is a good program for 
creating these logs. -->
<div class="code"><pre>
v.in.gpsbabel -t input=gpslog.gpx format=gpx output=tracks
</pre></div>

<h3>Import route data from GPS connected at /dev/gps</h3>

Import route data as a series of points from a Garmin GPS connected at 
/dev/gps and save to a GRASS vector map named <i>routePoints</i>:
<div class="code"><pre>
v.in.gpsbabel -r -p file=/dev/gps format=garmin output=routePoints
</pre></div>


<H2>SEE ALSO</H2>
<EM><A HREF="db.execute.html">db.execute</A></EM><BR>
<EM><A HREF="v.in.ascii.html">v.in.ascii</A></EM><BR>
<EM><A HREF="v.in.garmin.html">v.in.garmin</A></EM><BR>
<EM><A HREF="v.db.connect.html">v.db.connect</A></EM><BR>
<EM><A HREF="v.patch.html">v.patch</A></EM><BR>
<BR>

<A HREF="http://www.gpsbabel.org">gpsbabel</a> from gpsbabel.org<BR>
cs2cs from <A HREF="http://proj.maptools.org">PROJ.4</a><BR>

<P>
<H2>AUTHORS</H2>
Claudio Porta and Lucio Davide Spano, students of Computer Science at
University of Pisa (Italy).<br>
Commission from Faunalia Pontedera (PI)<br><br>
Based on <em>v.in.garmin</em> for GRASS 6.0 by Hamish Bowman<br>
and <em>v.in.garmin.sh</em> for GRASS 5 by Andreas Lange
<BR>

<!--
When we tested the script with a Garmin GPS we noticed that importing waypoints 
the <i>time</i> field is not correctly set. The data reported is 
a default system time, while with a gpx text file this thing did not 
happen. We believe that is a <i>gpsbabel</i> trouble in translating 
from <i>garmin</i> to <i>xcsv</i> ... 
-->

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