Metadata-Version: 2.4
Name: tacotiff
Version: 0.0.3
Summary: AI-Optimized GeoTIFF reading with JSON metadata bypass
Author-email: Cesar Aybar <cesar.aybar@uv.es>
License: MIT
Project-URL: Homepage, https://github.com/tacofoundation/tacotiff
Project-URL: Repository, https://github.com/tacofoundation/tacotiff.git
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: gdal
Requires-Dist: numpy
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"

# TACOTIFF Python Package

Python bindings for the TACOTIFF high-performance GeoTIFF driver.

## Installation

```bash
pip install tacotiff
```

## Prerequisites

- GDAL Python bindings (`pip install gdal`)
- TACOTIFF GDAL driver installed in system

## Usage

```python
import tacotiff

# Open TACOTIFF with JSON metadata
metadata = {
    "ImageWidth": 1024,
    "ImageLength": 1024,
    "TileWidth": 256,
    "TileLength": 256,
    # ... complete metadata
}

ds = tacotiff.open("data.tif", metadata_json=metadata, num_threads=4)
array = ds.ReadAsArray()
```

## API Reference

- `tacotiff.open(filename, metadata_json, num_threads=1)` - Open TACOTIFF file
- `tacotiff.metadata_from_tiff(filename)` - Extract metadata from TIFF
- `tacotiff.validate_metadata(metadata)` - Validate metadata schema
