Skip to main content

AICSImageIO for napari. Multiple file format reading directly into napari using pure Python.

Project description

napari-aicsimageio

Build Status Code Coverage

AICSImageIO bindings for napari


Features

  • Supports reading metadata and imaging data for:
    • CZI
    • OME-TIFF
    • TIFF
    • Any formats supported by aicsimageio
    • Any additional format supported by imageio

Installation

Stable Release: pip install napari-aicsimageio
Development Head: pip install git+https://github.com/AllenCellModeling/napari-aicsimageio.git

Plugin Variants

screenshot of plugin sorter showing that napari-aicsimageio-in-memory should be placed above napari-aicsimageio-out-of-memory

There are two variants of this plugin that are added during installation:

  • aicsimageio-in-memory, which reads an image fully into memory
  • aicsimageio-out-of-memory, which delays reading ZYX chunks until required. This allows for incredible large files to be read and displayed.

Examples of Features

General Image Reading

All image file formats supported by aicsimageio will be read and all raw data will be available in the napari viewer.

In addition, when reading an OME-TIFF, you can view all OME metadata directly in the napari viewer thanks to ome-types.

screenshot of an OME-TIFF image view, multi-channel, z-stack, with metadata viewer

Mosaic Reading

When reading CZI or LIF images, if the image is a mosaic tiled image, napari-aicsimageio will return the reconstructed image:

screenshot of a reconstructed / restitched mosaic tile LIF

Multi-Scene Selection

Experimental

When reading a multi-scene file, a widget will be added to the napari viewer to manage scene selection (clearing the viewer each time you change scene or adding the scene content to the viewer) and a list of all scenes in the file.

gif of drag and drop file to scene selection and management

Development

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

For additional file format support, contributed directly to AICSImageIO. New file format support will become directly available in this plugin on new aicsimageio releases.

Citation

If you find aicsimageio (or napari-aicsimageio) useful, please cite as:

AICSImageIO Contributors (2021). AICSImageIO: Image Reading, Metadata Conversion, and Image Writing for Microscopy Images in Pure Python [Computer software]. GitHub. https://github.com/AllenCellModeling/aicsimageio

Free software: BSD-3-Clause

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

napari-aicsimageio-0.4.1.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

napari_aicsimageio-0.4.1-py2.py3-none-any.whl (8.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file napari-aicsimageio-0.4.1.tar.gz.

File metadata

  • Download URL: napari-aicsimageio-0.4.1.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.7

File hashes

Hashes for napari-aicsimageio-0.4.1.tar.gz
Algorithm Hash digest
SHA256 40419d15257b2de9e0f6fd84b9cfe18959aaac47e9633ab6407655e8188159ed
MD5 e02aceb0ff90f30307d4f08a5b230178
BLAKE2b-256 04fd909ac97bde509daf90f42c6f8a1ee2a5d826152509629627ab0841644e71

See more details on using hashes here.

File details

Details for the file napari_aicsimageio-0.4.1-py2.py3-none-any.whl.

File metadata

  • Download URL: napari_aicsimageio-0.4.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.7

File hashes

Hashes for napari_aicsimageio-0.4.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6d3024d9aaf68f187aff853858028e2240f401095f7091d990e5c833ca46a5b1
MD5 06984165be782baaadb8d3c26e98c098
BLAKE2b-256 c89cd92d89360c895faa2e108d87b2c7ea87efa86a7f18aee6eb560b38f4f722

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page