GPSCORRELATE(1) | [FIXME: manual] | GPSCORRELATE(1) |
gpscorrelate - correlates digital images with GPS data filling EXIF fields
gpscorrelate [-z | --timeadd +/-HH[:MM]] [-O | --photooffset seconds] [-i | --no-interpolation] [-v | --verbose] [-d | --datum datum] [-n | --no-write] [-F | --force] [-m | --max-dist time] [-t | --ignore-tracksegs] [-M | --no-mtime] [-f | --fix-timestamps] [-p | --degmins] -g file.gpx image.jpg...
gpscorrelate -s | --show | -o | --machine image.jpg...
gpscorrelate [-M | --no-mtime] {-r | --remove} image.jpg...
gpscorrelate -V | --version | -h | --help
gpscorrelate-gui
This manual page documents briefly the gpscorrelate and gpscorrelate-gui commands.
There is an extended documentation available in HTML format; see below.
gpscorrelate is a program that acts on digital images in JPEG format filling EXIF (Exchangeable Image File Format) fields related to GPS (Global Positioning System) information. Source for the GPS data is a record of GPS information encoded in GPX (GPS Exchange Format) Format. The act of filling those fields is referred to as correlation.
If GPS data are available at the precise moment the image was taken (with a 1-second granularity) the GPS data are stored unmodified in EXIF fields. If they are not linear interpolation of GPS data available at moments before and after the image was taken can be used.
gpscorrelate is a command line tool implementing correlation whereas gpscorrelate-gui is the corresponding GTK+ graphical user interface.
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the HTML documentation.
-g, --gps file.gpx
-s, --show
-o, --machine
-r, --remove
-z, --timeadd +/-XX[:XX]
-O, --photooffset seconds
-i, --no-interpolation
-v, --verbose
-d, --datum datum
-n, --no-write
-F, --force
-m, --max-dist time
-t, --ignore-tracksegs
-M, --no-mtime
-f, --fix-timestamps
-p, --degmins
-h, --help
-V, --version
gpsd (1), gpsbabel (1), gpxlogger (1), cgpxlogger (1).
The documentation of gpscorrelate and gpscorrelate-gui in HTML format are available on the filesystem at /usr/share/doc/gpscorrelate.
This manual page was initially written by Stefano Zacchiroli <zack@debian.org> for the Debian(TM) system. It was extended by Till Maas <opensource@till.name>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
Stefano Zacchiroli
Copyright © 2006, 2008 Stefano Zacchiroli <zack@debian.org>, Till Maas
30 Oct 2008 | [FIXME: source] |