Metadata-Version: 2.4
Name: healpix-convert
Version: 2026.9.0
Summary: Convert datasets into the HEALPix-based DGGS format
Author: healpix-convert Developers
License: Apache-2.0
Keywords: healpix
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: xarray>=2025.11.0
Requires-Dist: numpy>=2
Requires-Dist: healpix-geo>=0.0.11
Requires-Dist: healpix-resample>=0.1.5
Requires-Dist: dask>=2025.2.0
Requires-Dist: distributed>=2025.2.0
Requires-Dist: pyproj>=3.7.2
Requires-Dist: affine>=2.4.0
Requires-Dist: shapely>=2.1.0
Requires-Dist: torch>=2.9.1
Requires-Dist: zarr>=3.1.3
Requires-Dist: pydantic>=2.12.5
Requires-Dist: structlog>=25.5.0
Requires-Dist: rasterix>=0.1
Requires-Dist: s3fs>=2026.1.0
Dynamic: license-file

# healpix-convert

This package allows converting various datasets into the
[HEALPix](https://healpix.sourceforge.io/)-based DGGS format proposed by
**GRID4EARTH**.

It takes input data stored in Zarr format (one or more EOPF-compliant Zarr
datasets), then reprojects and resamples it onto a HEALPix grid, outputting a
new Zarr dataset compliant with the DGGS Zarr and CF-Healpix conventions.

**Note: this repository is currently under heavy development. API is not stable yet.**

## Supported data products

- ERA5
- ClimateDT
- CAMS

## Key features

- **Multiple resampling methods** — nearest, bilinear, k-nearest neighbors, PSF, cell-point
- **Multi-stage workflow** — first prepare the output dataset, then run data conversion in parallel jobs
- **Dask-native** — parallel conversion out of the box with a distributed Dask cluster
- **Cloud-ready** — read from and write to S3 object stores
- **STAC metadata** — input STAC discovery attributes are propagated and merged in the output
- **Zarr conventions** — [Zarr conventions](https://github.com/zarr-conventions) are used for structuring metadata in the output dataset

## Installation

### From PyPI or conda-forge

There's no package published on PyPI and/or conda-forge yet.

### From source (development)

First clone this repository:

```sh
$ git clone https://github.com/GRID4EARTH/healpix-convert
$ cd healpix-convert
```

Then install it, e.g., using pip:

```sh
$ python -m pip install .
```

Note: we recommend installing it in an isolated development environment.

If you have [pixi](https://pixi.prefix.dev) installed, you can install a
complete development environment by simply using the command below:

```sh
$ pixi install -e dev
```

## Basic usage

See examples in the ``notebooks`` folder.
