https://github.com/sintef/geomaker

https://github.com/sintef/geomaker

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/sintef/geomaker
• Owner: SINTEF
• Created: 2020-01-20T12:13:41.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-06-02T13:55:57.000Z (over 2 years ago)
• Last Synced: 2024-04-17T14:12:43.947Z (9 months ago)
• Language: Python
• Size: 353 KB
• Stars: 4
• Watchers: 3
• Forks: 4
• Open Issues: 14
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# 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:

```bash

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)