bioio-bioformats

A BioIO reader plugin for reading many file formats like as seen here using bioformats

Documentation

See the full documentation on our GitHub pages site - the generic use and installation instructions there will work for this package.

Information about the base reader this package relies on can be found in the bioio-base repository here

Installation

Stable Release: pip install bioio-bioformats
Development Head: pip install git+https://github.com/bioio-devs/bioio-bioformats.git

Special Installation Note

This package relies on bffile, which uses scyjava to fetch the Bio-Formats maven artifacts, and cjdk to fetch a Java runtime. You do NOT need to install or setup java separately.

Read details in the bffile README on how to select the Bio-Formats version or Java runtime version if you need to.

Example Usage (see full documentation for more examples)

Install bioio-bioformats alongside bioio:

pip install bioio bioio-bioformats

This example shows a simple use case for just accessing the pixel data of the image by explicitly passing this Reader into the BioImage. Passing the Reader into the BioImage instance is optional as bioio will automatically detect installed plug-ins and auto-select the most recently installed plug-in that supports the file passed in.

from bioio import BioImage
import bioio_bioformats

img = BioImage("my_file.tiff", reader=bioio_bioformats.Reader)
img.data

Issues

Click here to view all open issues in bioio-devs organization at once or check this repository's issue tab.

Development

See CONTRIBUTING.md for information related to developing the code.