Skip to content

Commit 4b3cda2

Browse files
committed
Add a paragraph to the man page about gaps in GPS coverage
1 parent 7896795 commit 4b3cda2

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

doc/gpscorrelate-manpage.xml.in

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -276,6 +276,23 @@
276276
occurs.
277277
</para>
278278

279+
<para>
280+
GPX files often contain gaps in location coverage. Line of sight to the
281+
GPS satellites can be lost if the receiver goes into a tunnel or a
282+
dense forest, for example, and track recording will stop until the
283+
connection can be reestablished. Some track recorders will stop recording
284+
points if the receiver stops moving. This results in points in the GPX
285+
file with timestamps far apart from each rather, rather than only the
286+
normal one second apart (or another short interval). The interpolation
287+
that <command>gpscorrelate</command> performs by default assumes a smooth
288+
movement between the two known points on either side, but if those
289+
two points are minutes or hours apart (or even longer!) the
290+
interpolated position is unlikely to make sense. To avoid ending up
291+
with a bad location for an image, the <userinput>--max-dist</userinput>
292+
option can be used to skip correlating photos that were taken within a
293+
large gap in coverage.
294+
</para>
295+
279296
</refsect1>
280297
<refsect1>
281298
<title>OPTIONS</title>

0 commit comments

Comments
 (0)