.TH v.out.gpsbabel 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.out.gpsbabel\fR\fR  - Exports a vector map to a GPS receiver or file format supported by GpsBabel.
.SH KEYWORDS
vector, export, GPS
.SH SYNOPSIS
\fBv.out.gpsbabel\fR
.br
\fBv.out.gpsbabel help\fR
.br
\fBv.out.gpsbabel\fR [\-\fBwrt\fR] \fBinput\fR=\fIstring\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]  \fBoutput\fR=\fIname\fR  [\fBformat\fR=\fIstring\fR]   [\fBlayer\fR=\fIinteger\fR]   [\fBwhere\fR=\fIstring\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-w\fR" 4m
.br
Export as waypoints
.IP "\fB\-r\fR" 4m
.br
Export as routes
.IP "\fB\-t\fR" 4m
.br
Export as tracks
.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
Name of input vector map
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Feature type(s)
.br
Options: \fIpoint,centroid,line,boundary\fR
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output file or GPS device
.IP "\fBformat\fR=\fIstring\fR" 4m
.br
GpsBabel supported output format
.br
Default: \fIgpx\fR
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
A single vector map can be connected to multiple database tables. This number determines which table to use.
.br
Default: \fI1\fR
.IP "\fBwhere\fR=\fIstring\fR" 4m
.br
WHERE conditions of SQL statement without 'where' keyword
.br
Example: income = 10000
.PP
.SH DESCRIPTION
\fIv.out.gpsbabel\fR 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 
\fIGpsBabel\fR program. 
.PP
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.
.SH NOTES
\fIv.out.gpsbabel\fR automatically reprojects data from the 
projection settings of the current location to Lat/Lon WGS84.
.PP
GPX format is used for data interchange between GRASS and GpsBabel.
If the requested output is GPX, then gpsbabel is never run.
.PP
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  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 \fIv.db.renamecol\fR module to rename columns.
.PP
These are the standard GPX data fields known to OGR:
\fC
.DS
.br
ageofdgpsdata
.br
cmt:	 Comment
.br
course
.br
desc
.br
dgpsid:	 DGPS station type
.br
ele:	 Elevation
.br
fix
.br
geoidheight
.br
hdop:	 Horizontal dillution of precision (estimated fix error)
.br
magvar:	 Magnetic variation
.br
name
.br
number
.br
pdop:	 Positional dillution of precision (estimated fix error)
.br
route_fid
.br
route_point_id
.br
sat
.br
speed
.br
src
.br
sym
.br
time
.br
track_fid
.br
track_seg_id
.br
track_seg_point_id
.br
type
.br
url
.br
urlname
.br
vdop:	 Vertical dillution of precision (estimated fix error)
.br
.DE
\fR
.SH EXAMPLES
.SS GPX Export
Export a vector lines map to a GPX track file:
\fC
.DS
.br
v.out.gpsbabel \-t input=trail output=trail.gpx
.br
.DE
\fR
.SS GPS device connected via USB adapter
Export vector maps named \fIwaypoints, tracks, routes\fR to a Garmin GPS
connected to /dev/ttyUSB0:
\fC
.DS
.br
v.out.gpsbabel \-w input=waypoints format=garmin output=/dev/ttyUSB0
.br
v.out.gpsbabel \-t input=tracks format=garmin output=/dev/ttyUSB0
.br
v.out.gpsbabel \-r input=routes format=garmin output=/dev/ttyUSB0
.br
.DE
\fR
.SH SEE ALSO
\fI
m.proj
.br
v.in.ascii
.br
v.out.ascii
.br
v.in.garmin
.br
v.in.gpsbabel
.br
v.db.renamecol
.br
v.extract
\fR
.br
.br
GpsBabel.org
.br
The GDAL/OGR GPX format page
.br
cs2cs from PROJ.4
.br
.SH AUTHOR
Hamish Bowman, Dunedin New Zealand
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team