Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 92 lines (64 sloc) 3.804 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
4b6e903 Changes to README.md and cabal file
Rob Stewart authored
12 An example can be seen [HERE](http://www.macs.hw.ac.uk/~rs46/gps2htmlreport/3/index.html).
7a0cb30 inital commit
Rob Stewart authored
13
b3ca0b9 added link to haddock pages
Rob Stewart authored
14 The Haddock documentation pages can be found [here](http://www.macs.hw.ac.uk/~rs46/gps2htmlreport/doc/).
15
7a0cb30 inital commit
Rob Stewart authored
16 Installation
17 ------------
18 It is assumed that you have the Haskell Platform installed.
19
20 Just run these commands to configure and install the `gps2HtmlReport' utility, run these commands:
21
22 ```
23 cabal configure
24 cabal install
25 ```
26
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored
27 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 Linux package manager.
7a0cb30 inital commit
Rob Stewart authored
28
29 On an RPM-based package manager, run this command as root:
30
31 ```
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored
32 yum install GraphicsMagick cairo alex happy gtk2hs-buildtools
7a0cb30 inital commit
Rob Stewart authored
33 ```
34
35 Prerequisites
36 -------------
37 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.
38
39 Usage
40 -----
41 The program will search for all files ending in ".gpx", and for each one, generate a HTML report.
42
43 ```
44 $ cd $location_of_gpx_files
0514315 fixed typo
Rob Stewart authored
45 $ ls
46 1.gpx 2.gpx 3.gpx
7a0cb30 inital commit
Rob Stewart authored
47 $ gps2HtmlReport
48 Processing 3 file(s)...
49 Processing '1.gpx' complete. Report saved in: /home/foo/gps_tracks/1/index.html
50 Processing '2.gpx' complete. Report saved in: /home/foo/gps_tracks/2/index.html
51 Processing '3.gpx' complete. Report saved in: /home/foo/gps_tracks/3/index.html
52 ```
53
54 Notes
55 -----
56 This project requires testing!
57
58 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.
59
60 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?
61
62 Either way, get in touch!
63
bb77572 putting all modules in Data.GPS
Rob Stewart authored
64 To Do
65 -----
66
67 * This Haskell program currently makes use of elevation, latitude and longitude. There are many other attributes possibly available in WptType. Ideas for what to do with these attributes [here](http://hackage.haskell.org/packages/archive/GPX/0.4.8/doc/html/Data-Geo-GPX-WptType.html#t:WptType) most welcome.
bb3ddfa edits to README.md
Rob Stewart authored
68 * Properly attribute copyright of the OSM images to the OSM project as per their [copyright statement](http://wiki.openstreetmap.org/wiki/Legal_FAQ)
7a0cb30 inital commit
Rob Stewart authored
69
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored
70 Problems
71 -----
72
73 If you receive this error when trying to run the program:
74 ```
75 can't load .so/.DLL for: stdc++ (libstdc++.so: cannot open shared object file: No such file or directory)
76 ```
77
78 ... then you are experiencing this bug: [#5289](http://hackage.haskell.org/trac/ghc/ticket/5289).
79
80 To fix this
bb3ddfa edits to README.md
Rob Stewart authored
81
82 * Fedora 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib/
83 * Fedora 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib64/
84 * Ubuntu 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib/
85 * Ubuntu 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib64/
86
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored
87
7a0cb30 inital commit
Rob Stewart authored
88 Credits
89 -------
90 Thanks goes to the developers of the [gpx2png project](http://wiki.openstreetmap.org/wiki/Gpx2png), which is used to generate the OpenStreetMap image.
91
92 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.