Metadata-Version: 2.4
Name: zarr-vectors
Version: 0.9.4
Summary: Python utilities for Zarr Vectors — cloud-native storage for points, lines, streamlines, graphs, and meshes.
Author: Andrew Keenlyside, Forrest Collman
License: BSD-3-Clause
Project-URL: Homepage, https://github.com/AllenInstitute/zarr-vectors-py
Project-URL: Documentation, https://zarr-vectors-py.readthedocs.io
Project-URL: Repository, https://github.com/AllenInstitute/zarr-vectors-py
Project-URL: Issues, https://github.com/AllenInstitute/zarr-vectors-py/issues
Project-URL: Specification, https://github.com/AllenInstitute/zarr_vectors
Keywords: zarr,point-cloud,mesh,skeleton,streamline,connectomics,spatial
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24
Requires-Dist: numcodecs>=0.12
Requires-Dist: zarr>=3.0
Provides-Extra: draco
Requires-Dist: DracoPy>=1.3; extra == "draco"
Provides-Extra: obstore
Requires-Dist: obstore>=0.3; extra == "obstore"
Provides-Extra: fsspec
Requires-Dist: fsspec>=2024.0; extra == "fsspec"
Requires-Dist: s3fs>=2024.0; extra == "fsspec"
Requires-Dist: gcsfs>=2024.0; extra == "fsspec"
Requires-Dist: adlfs>=2024.0; extra == "fsspec"
Provides-Extra: icechunk
Requires-Dist: icechunk>=2; python_version >= "3.12" and extra == "icechunk"
Provides-Extra: cloud
Requires-Dist: zarr-vectors[obstore]; extra == "cloud"
Provides-Extra: gpu
Requires-Dist: cupy-cuda12x>=13; sys_platform == "linux" and extra == "gpu"
Provides-Extra: gpu-codecs
Requires-Dist: zarr-vectors[gpu]; extra == "gpu-codecs"
Requires-Dist: nvidia-nvcomp-cu12>=4.2; sys_platform == "linux" and extra == "gpu-codecs"
Provides-Extra: gpu-io
Requires-Dist: zarr-vectors[gpu]; extra == "gpu-io"
Requires-Dist: kvikio-cu12>=25.8; sys_platform == "linux" and extra == "gpu-io"
Provides-Extra: all
Requires-Dist: zarr-vectors[draco,fsspec,icechunk,obstore]; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-xdist>=3.5; extra == "dev"
Requires-Dist: pytest-timeout>=2.3; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: linkml<2,>=1.7; extra == "dev"
Requires-Dist: jsonschema<5,>=4.0; extra == "dev"
Dynamic: license-file

> [!NOTE]
> This package is under active development.

<img src="assets/zarr-vectors.png" alt="zarr-vectors" width="60%" />

**Tools for Zarr Vectors Data**

`zarr-vectors-py` reads, writes and validates vector geometry in the Zarr
Vectors format: point clouds, lines, streamlines, graphs, skeletons and
meshes, stored in chunked, multiscale Zarr v3 stores on disk or in the cloud.
It implements the [Zarr Vectors specification](https://github.com/AllenInstitute/zarr_vectors)
by Forrest Collman, Allen Institute for Brain Science.

```bash
pip install zarr-vectors
```

Requires Python 3.11 or later. File-format converters (LAS, PLY, TRK, SWC,
OBJ, ...) and their command-line tool are in the companion package
`zarr-vectors-tools`; this package installs no console scripts.

## Documentation

Full documentation: https://zarr-vectors-py.readthedocs.io/en/latest

- [Installation](https://zarr-vectors-py.readthedocs.io/en/latest/getting_started/installation.html): optional extras for cloud stores, Icechunk, Draco meshes and GPU arrays.
- [Quickstart](https://zarr-vectors-py.readthedocs.io/en/latest/getting_started/quickstart.html): create, write, query and validate a store.
- [Core concepts](https://zarr-vectors-py.readthedocs.io/en/latest/explanation/concepts.html): chunks, bins, fragments, objects and levels.
- [Specification](https://zarr-vectors-py.readthedocs.io/en/latest/spec/index.html): the format in full.
