h3ron

Rust libraries for the H3 geospatial indexing system.

Maintenance status

In january 2023 the h3o library - a port of H3 to rust - has been released. This brings many benefits including type safety, compilation to WASM and performance improvements (example: issue comparing raster to h3 conversion).

As a result these libraries will most certainly only receive dependency upgrades in the future. Some parts will maybe be ported to h3o, like the raster to H3 conversion already was.

Crates

This repository consists of multiple crates:

h3ron

High-level rust API for H3.

This crate builds on-top the official C library. The recently released h3o project provides an implementation of H3 in pure rust.

Documentation | Changelog

h3ron-h3-sys

bindgen-generated bindings for the statically linked libh3 C library.

Documentation | Changelog

h3ron-ndarray

Integration with the ndarray crate to generate H3 cells from raster data (using gdal, ...)

Documentation | Changelog

h3ron-graph

Graph algorithms on edges of the H3 spatial indexing system.

Documentation | Changelog

h3ron-polars

Integration of the h3 geospatial indexing system with polars dataframes by providing extension traits to UInt64Chunked and DataFrame.

Python bindings

Python bindings for parts of the functionalities are available in the h3ronpy extension now located in an own repository. For an overview of some features complementary to libh3 please see the README of the python bindings.

Why this name?

Well, coming up with a good name for a project while avoiding naming conflicts is hard. On the other hand are animal-based names always pretty easy to remember.

How to pronounce it? I got no idea - probably like the heron bird family.

License

MIT

Some data in the data directory is derived from OpenStreetMap and as such is copyright by the OpenStreetMap contributors. For the OSM license see OSMs Copyright and License page.