Metadata-Version: 2.4
Name: extend-zarr
Version: 0.1.2
Author-email: Taka <takahisa.amano@eodc.eu>
Project-URL: Homepage, https://github.com/eodcgmbh/extend-zarr/
Project-URL: Repository, https://github.com/eodcgmbh/extend-zarr.git
Project-URL: Issues, https://github.com/eodcgmbh/extend-zarr/issues
Requires-Python: <3.13,>=3.11
Description-Content-Type: text/markdown
Requires-Dist: dask<2026
Requires-Dist: numpy<3
Requires-Dist: xarray<2026
Requires-Dist: zarr<4

# Extend Zarr

Library for writing a new DataArray to a Zarr file containing a DataArray.
If necessary, the Coordinates of the DataArray in the Zarr file is extended and
the DataArray data is written.

## Installation

```bash
pip install extend-zarr
```

## Usage

```python
from extend_zarr import extend_zarr

dataarray = ...  # DataArray to be written
zarr_path = ...  # Path to the Zarr file
extend_zarr(dataarray=dataarray,
            zarr_path=zarr_path,
            var_name='value')
```

A notebook explaining the behavior of the function is available in
[examples](https://github.com/eodcgmbh/extend-zarr/blob/main/examples/extend_zarr.ipynb).

## Limitations

The following limitations exists to the coordinates of the dataarray to which
this function can be applied.

- Coordinates needs to be unique 1D arrays.
- Dataarray can only be appended to tail of the zarr store.
