Tools for computing various statistics related to Geocaching/Opencaching.
 
 
 
Go to file
Tomasz Golinski c1fc61d1cb CSS update for web interface 2020-01-25 13:21:01 +01:00
.clang-format
.gitignore
Dolnoslaskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Europe.png
Kujawsko-Pomorskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Lodzkie.png Really add all remaining voivodships 2019-09-15 13:45:37 +02:00
Lubelskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Lubuskie.png Really add all remaining voivodships 2019-09-15 13:45:37 +02:00
Malopolskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Mazowieckie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Opolskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Podkarpackie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Podlaskie.png
Poland.png
Poland_big.png Add bigger map of Poland 2019-09-24 14:52:10 +02:00
Poland_relief.png
Pomorskie.png
README.md Add world map 2020-01-25 12:37:00 +01:00
Slaskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Swietokrzyskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Warminsko-Mazurskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
Wielkopolskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
World.png Add world map 2020-01-25 12:37:00 +01:00
Zachodniopomorskie.png Add remaining voivodships 2019-09-15 13:33:27 +02:00
api.h Another run of clang-format 2019-11-04 21:44:08 +01:00
cache.cpp Some formatting and clang-format 2020-01-04 19:27:04 +01:00
cache.h Make more stats use only filtered list of caches in a consistent way 2020-01-25 11:40:56 +01:00
common.cpp Fix streak computation again 2020-01-25 12:51:11 +01:00
common.h Don't need to export helper function in common.h 2020-01-25 12:39:55 +01:00
config_user_example.h Try to support other OC servers 2020-01-02 00:37:28 +01:00
debug.cpp
debug.h
geo.css CSS update for web interface 2020-01-25 13:21:01 +01:00
geodb.cpp Update README.md and usage outputs 2019-11-18 16:06:20 +01:00
geostat.cpp Add world map 2020-01-25 12:37:00 +01:00
geostat_cli.cpp Add world map 2020-01-25 12:37:00 +01:00
gpx.cpp Silence unused variable/parameter warnings 2019-10-06 02:58:24 +02:00
gpx.h Add parent class Api to OCdb 2019-10-04 00:43:39 +02:00
heat.cpp Use reference instead of pointer in class Heat constructor, add an assert 2020-01-25 11:44:29 +01:00
heat.h Use reference instead of pointer in class Heat constructor, add an assert 2020-01-25 11:44:29 +01:00
maps.h Add world map 2020-01-25 12:37:00 +01:00
meson.build Add world map 2020-01-25 12:37:00 +01:00
ocdb.cpp Another run of clang-format 2019-11-04 21:44:08 +01:00
ocdb.h Another run of clang-format 2019-11-04 21:44:08 +01:00
okapi.cpp Some formatting and clang-format 2020-01-04 19:27:04 +01:00
okapi.h Include link to user profile in HTML output 2020-01-04 19:24:00 +01:00

README.md

GEOSTAT

Sample web interface

A sample web interface to play with the tool is available at http://tomaszg.pl/geo/.

Usage

The main tool is called geostat. It is able to access opencaching.pl via OKAPI or from local database dump maintained by geodb. It can also partially read GPX files, e.g. exported from c:geo. It produces various statistics (either as text output with geostat_cli, or in a HTML form with geostat) and renders a heat map of found/not found caches in a selected region. HTML output requires a style sheet. Sample one is included as geo.css.

Usage: geostat [options]
Generate HTML stats from Opencaching data or GPX files.

 * Data sources:
	-o[user]	use Opencaching; if specified user will be a user name used for all OC instances
	-p user		user for opencaching.pl
	-d user		user for opencaching.de
	-u user		user for opencaching.us
	-n user		user for opencaching.nl
	-r user		user for opencaching.ro
	-k user		user for opencaching.uk
	-g file		use specified gpx file
	-q		use local SQLite file with dump of OC database
 * Output:
	-N		compute stats only for unfound caches (works only with SQLite)
	-H file		render a heat map to a file
	-s n		stamp size for a heat map (default = 15)
	-e		use exponential to flatten the heat map
	-m map		chosen map: Poland, Poland_relief, Poland_big, Europe, World or a name of voivodeship (default = Poland)
	-h		display this help screen

There is a helper program geodb which manages local SQLite database. It can initialize the database from full data dump or update it according to changelogs grabbed from OKAPI.

Usage: geodb [-i path] [-uh]
Manage local Opencaching database.
	-i folder	initialize database from dump located in given folder
	-u	update database with changelogs grabbed via OKAPI
	-h	display this help screen

Installation

To compile it requires:

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.

Credits