BioFormats Input/Output utility (bfio 2.5.0)
This tool is a simplified but powerful interface to Bio-Formats using jpype for direct access to the library. This tool is designed with scalable image analysis in mind, with a simple interface to treat any image like a memory mapped array.
Docker containers with all necessary components are available (see Docker Containers section).
Summary
Installation
Setting up Java
Note: bfio can be used without Java, but only the python, zarr, zarr3, and tensorstore
backends will be usable. This means only files in tiled OME Tiff or OME Zarr format can be
read/written.
In order to use the bioformats backend, it is necessary to first install the JDK and Maven.
The bfio package is generally tested with
JDK 8,
but JDK 11 and later also appear to work.
Here are some info on installing Maven on various OS (Windows | Linux | Mac)
Installing bfio
The bfio package and the core dependencies (numpy, tifffile, imagecodecs, scyjava) can
be installed using pip:
pip install bfio
Docker
polusai/bfio:2.5.0
Ubuntu based container with bfio and all dependencies (including Java).
polusai/bfio:2.5.0-imagej
Same as above, except comes with ImageJ and PyImageJ.
polusai/bfio:2.5.0-tensorflow
Tensorflow container with bfio installed.
Documentation
Documentation and examples are available on Read the Docs.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
Nick Schaub (nick.schaub@nih.gov, nick.schaub@axleinfo.com) Sameeul B Samee (sameeul.samee@axleinfo.com)
License
This project is licensed under the MIT License Creative Commons License - see the LICENSE file for details.
Acknowledgments
- Parts of this code were written/modified from existing code found in
tifffile.
2 maintainers
Release files for bfio 2.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bfio-2.5.0.tar.gz | 58.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bfio-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 111.7 kB
Release files / bfio-2.5.0.tar.gz
| Download URL | bfio-2.5.0.tar.gz |
|---|---|
| Size | 58.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e6b8f72f96f241ed5579a3c5cf48a2d248c4a371a25e063a6611696b7778ab19
|
|
BLAKE2b-256 checksum How to use checksums |
f696bcf4a6037f59a8a252ebe65cc2ca211369174d1b968e1fe077da78a0891b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Release files / bfio-2.5.0-py3-none-any.whl
| Download URL | bfio-2.5.0-py3-none-any.whl |
|---|---|
| Size | 53.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
45aa36efee6d5b2cd08f0cc4d974f61c78974535500ecfbfe137761e787cba19
|
|
BLAKE2b-256 checksum How to use checksums |
e8d3efe6ececd6b2de5d1fbd35d9559f79870a07c6a3657518717511a70904f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
