SP SOTA MAPS

The aim of the project is to prepare a set of SOTA activation cheat sheet maps containing an activation zone and other useful features, like grid square references or nearby references from other programs.

Due to the data sources used, the coverage of the project is limited to SP region and neighbours border summits.

Python helper utility

Setup

The recommended way of getting the sota helper utility into the scope, together with all its dependencies, is via the nix shell command.

nix shell github:majkrzak/sp-sota-maps

Baking or preloading the cache

A file system cache is used by the library to reduce heavy, repetitive calculations and load on the data servers. The cache directory is specified by the SOTA_CACHE environment variable and defaults to ./cache.

Baking process is recommended if all or bigger amount of summits will be processed. In case of processing only one summit, it is enough to relay on the on demand cache generation.

To run the baking, execute the following:

sota cache bake

Alternatively, the cache can be preloaded from the GitHub release by executing the following:

sota cache preload

Caution

Cache uses pickle as a storage format, which allows arbitrary code execution during unpickling. Ensure you trust me and the GitHub.

Loading OSM data into PostgreSQL

Base-map rendering requires OpenStreetMap data covering the summits to be preprocessed and placed in the PostgreSQL database. This can be achieved by executing the following:

sota carto load

Note

In case of a non-Nix setup: For the default OpenStreetMap Carto style, installation instructions can be followed. OpenStreetMap data for Poland can be downloaded from geofabrik.de. The sota helper can still be used to load it, by downloading OpenStreetMap data only from summit regions. It requires the initialization script wrapping the osm2pgsql tool to be specified by the CARTO_INIT environment variable.

Rendering map layers and other files

All map layers will be plotted and saved as PDF files. Besides that, TEX and other files will be generated. The output directory is specified by the SOTA_OUTPUT environment variable and defaults to ./output.

Note

In case of a non-Nix setup: additionally, to render the base-map layer, OpenStreetMap Carto has to be present under the directory which has to be provided via the CARTO_DIR environment variable.

To run the rendering process, execute the following:

sota render

Typeset the result

Final typesetting have to be done with lualatex. Recommended way is to do it is with latexmk. This ensures files are generated correctly.

The output directory is specified by the SOTA_OUTPUT environment variable and defaults to ./output.

To run the final typesetting, execute the following:

latexmk -lualatex -output-directory=$SOTA_OUTPUT $SOTA_OUTPUT/*.tex