A Python library for making geographic hexagon grids like QGIS's `create grid` function
Project description
A Python 3.9+ library for making geographic hexagon grids like QGIS’s create grid function. Not designed for making discrete global grid systems like Uber’s H3.
Here’s an example of its main use, namely, minimally covering a GeoDataFrame of features with a flat-top hexagon grid of given resolution.
import geopandas as gpd
import geohexgrid as ghg
# Load New Zealand territorial authorities projected in EPSG 2193 (NZTM)
shapes = gpd.read_file(DATA_DIR / "nz_tas.gpkg")
# Cover it minimally with hexagons of circumradius 10 kilometres
grid = ghg.make_grid(shapes, 10_000, intersect=True)
# Plot
base = shapes.plot(color='red', figsize=(20, 20), aspect="equal")
grid.plot(ax=base, color='white', edgecolor="blue", alpha=0.5)
Contributors
Alex Raichev (2014-09), maintainer
Installation
Install from PyPI, e.g. via poetry add geohexgrid.
Examples
See the Jupyter notebook at notebooks/examples.ipynb.
Notes
This project’s development status is Alpha. Alex uses this project for work and changes it breakingly when it suits his needs.
This project uses semantic versioning.
Thanks to MRCagney for periodically funding this project.
Red Blog Games has a great write up of non-geographic hexagon grids.
Alex wanted to chose a shorter name for this package, such as ‘hexgrid’, ‘geohex’, or ‘hexcover’, but those were already taken or too close to taken on PyPI.
Changes
1.1.0, 2023-10-27
Added the clip option to the function grid_from_gdf.
Updated dependencies.
Re-ordered functions.
Changed the cell ID separotor to a comma.
1.0.0, 2022-08-15
First release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for geohexgrid-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3bec8247b0b876d15c68f1e5a1b5155fe445cf1aea0df5ec3d371d8619df2fca |
|
MD5 | a990a39b7459b0eee0c628e48412841e |
|
BLAKE2b-256 | 57f5f5427d198412679e252b061486de4c906a195ea4e4a347962c5a78d6a336 |