AICSImageIO
A Python library for reading and writing image data with specific support for handling bio-formats.
Features
- Supports reading metadata and imaging data from file path or buffered bytes for:
CZIOME-TIFFTIFF- Any additional format supported by
imageio
- Supports writing metadata and imaging data for:
OME-TIFFTIFF- Any additional format supported by
imageio
Disclaimer:
This package is under heavy revision in preparation for version 3.0.0 release. The quick start below is representative of how to interact with the package under 3.0.0 and not under the current stable release.
Quick Start
from aicsimageio import AICSImage, imread
# For numpy array of image data
im = imread("/path/to/your/file_or_buffer.ome.tiff")
# For AICSImage object that
with AICSImage("/path/to/your/file_or_buffer.ome.tiff") as im:
# use im object
# To specify a known dimension order
with AICSImage("/path/to/your/file_or_buffer.ome.tiff", known_dims="SYX") as im:
# use im object
# if you instantiate an AICSImage:
im = AICSImage("/path/to/your/file_or_buffer.ome.tiff")
# you should close it when done:
im.close()
# Image data is stored in `data` attribute
im.data # returns the image data numpy array
# Image dimension sizes can be obtained via properties:
im.size_z # returns the size of the Z dimension. X,Y,Z,C,T, and S supported.
# Image dimensions can also be obtained as a tuple in two ways:
im.size("ZYX") # returns a tuple containing the Z, Y, and X sizes only
im.get_image_data(out_orientation="ZYX").shape # returns same as above
# Image metadata is stored in `metadata` attribute
im.metadata # returns whichever metadata parser best suits the file format
# Subsets or transposes of the image data can be requested:
im.get_image_data(out_orientation="ZYX") # returns a 3d data block containing only the ZYX dimensions
Notes
- Image data numpy arrays are always returned as six dimensional in dimension order
STCZYXorScene,Time,Channel,Z,Y, andX. - Each file format may use a different metadata parser it is dependent on the reader's implementation.
Installation
Stable Release: pip install aicsimageio
Development Head: pip install git+https://github.com/AllenCellModeling/aicsimageio.git
Documentation
For full package documentation please visit allencellmodeling.github.io/aicsimageio.
Development
See CONTRIBUTING.md for information related to developing the code.
Free software: BSD-3-Clause
1 maintainer
Release files for aicsimageio 3.0.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aicsimageio-3.0.7.tar.gz | 47.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aicsimageio-3.0.7-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 96.6 kB
Release files / aicsimageio-3.0.7.tar.gz
| Download URL | aicsimageio-3.0.7.tar.gz |
|---|---|
| Size | 47.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fafba01985154e21db50911addeb928bea7f81d1c79041a2ddb92b57f2b2b34f
|
|
BLAKE2b-256 checksum How to use checksums |
f10f885be055de5315866bc5b0ddd999339ce6e8d7157b1dde009cbc137cc2ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/3.7.5
|
Release files / aicsimageio-3.0.7-py2.py3-none-any.whl
| Download URL | aicsimageio-3.0.7-py2.py3-none-any.whl |
|---|---|
| Size | 49.6 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
ad8cde2a7f06c98508565f0f306cb903097f496c9586d25f3c9f2a944d4059cf
|
|
BLAKE2b-256 checksum How to use checksums |
890430c34c9e94986022eec66c36c9e2996a538035bdc88b8a8210a62adea5e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/3.7.5
|
