Metadata-Version: 2.4
Name: tiledb-bioimg
Version: 0.3.9
Summary: Package supports all bio-imaging functionality provided by TileDB
Home-page: https://github.com/TileDB-Inc/TileDB-Bioimaging
Author: TileDB, Inc.
Author-email: help@tiledb.io
License: MIT
Project-URL: Bug Tracker, https://github.com/TileDB-Inc/TileDB-Bioimaging/issues
Project-URL: Documentation, https://docs.tiledb.com
Keywords: tiledb,bioimaging
Platform: any
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openslide-bin
Requires-Dist: pyeditdistance
Requires-Dist: tiledb>=0.19
Requires-Dist: tqdm
Requires-Dist: scikit-image
Requires-Dist: jsonpickle
Requires-Dist: requires
Provides-Extra: zarr
Requires-Dist: ome-zarr>=0.9.0; extra == "zarr"
Provides-Extra: openslide
Requires-Dist: openslide-python; extra == "openslide"
Provides-Extra: tiff
Requires-Dist: tifffile; extra == "tiff"
Requires-Dist: imagecodecs; extra == "tiff"
Provides-Extra: cloud
Requires-Dist: tiledb-cloud; extra == "cloud"
Provides-Extra: full
Requires-Dist: imagecodecs; extra == "full"
Requires-Dist: ome-zarr>=0.9.0; extra == "full"
Requires-Dist: openslide-python; extra == "full"
Requires-Dist: tifffile; extra == "full"
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist

<a href="https://tiledb.com"><img src="https://github.com/TileDB-Inc/TileDB/raw/dev/doc/source/_static/tiledb-logo_color_no_margin_@4x.png" alt="TileDB logo" width="400"></a>

[![TileDB-BioImaging CI](https://github.com/TileDB-Inc/TileDB-BioImaging/actions/workflows/ci.yml/badge.svg)](https://github.com/TileDB-Inc/TileDB-BioImaging/actions/workflows/ci.yml)
![Coverage Badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/ktsitsi/32d48185733a4e7375e80e3e35fab452/raw/gist_bioimg.json)

# TileDB-BioImaging

Python package for:
- converting images stored in popular Biomedical Imaging formats to groups of TileDB arrays (& vice versa)
- exposing an expressive and efficient API (powered by TileDB) for querying such data.

## Features

### Ingestion to TileDB Groups of Arrays
    - OME-Zarr
    - OME-Tiff
    - Open-Slide

### Export from TileDB-Bioimaging Arrays to:
    - OME-Zarr
    - OME-Tiff

### Visualization Options

- [TileDB Cloud](https://cloud.tiledb.com) includes a built-in, pyramidal multi-resolution viewer: log in to TileDB Cloud to see an example image preview [here](https://cloud.tiledb.com/biomedical-imaging/TileDB-Inc/dbb7dfcc-28b3-40e5-916f-6509a666d950/preview)
- Napari: https://github.com/TileDB-Inc/napari-tiledb-bioimg

## Quick Installation

- From PyPI:

      pip install 'tiledb-bioimg[full]'

- From source:

      git clone https://github.com/TileDB-Inc/TileDB-BioImaging.git
      cd TileDB-BioImaging

      pip install -e '.[full]'


## Examples
How to convert imaging data from standard biomedical formats to group of TileDB arrays.

### OME-Zarr to TileDB Group of Arrays
```python
from tiledb.bioimg.converters.ome_zarr import OMEZarrConverter
OMEZarrConverter.to_tiledb("path_to_ome_zarr_image", "tiledb_array_group_path")
```

### OME-Tiff to TileDB Group of Arrays
```python
from tiledb.bioimg.converters.ome_tiff import OMETiffConverter
OMETiffConverter.to_tiledb("path_to_ome_tiff_image", "tiledb_array_group_path")
```

### Open Slide to TileDB Group of Arrays
```python
from tiledb.bioimg.converters.openslide import OpenSlideConverter
OpenSlideConverter.to_tiledb("path_to_open_slide_image", "tiledb_array_group_path")
```

## Documentation
`API Documentation` is auto-generated. Following the instructions below:

```shell
quartodoc build && quarto preview
```
