1GPSCORRELATE(1)                 [FIXME: manual]                GPSCORRELATE(1)
2
3
4

NAME

6       gpscorrelate - correlates digital images with GPS data filling EXIF
7       fields
8

SYNOPSIS

10       gpscorrelate [-z | --timeadd +/-HH[:MM]] [-O | --photooffset seconds]
11                    [-i | --no-interpolation] [-v | --verbose] [-d |
12                    --datum datum] [-n | --no-write] [-m | --max-dist time]
13                    [-t | --ignore-tracksegs] [-M | --no-mtime] [-f |
14                    --fix-timestamps] [-p | --degmins] -g file.gpx
15                    image.jpg...
16
17       gpscorrelate -s | --show | -o | --machine  image.jpg...
18
19       gpscorrelate [-M | --no-mtime] {-r | --remove} image.jpg...
20
21       gpscorrelate -V | --version | -h | --help
22
23       gpscorrelate-gui
24

DESCRIPTION

26       This manual page documents briefly the gpscorrelate and
27       gpscorrelate-gui commands.
28
29       There is an extended documenation available in HTML format; see below.
30
31       gpscorrelate is a program that acts on digital images in JPEG format
32       filling EXIF (Exchangeable Image File Format) fields related to GPS
33       (Global Positioning System) information. Source for the GPS data is a
34       record of GPS information encoded in GPX (GPS Exchange Format) Format.
35       The act of filling those fields is referred to as correlation.
36
37       If GPS data are available at the precise moment the image was taken
38       (with a 1-second granularity) the GPS data are stored unmodified in
39       EXIF fields. If they are not linear interpolation of GPS data available
40       at moments before and after the image was taken can be used.
41
42       gpscorrelate is a command line tool implementing correlation whereas
43       gpscorrelate-gui is the corresponding GTK+ graphical user interface.
44

OPTIONS

46       These programs follow the usual GNU command line syntax, with long
47       options starting with two dashes (`-'). A summary of options is
48       included below. For a complete description, see the HTML documentation.
49
50       -g, --gps file.gpx
51           correlate using the specified GPX file with GPS data
52
53       -s, --show
54           only show the GPS data of the given images
55
56       -o, --machine
57           only show the GPS data of the given images in a machine readable
58           output, if there is any
59
60       -r, --remove
61           only remove GPS EXIF data from the given images
62
63       -z, --timeadd +/-XX[:XX]
64           time to add to GPS data to make it match the timestamps of the
65           images. GPS data is in UTC; images are not likely to be in UTC.
66           Enter the timezone used when taking the images: eg, +8 for Perth
67
68       -O, --photooffset seconds
69           time in seconds to add to the photo timestamp to make it match the
70           GPS timestamp. To determine the amount of seconds needed, just
71           create a picture of your GPS device showing the current time and
72           compare it with the timestamp of your photo file.
73
74       -i, --no-interpolation
75           disable interpolation between points. Interpolation is linear,
76           points are rounded if disabled
77
78       -v, --verbose
79           show which GPS data has been selected for each image
80
81       -d, --datum datum
82           specify measurement datum. If not set, WGS-84 used
83
84       -n, --no-write
85           do not write the exif data. Useful with --verbose
86
87       -m, --max-dist time
88           max time outside points that image will be matched. Time is in
89           seconds
90
91       -t, --ignore-tracksegs
92           Interpolate between track segments, too
93
94       -M, --no-mtime
95           Do not change mtime of modified files
96
97       -f, --fix-timestamps
98           Fix broken GPS datestamps written with versions < 1.5.2
99
100       -p, --degmins
101           Write location as DD MM.MM as was default before < 1.5.3
102
103       -h, --help
104           Only show summary of options
105
106       -V, --version
107           Only print the version
108

SEE ALSO

110       gpsd (1), gpsbabel (1), gpxlogger (1), cgpxlogger (1).
111
112       The documentation of gpscorrelate and gpscorrelate-gui in HTML format
113       are available on the filesystem at /usr/share/doc/gpscorrelate.
114

AUTHOR

116       This manual page was initially written by Stefano Zacchiroli
117       <zack@debian.org> for the Debian(TM) system. It was extended by Till
118       Maas <opensource@till.name>. Permission is granted to copy, distribute
119       and/or modify this document under the terms of the GNU General Public
120       License, Version 2 any later version published by the Free Software
121       Foundation.
122
123       On Debian systems, the complete text of the GNU General Public License
124       can be found in /usr/share/common-licenses/GPL.
125

AUTHOR

127       Stefano Zacchiroli
128           Author.
129

131       Copyright © 2006, 2008 Stefano Zacchiroli <zack@debian.org>, Till Maas
132
133
134
135[FIXME: source]                   30 Oct 2008                  GPSCORRELATE(1)
Impressum