2019-09-08 16:42:10 +00:00
|
|
|
GEOSTAT
|
|
|
|
|
=======
|
|
|
|
|
|
|
|
|
|
Tools for computing various statistics related to Geocaching/Opencaching
|
|
|
|
|
------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
### Usage
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Usage: [-p] [-g file] [-MDHh]
|
|
|
|
|
Generate stats from Opencaching data or GPX files.
|
|
|
|
|
|
|
|
|
|
* Data source:
|
|
|
|
|
-p use Opencaching.pl
|
|
|
|
|
-u user user for Opencaching
|
|
|
|
|
-g file use specified gpx file
|
|
|
|
|
* Output:
|
|
|
|
|
-M print geographically extreme caches
|
|
|
|
|
-D print furthest and closest caches
|
|
|
|
|
-H file render a heat map to a file
|
|
|
|
|
-s n stamp size for a heat map (default = 15)
|
2019-09-12 12:56:46 +00:00
|
|
|
-e n use exponential to flatten the heat map
|
|
|
|
|
-m map chosen map: Poland, Poland_relief, Europe (default = Poland)
|
2019-09-08 16:42:10 +00:00
|
|
|
-L print all caches
|
|
|
|
|
-T print D/T matrix
|
2019-09-12 12:56:46 +00:00
|
|
|
-O print owner count for found caches
|
|
|
|
|
-Y print types count for found caches
|
2019-09-08 16:42:10 +00:00
|
|
|
-h display this help screen
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Installation
|
|
|
|
|
|
|
|
|
|
To compile it requires:
|
|
|
|
|
|
|
|
|
|
* C++20 compliler (e.g. GCC-9 or Clang-8).
|
|
|
|
|
* meson (at least 0.47.0) + ninja build system
|
2019-09-09 10:34:18 +00:00
|
|
|
* libcurl: https://curl.haxx.se/libcurl/
|
2019-09-08 16:42:10 +00:00
|
|
|
* JSON for Modern C++: https://github.com/nlohmann/json
|
|
|
|
|
* gpxlib: http://irdvo.nl/gpxlib/
|
2019-09-09 10:34:18 +00:00
|
|
|
* heatmap: https://github.com/lucasb-eyer/heatmap
|
2019-09-08 16:42:10 +00:00
|
|
|
* ImageMagick or GraphicsMagick Magick++ library
|
|
|
|
|
|
2019-09-09 10:34:18 +00:00
|
|
|
To build the project copy `config_user_example.h` to `config_user.h` and fill it out (at least API key is needed). Then
|
|
|
|
|
run `meson build; cd build; ninja`. You might need to set `CXX` variable to point to a correct compiler.
|
2019-09-08 16:42:10 +00:00
|
|
|
|
|
|
|
|
### Credits
|
|
|
|
|
|
2019-09-08 20:18:13 +00:00
|
|
|
Map of Poland `Poland.png` comes from `https://pl.wikipedia.org/wiki/Plik:Poland_location_map.svg` and is licensed under CC-BY-SA and GNU FDL.
|
|
|
|
|
Map of Poland `Poland_relief.png` comes from `https://commons.wikimedia.org/wiki/File:Relief_Map_of_Poland.svg` and is licensed under CC-BY-SA.
|
|
|
|
|
Map of Europe `Europe.png` comes from `https://pl.wikipedia.org/wiki/Plik:Europe_location_map.svg` and is licensed under PD.
|
2019-09-15 11:45:25 +00:00
|
|
|
Map of Voivodeships of Poland come from `https://commons.wikimedia.org/wiki/File:Podlaskie_Voivodeship_location_map.svg`, `https://commons.wikimedia.org/wiki/File:Pomeranian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Kuyavian-Pomeranian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Warmian-Masurian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Masovian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Lesser_Poland_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Greater_Poland_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Opole_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Lower_Silesian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Silesian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Lublin_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Subcarpathian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:West_Pomeranian_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:%C5%9Awi%C4%99tokrzyskie_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:Lubusz_Voivodeship_location_map.svg`, `https://pl.wikipedia.org/wiki/Plik:%C5%81%C3%B3d%C5%BA_Voivodeship_location_map.svg`
|
2019-09-15 11:33:27 +00:00
|
|
|
and are licensed under CC-BY-SA.
|
