'\" t
.\" Title: GPSCORRELATE
.\" Author: Stefano Zacchiroli
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 30 Oct 2008
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "GPSCORRELATE" "1" "30 Oct 2008" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gpscorrelate \- correlates digital images with GPS data filling EXIF fields
.SH "SYNOPSIS"
.HP \w'\fBgpscorrelate\fR\ 'u
\fBgpscorrelate\fR [\-z | \-\-timeadd\ +/\-\fIHH\fR[:\fIMM\fR]] [\-O | \-\-photooffset\ \fIseconds\fR] [\-i | \-\-no\-interpolation] [\-v | \-\-verbose] [\-d | \-\-datum\ \fIdatum\fR] [\-n | \-\-no\-write] [\-F | \-\-force] [\-m | \-\-max\-dist\ \fItime\fR] [\-t | \-\-ignore\-tracksegs] [\-M | \-\-no\-mtime] [\-f | \-\-fix\-timestamps] [\-p | \-\-degmins] \-g\ \fIfile\&.gpx\fR \fIimage\&.jpg\fR...
.HP \w'\fBgpscorrelate\fR\ 'u
\fBgpscorrelate\fR \-s | \-\-show | \-o | \-\-machine \fIimage\&.jpg\fR...
.HP \w'\fBgpscorrelate\fR\ 'u
\fBgpscorrelate\fR [\-M | \-\-no\-mtime] {\-r | \-\-remove} \fIimage\&.jpg\fR...
.HP \w'\fBgpscorrelate\fR\ 'u
\fBgpscorrelate\fR \-V | \-\-version | \-h | \-\-help
.HP \w'\fBgpscorrelate\-gui\fR\ 'u
\fBgpscorrelate\-gui\fR
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBgpscorrelate\fR
and
\fBgpscorrelate\-gui\fR
commands\&.
.PP
There is an extended documentation available in HTML format; see below\&.
.PP
\fBgpscorrelate\fR
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
\fIcorrelation\fR\&.
.PP
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\&.
.PP
\fBgpscorrelate\fR
is a command line tool implementing correlation whereas
\fBgpscorrelate\-gui\fR
is the corresponding GTK+ graphical user interface\&.
.SH "OPTIONS"
.PP
These programs follow the usual
GNU
command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, see the HTML documentation\&.
.PP
\fB\-g\fR, \fB\-\-gps\fR \fIfile\&.gpx\fR
.RS 4
correlate using the specified GPX file with GPS data
.RE
.PP
\fB\-s\fR, \fB\-\-show\fR
.RS 4
only show the GPS data of the given images
.RE
.PP
\fB\-o\fR, \fB\-\-machine\fR
.RS 4
only show the GPS data of the given images in a machine readable output, if there is any
.RE
.PP
\fB\-r\fR, \fB\-\-remove\fR
.RS 4
only remove GPS EXIF data from the given images
.RE
.PP
\fB\-z\fR, \fB\-\-timeadd\fR \fB+/\-\fR\fIXX\fR[\fB:\fR\fIXX\fR]
.RS 4
time to add to GPS data to make it match the timestamps of the images\&. GPS data is in UTC; images are not likely to be in UTC\&. Enter the timezone used when taking the images: eg,
\fB+8\fR
for Perth
.RE
.PP
\fB\-O\fR, \fB\-\-photooffset\fR \fIseconds\fR
.RS 4
time in seconds to add to the photo timestamp to make it match the GPS timestamp\&. To determine the amount of seconds needed, just create a picture of your GPS device showing the current time and compare it with the timestamp of your photo file\&.
.RE
.PP
\fB\-i\fR, \fB\-\-no\-interpolation\fR
.RS 4
disable interpolation between points\&. Interpolation is linear, points are rounded if disabled
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
show which GPS data has been selected for each image
.RE
.PP
\fB\-d\fR, \fB\-\-datum\fR \fIdatum\fR
.RS 4
specify measurement datum\&. If not set, WGS\-84 used
.RE
.PP
\fB\-n\fR, \fB\-\-no\-write\fR
.RS 4
do not write the exif data\&. Useful with
\fB\-\-verbose\fR
.RE
.PP
\fB\-F\fR, \fB\-\-force\fR
.RS 4
overwrite existing GPS tags
.RE
.PP
\fB\-m\fR, \fB\-\-max\-dist\fR \fItime\fR
.RS 4
max time outside points that image will be matched\&. Time is in seconds
.RE
.PP
\fB\-t\fR, \fB\-\-ignore\-tracksegs\fR
.RS 4
Interpolate between track segments, too
.RE
.PP
\fB\-M\fR, \fB\-\-no\-mtime\fR
.RS 4
Do not change mtime of modified files
.RE
.PP
\fB\-f\fR, \fB\-\-fix\-timestamps\fR
.RS 4
Fix broken GPS datestamps written with versions < 1\&.5\&.2
.RE
.PP
\fB\-p\fR, \fB\-\-degmins\fR
.RS 4
Write location as DD MM\&.MM as was default before < 1\&.5\&.3
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Only show summary of options
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
Only print the version
.RE
.SH "SEE ALSO"
.PP
gpsd (1), gpsbabel (1), gpxlogger (1), cgpxlogger (1)\&.
.PP
The documentation of gpscorrelate and gpscorrelate\-gui in HTML format are available on the filesystem at
/usr/share/doc/gpscorrelate\&.
.SH "AUTHOR"
.PP
This manual page was initially written by Stefano Zacchiroli
for the
Debian(TM)
system\&. It was extended by Till Maas
\&. 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\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL\&.
.SH "AUTHOR"
.PP
\fBStefano Zacchiroli\fR
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2006, 2008 Stefano Zacchiroli , Till Maas
.br