Skip to content
Newer
Older
100644 103 lines (75 sloc) 3.12 KB
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
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
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
12 An example can be seen [here](http://www.macs.hw.ac.uk/~rs46/gps2htmlreport/3/index.html).
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
13
5316e59 slight change to README.md
Rob Stewart authored Sep 7, 2011
14 The hackage page is [here](http://hackage.haskell.org/package/gps2htmlReport).
b3ca0b9 added link to haddock pages
Rob Stewart authored Aug 8, 2011
15
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
16 Installation
17 ------------
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
18 A user first of all needs to install the Haskell Platform, and a few additional system packages - **GraphcsMagick** and **Cairo** . For
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
19 exmaple, on an RPM-based machine, as root:
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
20
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
21 ```
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
22 ># yum install haskell-platform GraphicsMagick cairo gtk2hs-buildtools
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
23 ```
24
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
25
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
26 The **recommended** way to install the gps2HtmlReport program, is to
27 grab it via hackage:
28
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
29 ```
30 cabal update
31 cabal install gps2htmlReport
32 ```
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
33
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
34 Or to install the version in the github repository:
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
35
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
36 ```
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
37 git clone git://github.com/robstewart57/Gps2HtmlReport.git
38 cd Gps2HtmlReport
39 cabal update
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
40 cabal configure
41 cabal install
42 ```
43
44 Prerequisites
45 -------------
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
46 First of all, you need to have your GPS date in a GPX file. There are
47 many gpx exporters available. I use my Android phone to take GPX
48 tracks, with a great application,
49 [OSMTracker](https://code.google.com/p/osmtracker-android/). This
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
50 application allows you to export your GPS tracks to GPX. I am sure that there are plenty of good applications for iOS to perform the same function. And I'm aware that GPS devices allow .gpx files to be extracted from GPS logs.
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
51
52 Usage
53 -----
54 The program will search for all files ending in ".gpx", and for each one, generate a HTML report.
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
55
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
56 ```
57 $ cd $location_of_gpx_files
0514315 fixed typo
Rob Stewart authored Aug 8, 2011
58 $ ls
6889125 additional edits to README.md
Rob Stewart authored Aug 31, 2011
59 1.gpx
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
60 $ gps2HtmlReport --help
61
62 gps2HtmlReport [OPTIONS]
63 A Haskell utility to generate HTML page reports of GPS Tracks and Track
64 overlays on OpenStreetMap tiles
65
66 Common flags:
67 -i --imageonly Generates only an image of the track overlay on an
68 OpenStreetMap layer
69 -a --archive Produce tar archive for web and image files
70 --hashnames Create reports in hashed directory names
71 -h --help Display help message
72 -v --version Print version information
73 -V --Verbose Loud verbosity
74 -q --quiet Quiet verbosity
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
75 ```
76
77
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored Aug 31, 2011
78 Problems
79 -----
80
81 If you receive this error when trying to run the program:
26a96f7 Update to README.md file.
robstewart57 authored Dec 25, 2011
82
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored Aug 31, 2011
83 ```
84 can't load .so/.DLL for: stdc++ (libstdc++.so: cannot open shared object file: No such file or directory)
85 ```
86
87 ... then you are experiencing this bug: [#5289](http://hackage.haskell.org/trac/ghc/ticket/5289).
88
89 To fix this
bb3ddfa edits to README.md
Rob Stewart authored Aug 31, 2011
90
91 * Fedora 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib/
92 * Fedora 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib64/
93 * Ubuntu 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib/
94 * Ubuntu 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib64/
95
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
96 If you experience other problems, please let me know - and preferrably
97 sending me the problematic .gpx file.
7ae44be Removed dependency on perl, replaced with Haskell module using GD bin…
Rob Stewart authored Aug 31, 2011
98
7a0cb30 inital commit
Rob Stewart authored Aug 8, 2011
99 Credits
100 -------
101
f563dcf Added two addition flags, for hashing directory names and creating ta…
Rob Stewart authored Dec 25, 2011
102 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.