Metadata-Version: 2.5
Name: taco-eo
Version: 0.5.1
Summary: Read and write TACO datasets in Python.
Project-URL: Homepage, https://asterisk.coop/taco
Project-URL: Specification, https://asterisk.coop/taco/spec
Project-URL: Repository, https://github.com/asterisk-labs/taco
Project-URL: Issues, https://github.com/asterisk-labs/taco/issues
Author-email: Cesar Aybar <cesar@asterisk.coop>
License-Expression: MIT
License-File: LICENSE
Keywords: cloud-optimized,cozip,earth-observation,geospatial,machine-learning,parquet,taco
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: cozip>=2026.9.4
Requires-Dist: duckdb>=1.5.5
Requires-Dist: numpy>=1.24
Requires-Dist: pyarrow>=14
Requires-Dist: pydantic>=2.8
Requires-Dist: pyproj>=3.6
Requires-Dist: shapely>=2
Provides-Extra: antimeridian
Requires-Dist: antimeridian>=0.4; extra == 'antimeridian'
Requires-Dist: pyproj>=3.6; extra == 'antimeridian'
Requires-Dist: shapely>=2; extra == 'antimeridian'
Provides-Extra: dev
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: geoenrich
Requires-Dist: earthengine-api>=1; extra == 'geoenrich'
Provides-Extra: progress
Requires-Dist: tqdm>=4.66; extra == 'progress'
Provides-Extra: rumi
Requires-Dist: rumi-eo[write]>=0.19; extra == 'rumi'
Provides-Extra: test
Requires-Dist: pytest-cov>=5; extra == 'test'
Requires-Dist: pytest>=8; extra == 'test'
Provides-Extra: test-eo
Requires-Dist: antimeridian>=0.4; extra == 'test-eo'
Requires-Dist: rumi-eo[write]>=0.19; extra == 'test-eo'
Description-Content-Type: text/markdown

# taco

Read and write TACO datasets in Python.

```bash
pip install taco-eo
python examples/minimal.py
```

```python
import taco

samples = taco.read("dataset.zip")
parts = taco.read(["part-0.zip", "part-1.zip"])
```

## Examples

Every example is self-contained, uses synthetic data, and writes its output in
the current directory.

| Example | What it demonstrates |
| --- | --- |
| [`minimal.py`](examples/minimal.py) | Smallest possible single-file dataset |
| [`numpy_minimal.py`](examples/numpy_minimal.py) | NumPy image and mask assets with a train/test split |
| [`change_detection.py`](examples/change_detection.py) | Metadata on `before/` and `after/` folders |
| [`sequence.py`](examples/sequence.py) | Variable-length asset sequences |
| [`time_series.py`](examples/time_series.py) | Per-observation time and cloud metadata |
| [`geospatial.py`](examples/geospatial.py) | Compact STAC metadata and derived MajorTOM cells |
| [`stac_segmentation.py`](examples/stac_segmentation.py) | STAC extensions for regular raster chips, labels, bands, and scaling |
| [`oceantaco_istac.py`](examples/oceantaco_istac.py) | OceanTACO-inspired ISTAC metadata for irregular SWOT swaths and Argo collocations |
| [`partitioned.py`](examples/partitioned.py) | ZIP partitions and their TACOCAT catalog |
