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.0.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

napari_aicsimageio-0.4.0-py2.py3-none-any.whl (8.5 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: napari-aicsimageio-0.4.0.tar.gz
  • Upload date:
  • Size: 8.9 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.0.tar.gz
Algorithm Hash digest
SHA256 60e61a1eb20afbba4f99b6456ee39fccaa389d6e0a8c07784d714546959b8a0c
MD5 203844e507b306ef96ec38899f505b87
BLAKE2b-256 ba0909d66eee0e417457a66b5438ced6716198ba4cabde8eaf26e3567e40d2de

See more details on using hashes here.

File details

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

File metadata

  • Download URL: napari_aicsimageio-0.4.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.5 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.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 43ccdbd75e715d6a25ae554da52ec0d61b0bd7c76aaf1537241e202c2c2083d1
MD5 78699668fb76e4a0f14dfb4e3a73c44c
BLAKE2b-256 c436bb8ff77001bca0ed49797f8b8698c5e5a6d20c5be425082e045ff5c2032d

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