Skip to main content

napari/OMERO interoperability

Project description

napari-omero

License Version Python Version CI

This package provides interoperability between the OMERO image management platform, and napari: a fast, multi-dimensional image viewer for python.

It provides a GUI interface for browsing an OMERO instance from within napari, as well as command line interface extensions for both OMERO and napari CLIs.

demo

Features

  • GUI interface to browse remote OMERO data, with thumbnail previews.
  • Loads remote nD images from an OMERO server into napari
  • Planes are loading on demand as sliders are moved ("lazy loading").
  • session management (login memory)
  • OMERO rendering settings (contrast limits, colormaps, active channels, current Z/T position) are applied in napari

as a napari dock widget

To launch napari with the OMERO browser added, install this package and run:

napari_omero

The OMERO browser widget can also be manually added to the napari viewer:

import napari
from napari_omero import OMEROWidget

with napari.gui_qt():
    viewer = napari.Viewer()
    viewer.window.add_dock_widget(OMEROWidget(), area="right")

as a napari plugin

This package provides a napari reader plugin that accepts OMERO resources as "proxy strings" (e.g. Image:<ID>) or as OMERO webclient URLS.

viewer = napari.Viewer()

# omero object identifier string
viewer.open("Image:1", plugin="omero")

# or URLS: https://help.openmicroscopy.org/urls-to-data.html
viewer.open("http://yourdomain.example.org/omero/webclient/?show=image-314")

these will also work on the napari command line interface, e.g.:

napari Image:1
# or
napari http://yourdomain.example.org/omero/webclient/?show=image-314

as an OMERO CLI plugin

This package also serves as a plugin to the OMERO CLI

omero napari view Image:1
  • ROIs created in napari can be saved back to OMERO via a "Save ROIs" button.
  • napari viewer console has BlitzGateway 'conn' and 'omero_image' in context.

installation

Requires python 3.7 - 3.9.

It's easiest to install omero-py from conda, so the recommended install procedure is to first create a new conda environment (here called "omero") with omero-py installed from the ome channel, and then use pip to install napari-omero (until we have a conda package available).

conda create -n omero -c ome python=3.7 omero-py
conda activate omero
pip install napari-omero

issues

This is alpha software & some things will be broken or sub-optimal!
  • experimental & definitely still buggy! Bug reports are welcome!
  • remote loading can be very slow still... though this is not strictly an issue of this plugin. Datasets are wrapped as delayed dask stacks, and remote data fetching time can be significant. Plans for asynchronous rendering in napari and tiled loading from OMERO may eventually improve the subjective performance... but remote data loading will likely always be a limitation here.

contributing

Contributions are welcome! To get setup with a development environment:

# clone this repo:
git clone https://github.com/tlambert03/napari-omero.git
# change into the new directory
cd napari-omero
# create conda environment
conda env create -f environment.yml
# activate the new env
conda activate napari-omero

To maintain good code quality, this repo uses flake8, mypy, and black. To enforce code quality when you commit code, you can install pre-commit

# install pre-commit which will run code checks prior to commits
pre-commit install

The original OMERO data loader and CLI extension was created by Will Moore.

The napari reader plugin and GUI browser was created by Talley Lambert

Download files

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

Files for napari-omero, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size napari_omero-0.1.1-py3-none-any.whl (21.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size napari-omero-0.1.1.tar.gz (10.2 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page