Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  GPSCORRELATE (1)


gpscorrelate - correlates digital photos with GPS data filling EXIF fields



gpscorrelate [-g file.gpx] [option...]


This manual page documents briefly the gpscorrelate and gpscorrelate-gui commands.

This manual page was written for the Debian(TM) distribution because the original programs do not have a manual page. Instead, they have documentation in HTML format; see below.

gpscorrelate is a program that acts on digital photo 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 photo 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 photo 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
  required, specifies GPX file with GPS data
-z, --timeadd +/-XX[:XX]
  time to add to GPS data to make it match photos. GPS data is in UTC; photos are not likely to be in UTC. Enter the timezone used when taking the photos: eg, +8 for Perth
-i, --no-interpolation
  disable interpolation between points. Interpolation is linear, points are rounded if disabled
-v, --verbose
  show what has been selected
-d, --datum datum
  specify measurement datum. If not set, WGS-84 used
-n, --no-write
  do not write the exif data. Useful with --show
-m, --max-dist time
  max time outside points that photo will be matched. Time is in seconds
-s, --show
  Just show the GPS data from the given files, if it exists
-o, --machine
  Just show the GPS data from the given files, machine readable output
-r, --remove
  Strip GPS tags from the given files, and then quit
-t, --ignore-tracksegs
  Interpolate between track segments too
-M, --no-mtime
  Do not change mtime of modified files
-h, --help
  Show summary of options.


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/local/share/doc/gpscorrelate/html/.


This manual page was written by Stefano Zacchiroli <> for the Debian(TM) system (but may be used by others). 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 Stefano Zacchiroli <>

Search for    or go to Top of page |  Section 1 |  Main Index

GPSCORRELATE (1) 08 Sep 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.