Geomaker

Geomaker is a map-based GUI for extracting detailed map data from regions in Norway based on the web services of the Norwegian Mapping Authority.

Installation

In simplest terms:

git clone https://github.com/TheBB/geomaker
cd geomaker
pip install --user .

This should install Geomaker and all its dependencies locally, typically to your ~/.local folder. The executable is called geomaker, generally located in ~/.local/bin/geomaker.

There are a number of ways this might fail:

• If pip is not installed, install it.
• If pip points to a Python 2 installation, your distribution's Python 3 pip might be called pip3.
• If a compiled component fails to compile, you may need to install pybind11, e.g. sudo apt install pybind11-dev on Ubuntu.
• If PyQt5 or some other dependencies fail to install, you may want to install them manually using your system's package manager. See the detailed list of dependencies below. After doing this, you can install geomaker by using --no-deps with pip.
• A recent version of pip is highly recommended. Some PyQt5 packages may fail to install with older versions. To update pip itself, use pip install --user --upgrade pip. Note that this will install pip locally, and it may shadow the system-installed version of pip depending on your PATH settings, but it shouldn't overwrite it.

If you wish to frequently update Geomaker, I recommend also to install with the --editable flag, so that the installed version of Geomaker automatically tracks the repository contents.

Dependencies

The following packages are either simple Python-only packages or have well-established compiled wheels for download:

• alembic (for migrating database revision)
• area (for calculating areas in spherical coordinate systems)
• bidict (bidirectional dictionaries)
• matplotlib (for color maps)
• numpy (no scientific code can be without)
• pillow (for saving images)
• requests (for making API queries to hoydedata.no)
• scipy (for optimization routines)
• sqlalchemy (for maintaining persistent data on disk)
• tifffile (for reading GeoTIFF files)
• toml (for the config file)
• utm (for converting to and from UTM coordinates)
• xdg (for accessing XDG paths)

In addition, the PyQt5 bindings are necessary. Most Linux distributions have well-established system packages for these if they fail to install from PyPi.

• PyQt5
• PyQtWebEngine

The following packages are optional, for generating various output:

• numpy-stl (for saving STL meshes)
• triangle (for saving unstructured meshes: VTK, VTU and STL)
• splipy (for producing B-Spline output)
• vtk (for VTS, VTU and VTK format)