NAME

s.in.garmin.sh - Import data from a Garmin GPS receiver into a GRASS sites file
(GRASS Script)

SYNOPSIS

s.in.garmin.sh
s.in.garmin.sh help
s.in.garmin.sh [-v] [-w] [-r] [-t] [-k] [sites=sitesfile] [port=/dev/gps]

DESCRIPTION

s.in.garmin.sh allows the user to import waypoint, route and track data from a locally connected Garmin GPS receiver via the gpstrans program by Carsten Tschach.

Use at your own risk. This software comes with absolutely no warranty.

Flags:

-v
verbose output (version info)
-w
upload Waypoints
-r
upload Routes
-t
upload Track
-k
do not attempt projection transform from WGS84

Parameters:

sites=sitesfile
name for new sites file (omit for display to stdout)
port=/dev/gps
port the Garmin receiver is connected to (Default: /dev/gps)

NOTES

If the GPS is set up to output WGS84 Lat/Lon, s.in.garmin.sh will attempt to automatically transform the positions to the current projection. In all other cases, no checks are performed for datum, projection and format of data. You must check for yourself that your receiver, gpstrans and GRASS use the same map datum and projection. The automatic transform may be skipped by using the -k flag.

If you wish to use latitude-longitude input, the user should setup gpstrans as follows before running s.in.garmin.sh:
$ gpstrans -s
datum: 100 (WGS84)
format: 2 - lat/lon ddd.ddddd

SEE ALSO

v.in.garmin.sh
m.proj2
gpstrans manual

AUTHOR

Andreas Lange, Andreas.Lange (at) Rhein-Main.de
Projection updates by Hamish Bowman, New Zealand

gpstrans was written by Carsten Tschach
gpstrans may be found at http://gpstrans.sourceforge.net

Last changed: $Date$