H3 Toolkit Plugin for QGIS

🌐 Brings the H3 discrete global grid system to QGIS.

🚀 Powered by the open source H3 library

How to Install

Browse and install via the plugin manager of QGIS (Recommended). Look for "H3 Toolkit".

You can also install via zipfile (If you need for some reason):

1. Download a zipped release from the releases
2. Proceed to Install from ZIP in QGIS

Installing the h3 dependency

TL;DR If you are familiar with Python, this is straightforward via pip or conda. This is the way to go, for now - I am working to improve the install experience for everyone.

The plugin depends on the h3 python package, which you would have to install yourself into the Python environment of QGIS. At startup the plugin detects if h3 is missing from the python environment and offers basic guidance on how to install.

NOTE: The plugin is tested with h3 version 3.7.x but in principle should work with other 3.x versions.

Please see H3 Installation on how to install.

How to use

The plugin registers an H3 processing provider, tools are available there. Please have a look at a tool's help text regarding specific usage.

Suggesting improvements / reporting issues

You are most welcome to post suggestions/issues on the Issues page.

Developer setup

Assuming a Linux development environment:

1. clone this repository

2. Create a symbolic link in the plugin folder within your QGIS profile directory:

   To find your profile folder, open QGIS and navigate to Settings -> User Profiles and click on Open Active Profile Folder. Then the plugin folder should be <YOUR PROFILE FOLDER>/python/plugins/

   cd into the plugin folder and create a symbolic link to the h3_toolkit folder of this repo.

   ln -s /your/path/to/qgis-h3-toolkit-plugin/h3_toolkit h3_toolkit

Example for flatpak installed QGIS:

# clone repository
cd ~/dev
git clone https://github.com/arongergely/qgis-h3-toolkit-plugin.git

# grant user filesystem access to the flatpak
flatpak override --user --filesystem=home org.qgis.qgis

# make sure to run the clean install once, so it creates the app config directories.
flatpak run org.qgis.qgis

# ensure the following path exists. Create missing folders when necessary:
# ~/.var/app/org.qgis.qgis/data/QGIS/QGIS3/profiles/default/python/plugins

# symlink the development directory
ln -s ~/dev/qgis-h3-toolkit-plugin/h3_toolkit \
  ~/.var/app/org.qgis.qgis/data/QGIS/QGIS3/profiles/default/python/plugins/h3-toolkit

# install pip for python inside the flatpak
flatpak run --command=python3 org.qgis.qgis -m ensurepip --upgrade --user

# now run qgis, open its python console and execute this command:
!python -m pip install 'h3<4.0'

How to make a release

Simply zip up the h3_toolkit directory. The .zip file is then ready for install from ZIP

There is also a convenience make command to generate the .zip file:

make zip