Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 66 lines (46 sloc) 2.568 kB
7a0cb30 inital commit
Rob Stewart authored
1 GPS 2 HTML Report
2 ================
3
4 This is a utility written in Haskell, to generate HTML reports from GPS track files.
5
6 Included in the report:
7
8 * Details of the journey... journey time, distance travelled etc..
9 * Diagrams charting speed, elevation, accumulated distance etc..
10 * OpenStreetMap diagram highlighting the GPS track
11
12 A few examples can be seen [HERE](http://www.macs.hw.ac.uk/~rs46/gps2htmlreport/).
13
14 Installation
15 ------------
16 It is assumed that you have the Haskell Platform installed.
17
18 Just run these commands to configure and install the `gps2HtmlReport' utility, run these commands:
19
20 ```
21 cabal configure
22 cabal install
23 ```
24
25 This Haskell program also makes use of the bindings to **GraphcsMagick** and **Cairo**, and so the necessary system packages need to be installed, via a *nix package manager.
26
27 On an RPM-based package manager, run this command as root:
28
29 ```
30 yum install GraphicsMagick cairo
31 ```
32
33 Prerequisites
34 -------------
35 First of all, you need to have your GPS date in a GPX file. There are many gpx exporters available. I use my Android phone to take GPX tracks, with a great application, [OSMTracker](https://code.google.com/p/osmtracker-android/). This application allows you to export your GPS tracks to GPX.
36
37 Usage
38 -----
39 The program will search for all files ending in ".gpx", and for each one, generate a HTML report.
40
41 ```
42 $ cd $location_of_gpx_files
43 $ 1.gpx 2.gpx 3.gpx
44 $ gps2HtmlReport
45 Processing 3 file(s)...
46 Processing '1.gpx' complete. Report saved in: /home/foo/gps_tracks/1/index.html
47 Processing '2.gpx' complete. Report saved in: /home/foo/gps_tracks/2/index.html
48 Processing '3.gpx' complete. Report saved in: /home/foo/gps_tracks/3/index.html
49 ```
50
51 Notes
52 -----
53 This project requires testing!
54
55 If you are able to use the utility to generate HTML reports, then I'd like to hear suggestions for improvements. If you are **unable** to run it, then I **really** want to hear from you. What the problem is; How far did you get; or better still, send me the .gpx file.
56
57 I'd also like to know what is required to make this utility work on non-Linux systems. This has been tested on a Fedora Linux machine. Does it work on Mac OSX? Windows? What needs doing to run it on other Linux distro's?
58
59 Either way, get in touch!
60
61
62 Credits
63 -------
64 Thanks goes to the developers of the [gpx2png project](http://wiki.openstreetmap.org/wiki/Gpx2png), which is used to generate the OpenStreetMap image.
65
66 In addition, thanks to [Thomas DuBuisson](http://www.haskellers.com/user/TomMD), for implementing the `gps' package and contributing it to Hackage.
Something went wrong with that request. Please try again.