README.md
author wim
Sun, 03 Sep 2017 11:40:00 +0200
changeset 13 b6ccd1aab66f
parent 12 1d6e37b3ebf2
child 14 f440529b9606
permissions -rw-r--r--
license van LGPL naar GPL betere detectie van gnuplot executable
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
8
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
     1
# gpx_reduce_light
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
     2
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
     3
* gpx_reduce.py is a modified version of the [original gpx_reduce][1] with no dependencies.
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
     4
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
     5
    The original depends on *scipy, lxml, numpy* and *pylab* (which are heavy requirements).
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
     6
    However, these dependencies can be easily removed, because the program only does basic linear
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
     7
    algebra.
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
     8
    This has two benefits:
8
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
     9
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    10
    1. easy installation (nothing needed apart from python)
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    11
    2. the program is considerably faster than the original.
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    12
    
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    13
    A stand alone windows executable (win32, 3 Mb) can be downloaded from <https://wim.vree.org/sporen/gpx.html>
10
89108adbc468 gpx_plot: numpy verijderd uit gpx_plot
wim
parents: 8
diff changeset
    14
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    15
    Usage example (see [original][1] for a better description):
8
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
    16
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    17
        > gpx_reduce.py -d 2 -t 30 your_track.gpx
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    18
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    19
    The disadvantage of removing all dependencies is that the plot option had to be removed.  
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    20
    I made a separate python script with one dependency for plotting tracks:
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    21
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    22
* gpx_plot.py, a script to plot one or more tracks with [gnuplot][3].
8
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
    23
13
b6ccd1aab66f license van LGPL naar GPL
wim
parents: 12
diff changeset
    24
    Gnuplot has to be installed and if the executable "gnuplot" is not in your path
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    25
    you have to specify the path with the command line option *-g /path/to/gnuplot*
8
682ad5b9aa95 readme en licence toegevoegd
wim
parents:
diff changeset
    26
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    27
    Usage example that compares a reduced track with the original:
10
89108adbc468 gpx_plot: numpy verijderd uit gpx_plot
wim
parents: 8
diff changeset
    28
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    29
        > gpx_plot.py your_track.gpx your_track_reduced.gpx
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    30
    
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    31
    and with the -g option:
11
35951602f83e readme verder uitgebreid
wim
parents: 10
diff changeset
    32
12
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    33
        > gpx_plot.py -g /path/to/gnuplot your_track.gpx your_track_reduced.gpx
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    34
    
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    35
    A stand alone windows executable (win32, 3 Mb) can be downloaded from <https://wim.vree.org/sporen/gpx.html>
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    36
    (does not include [gnuplot][3])
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    37
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    38
[1]: https://github.com/Alezy80/gpx_reduce/
1d6e37b3ebf2 add -g option and some input sanity checks
wim
parents: 11
diff changeset
    39
[3]: https://sourceforge.net/projects/gnuplot/files/gnuplot/