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-24 12:47:49 +00:00
-e use exponential to flatten the heat map
2019-09-24 12:52:10 +00:00
-m map chosen map: Poland, Poland_relief, Poland_big, Europe or a name of voivodeship (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-24 12:52:10 +00:00
Maps of Poland `Poland.png` and `Poland_big.png` come from `https://pl.wikipedia.org/wiki/Plik:Poland_location_map.svg` and are licensed under CC-BY-SA and GNU FDL.
2019-09-08 20:18:13 +00:00
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.
