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):
- Download a zipped release from the releases
- 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:
-
clone this repository
-
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 theh3_toolkit
folder of this repo.ln -s /your/path/to/qgis-h3-toolkit-plugin/h3_toolkit h3_toolkit
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