README.md
changeset 12 1d6e37b3ebf2
parent 11 35951602f83e
child 13 b6ccd1aab66f
equal deleted inserted replaced
11:35951602f83e 12:1d6e37b3ebf2
     1 # gpx_reduce_light
     1 # gpx_reduce_light
     2 
     2 
     3 * gpx_reduce.py is a version of the [original gpx_reduce][1] with no dependencies.
     3 * gpx_reduce.py is a modified version of the [original gpx_reduce][1] with no dependencies.
     4 
     4 
     5     The [original version][1] depends on scipy, lxml, numpy and pylab.
     5     The original depends on *scipy, lxml, numpy* and *pylab* (which are heavy requirements).
     6     Because the program only does some basic linear algebra, all these dependencies can be easily removed.
     6     However, these dependencies can be easily removed, because the program only does basic linear
       
     7     algebra.
     7     This has two benefits:
     8     This has two benefits:
     8 
     9 
     9     1. easy installation (nothing needed apart from python)
    10     1. easy installation (nothing needed apart from python)
    10     2. the program is considerably faster than the original.  
    11     2. the program is considerably faster than the original.
    11         This is because the original uses a numpy array for each trackpoint which
    12     
    12         incurs a large overhead for creating and for all subsequent little computations.
    13     A stand alone windows executable (win32, 3 Mb) can be downloaded from <https://wim.vree.org/sporen/gpx.html>
    13 
    14 
    14     The one disadvantage of removing all depecencies is that the plot option had to be removed.  
    15     Usage example (see [original][1] for a better description):
    15     Usage example:
       
    16 
    16 
    17         > gpx_reduce.py -d 2 -t 30 your_track.gpx
    17         > gpx_reduce.py -d 2 -t 30 your_track.gpx
    18 
    18 
       
    19     The disadvantage of removing all dependencies is that the plot option had to be removed.  
    19     I made a separate python script with one dependency for plotting tracks:
    20     I made a separate python script with one dependency for plotting tracks:
    20 
    21 
    21 * gpx_plot.py, a script to plot one or more tracks with "gnuplot".
    22 * gpx_plot.py, a script to plot one or more tracks with [gnuplot][3].
    22 
    23 
    23     Gnuplot has to be installed and the path to the binary has to be changed in the code
    24     Gnuplot has to be installed and if the path to the gnuplot executable is not */usr/bin/gnuplot*
    24     to reflect your installation:
    25     you have to specify the path with the command line option *-g /path/to/gnuplot*
    25 
       
    26         gnuPlotCmd = 'path/to/gnuplot'
       
    27 
    26 
    28     Usage example that compares a reduced track with the original:
    27     Usage example that compares a reduced track with the original:
    29 
    28 
    30         > gpx_plot.py your_track.gpx your_track_reduced.gpx
    29         > gpx_plot.py your_track.gpx your_track_reduced.gpx
       
    30     
       
    31     and with the -g option:
       
    32 
       
    33         > gpx_plot.py -g /path/to/gnuplot your_track.gpx your_track_reduced.gpx
       
    34     
       
    35     A stand alone windows executable (win32, 3 Mb) can be downloaded from <https://wim.vree.org/sporen/gpx.html>
       
    36     (does not include [gnuplot][3])
    31 
    37 
    32 [1]: https://github.com/Alezy80/gpx_reduce/
    38 [1]: https://github.com/Alezy80/gpx_reduce/
       
    39 [3]: https://sourceforge.net/projects/gnuplot/files/gnuplot/