v.out.gps - GRASS GIS manual

NAME

v.out.gps - Exports a vector map to a GPS receiver or file format supported by GPSBabel.

KEYWORDS

SYNOPSIS

v.out.gps

v.out.gps --help

v.out.gps [-wrt] input=name [type=string[,string,...]] output=name [format=string] [layer=string] [where=sql_query] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-w: Export as waypoints
-r: Export as routes
-t: Export as tracks
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

input=name [required]: Name of input vector map; Or data source for direct OGR access
type=string[,string,...]: Input feature type; Options: point, centroid, line, boundary; Default: point,centroid,line,boundary
output=name [required]: Name for output file or GPS device
format=string: GPSBabel supported output format; Default: gpx
layer=string: Layer number or name; Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.; Default: 1
where=sql_query: WHERE conditions of SQL statement without 'where' keyword; Example: income < 1000 and population >= 10000

DESCRIPTION
NOTES
EXAMPLES
- GPX Export
- GPS device connected via USB adapter
SEE ALSO
AUTHOR

DESCRIPTION

v.out.gps 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 GPSBabel program.

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.

NOTES

v.out.gps automatically reprojects data from the projection settings of the current location to Lat/Lon WGS84.

GPX format is used for data interchange between GRASS and GpsBabel. If the requested output is GPX, then gpsbabel is never run.

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 <extensions> 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 v.db.renamecolumn module to rename columns.

These are the standard GPX data fields known to OGR:

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)

EXAMPLES

GPX Export

Export a vector lines map to a GPX track file:

v.out.gps -t input=trail output=trail.gpx

GPS device connected via USB adapter

Export vector maps named waypoints, tracks, routes to a Garmin GPS connected to /dev/ttyUSB0:

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

AUTHOR

Hamish Bowman, Dunedin New Zealand

SOURCE CODE

Available at: v.out.gps source code (history)