vgridpandas 1.0.1

Integration of Vgrid DGGS into Pandas and GeoPandas

VgridPandas

Integrates Vgrid DGGS with GeoPandas and Pandas, inspired by H3-Pandas

Vgridpandas supports popular geodesic DGGS such as H3, S2, rHEALPix, Open-Eaggr ISEA4T, EASE-DGGS, QTM, and graticule DGGS such as OLC, Geohash, MGRS, GEOREF, Tilecode, Quadkey, Maidenhead, GARS

---

⬢ Try it out ⬢

Installation

pip

pip install vgridpandas

Usage examples

vgridpandas.h3pandas API

vgiridpandas.h3pandas automatically applies H3 functions to both Pandas Dataframes and GeoPandas Geodataframes

# Prepare data
>>> import pandas as pd
>>> from vgridpandas import h3pandas
>>> df = pd.DataFrame({'lat': [50, 51], 'lon': [14, 15]})

>>> resolution = 10
>>> df = df.h3.latlon2h3(resolution)
>>> df

| h3_10           |   lat |   lon |
|:----------------|------:|------:|
| 8a1e30973807fff |    50 |    14 |
| 8a1e2659c2c7fff |    51 |    15 |

>>> df = df.h3.h32geo()
>>> df

| h3_10           |   lat |   lon | geometry        |
|:----------------|------:|------:|:----------------|
| 8a1e30973807fff |    50 |    14 | POLYGON ((...)) |
| 8a1e2659c2c7fff |    51 |    15 | POLYGON ((...)) |

Further examples

For more examples, see the example notebooks.

VgridPandas API

For a full API documentation and more usage examples, see the documentation.

Any suggestions and contributions are very welcome!

See issues for more.