.TH v.in.gpsbabel 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.in.gpsbabel\fR\fR  - Import waypoints, routes, and tracks from a GPS receiver or GPS download file into a vector map.
.SH KEYWORDS
vector, import, GPS
.SH SYNOPSIS
\fBv.in.gpsbabel\fR
.br
\fBv.in.gpsbabel help\fR
.br
\fBv.in.gpsbabel\fR [\-\fBvwrtpk\fR]  [\fBinput\fR=\fIstring\fR]   [\fBoutput\fR=\fIstring\fR]   [\fBformat\fR=\fIstring\fR]   [\fBproj\fR=\fIstring\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-v\fR" 4m
.br
Verbose mode
.IP "\fB\-w\fR" 4m
.br
Import waypoints
.IP "\fB\-r\fR" 4m
.br
Import routes
.IP "\fB\-t\fR" 4m
.br
Import track
.IP "\fB\-p\fR" 4m
.br
Force vertices of track or route data as points
.IP "\fB\-k\fR" 4m
.br
Do not attempt projection transform from WGS84
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput\fR=\fIstring\fR" 4m
.br
Device or file used to import data
.br
Default: \fI/dev/gps\fR
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
Name for output vector map (omit for display to stdout)
.IP "\fBformat\fR=\fIstring\fR" 4m
.br
Format of GPS input data (use gpsbabel supported formats)
.br
Default: \fIgarmin\fR
.IP "\fBproj\fR=\fIstring\fR" 4m
.br
Projection of input data (PROJ.4 style), if not set Lat/Lon WGS84 is assumed
.PP
.SH DESCRIPTION
\fIv.in.gpsbabel\fR 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 
\fIGPSBabel\fR program. 
.PP
This software is not intended as a primary means of navigation.
.SH NOTES
\fIv.in.gpsbabel\fR 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 
\fIPROJ.4\fR
parameters defining your projection in the \fBproj\fR option and 
\fIv.in.gpsbabel\fR will reproject your data accordingly.
Great care must be taken to get these parameters correct!
The automatic transform may be skipped by using the \fB-k\fR flag in which 
case the data will be imported unprojected, as it appears in the \fBinput\fR.
.PP
Route and Track data may be uploaded as a series of points by using the \fB-p\fR 
flag, otherwise they will be imported as lines. You can run \fIv.in.gpsbabel\fR
multiple times and merge the line and point vectors with the \fIv.patch\fR
command if you want, but take care when merging dissimilar attribute tables.
.SH EXAMPLES
.SS GPS device connected via USB adapter
Import waypoints, tracks, routes from /dev/ttyUSB0 and save
to a GRASS vector map:
\fC
.DS
.br
v.in.gpsbabel \-w input=/dev/ttyUSB0 format=garmin output=waypoints
.br
v.in.gpsbabel \-t input=/dev/ttyUSB0 format=garmin output=tracks
.br
v.in.gpsbabel \-r input=/dev/ttyUSB0 format=garmin output=routes
.br
.DE
\fR
.SS GPS device connected via serial adapter
Import waypoint data from a Garmin GPS connected at /dev/ttyS0 and save
to a GRASS vector map named \fIwaypoints\fR:
\fC
.DS
.br
v.in.gpsbabel \-w input=/dev/ttyS0 format=garmin output=waypoints
.br
.DE
\fR
.SS Import track data from a GPX
Import track data from a GPX text file and save to a GRASS vector map 
named \fItracks\fR.
\fC
.DS
.br
v.in.gpsbabel \-t input=gpslog.gpx format=gpx output=tracks
.br
.DE
\fR
.SS Import route data from GPS connected at /dev/gps
Import route data as a series of points from a Garmin GPS connected at 
/dev/gps and save to a GRASS vector map named \fIroutePoints\fR:
\fC
.DS
.br
v.in.gpsbabel \-r \-p file=/dev/gps format=garmin output=routePoints
.br
.DE
\fR
.SH SEE ALSO
\fI
db.execute,
v.in.ascii,
v.in.garmin,
v.db.connect,
v.patch
\fR
gpsbabel from gpsbabel.org
.br
cs2cs from PROJ.4
.SH AUTHORS
Claudio Porta and Lucio Davide Spano, students of Computer Science at
University of Pisa (Italy).
.br
Commission from Faunalia Pontedera (PI)
.br
Based on \fIv.in.garmin\fR for GRASS 6.0 by Hamish Bowman
.br
and \fIv.in.garmin.sh\fR for GRASS 5 by Andreas Lange
.br
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team