Skip to content

A data science toolkit for the H3 geospatial grid

Notifications You must be signed in to change notification settings

nmandery/h3ronpy

Repository files navigation

h3ronpy

A data science toolkit for the H3 geospatial grid.

PyPI ReadTheDocs conda-forge

This library is not a substitute for the official python h3 library - instead it provides more high-level functions on top of H3 and integrations into common dataframe libraries.

Documentation is available on https://h3ronpy.readthedocs.io/.

Looking for maintainers

My personal focus has shifted quite a bit since I started this project. Currently I am not working much with H3 any more, so I have very little time to spend on this library, or even to keep up with standard maintenance tasks like upgrades or answering pull requests and issues. To keep this project somewhat alive, additional maintainers would be very welcome.

Features

  • H3 algorithms provided using the performant h3o library.
  • Build on Apache Arrow and the lightweight arro3 for efficient data handling. The arrow memory model is compatible with dataframe libraries like pandas and polars.
  • Extensions for the polars Series` and Expr APIs.
  • Some dedicated functions to work with geopandas GeoSeries.
  • Multi-threaded conversion of raster data to the H3 grid using numpy arrays.
  • Multi-threaded conversion of vector data, including geopandas GeoDataFrames and any object which supports the python __geo_interface__ protocol (shapely, geojson, ...).

Limitations

Not all functionalities of the H3 grid are wrapped by this library, the current feature-set was implemented when there was a need and the time for it. As a opensource library new features can be requested in the form of github issues or contributed using pull requests.

License

MIT

About

A data science toolkit for the H3 geospatial grid

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 5

Languages