View on GitHub

napari tutorials

tutorials for the napari image viewer

Napari + ImageJ How-to-Guide

ImageJ is a Java-based image processing program that provides extensibility via Java plugins and recordable macros. It can display, edit, analyze, process, save, and print 8-bit color and grayscale, 16-bit integer, and 32-bit floating point images. It can read many image file formats, including TIFF, PNG, GIF, JPEG, BMP, DICOM, and FITS, as well as raw formats. It has a plethora of features that can be checked out here.

People who wish to try their hands on ImageJ can do so by downloading and installing it using this link

Reading Image with ImageJ and Viewing them with Napari

Here we first cut at reading images with SCIFIO+Bio-Formats via PyimageJ into NumPy arrays and then display them with Napari.

import napari, sys

if len(sys.argv) <= 1:
    print('Please specify one or more images as arguments.')

    import imagej
except ImportError:
    raise ImportError("""This example uses ImageJ but pyimagej is not
    installed. To install try 'conda install pyimagej'.""")

with napari.gui_qt():

    print('--> Initializing imagej')
    ij = imagej.init('sc.fiji:fiji') # Fiji includes Bio-Formats.

    for i in range(1, len(sys.argv)):
        path = sys.argv[i]
        print('--> Reading {}'.format(path))

        dataset =
        image =

        if i == 1:
            viewer = napari.view_image(image)



Using ImageJ and Napari side-by-side

Issues with using ImageJ and Napari simultaneously

Simultaneously using ImageJ and Napari in various environments

Due to behavioural differences between plain Python and IPython we use slightly different approaches to run ImageJ and python simultaneously in each different environment.

1. Running napari+ImageJ from plain Python

Firstly import napari

import napari
with napari.gui_qt():

When napari comes up, open the Jupyter Qt console and type:

import imagej
ij = imagej.init(headless=False)

This works because the console in napari is running in the correctly initialized Qt GUI/main thread. However,if we even touch the Java UI from Python it locks up i.e. Python will now lock up even for the simplest line of code such as:


To fix this we can use either of these 3 following methods :

  1. Use Java’s EventQueue to queue the task on the Java event dispatch thread:
     from jnius import PythonJavaClass, java_method, autoclass
     class JavaRunnable(PythonJavaClass):
         __javainterfaces__ = ['java/lang/Runnable']
         def __init__(self, f):
             super(JavaRunnable, self).__init__()
             self._f = f
         def run(self):
     EventQueue = autoclass('java.awt.EventQueue')
     EventQueue.invokeLater(JavaRunnable(lambda: ij.ui().showDialog('hello')))
  2. Use the SciJava ScriptService:
     ij.script().run('.groovy', "#@ ImageJ ij\nij.ui().showDialog('hello')", True)
  3. Using ImageJ’s Script Editor
2. Starting napari + ImageJ from plain Python (without napari’s Qt Console)

Here is a plain Python script that starts up Qt and spins up ImageJ without use of napari’s Qt Console.

from PyQt5 import QtCore, QtWidgets

def main():
    app = QtWidgets.QApplication([])
    app.setQuitOnLastWindowClosed( True )

    def start_imagej():
        import imagej
        ij = imagej.init(headless=False)
        print("Launched ImageJ")

    QtCore.QTimer.singleShot(0, start_imagej)

if __name__ == "__main__":

Note that the app.exec_() call blocks the main thread, because Qt takes it over as its GUI/main thread. On macOS, the main thread is the only thread that works for Qt to use as its GUI/main thread.

3. Starting napari+ImageJ from IPython

A code that successfully starts ImageJ from IPython **NOTE: First initialize Qt using %gui qt or at launch via ipython –gui=qt

def start_imagej():
    import imagej
    global ij
    ij = imagej.init(headless=False)
from PyQt5 import QtCore
QtCore.QTimer.singleShot(0, start_imagej)

This how-to-guide is an adaptation of demos provided by Curtis Rueden on platform.