Module: viewer

skimage.viewer.warn(message[, category, ...]) A version of warnings.warn with a default stacklevel of 2.
skimage.viewer.CollectionViewer(image_collection) Viewer for displaying image collections.
skimage.viewer.ImageViewer(image[, useblit]) Viewer for displaying images.


skimage.viewer.warn(message, category=None, stacklevel=2)[source]

A version of warnings.warn with a default stacklevel of 2.


class skimage.viewer.CollectionViewer(image_collection, update_on='move', **kwargs)[source]

Bases: skimage.viewer.viewers.core.ImageViewer

Viewer for displaying image collections.

Select the displayed frame of the image collection using the slider or with the following keyboard shortcuts:

left/right arrows
Previous/next image in collection.
number keys, 0–9
0% to 90% of collection. For example, “5” goes to the image in the middle (i.e. 50%) of the collection.
home/end keys
First/last image in collection.

image_collection : list of images

List of images to be displayed.

update_on : {‘move’ | ‘release’}

Control whether image is updated on slide or release of the image slider. Using ‘on_release’ will give smoother behavior when displaying large images or when writing a plugin/subclass that requires heavy computation.

__init__(image_collection, update_on='move', **kwargs)[source]
update_index(name, index)[source]

Select image on display using index into image collection.


class skimage.viewer.ImageViewer(image, useblit=True)[source]

Bases: object

Viewer for displaying images.

This viewer is a simple container object that holds a Matplotlib axes for showing images. ImageViewer doesn’t subclass the Matplotlib axes (or figure) because of the high probability of name collisions.

Subclasses and plugins will likely extend the update_image method to add custom overlays or filter the displayed image.


image : array

Image being viewed.


>>> from skimage import data
>>> image = data.coins()
>>> viewer = ImageViewer(image) 


canvas, fig, ax (Matplotlib canvas, figure, and axes) Matplotlib canvas, figure, and axes used to display image.
image (array) Image being viewed. Setting this value will update the displayed frame.
original_image (array) Plugins typically operate on (but don’t change) the original image.
plugins (list) List of attached plugins.
__init__(image, useblit=True)[source]
connect_event(event, callback)[source]

Connect callback function to matplotlib event and return id.


Disconnect callback by its id (returned by connect_event).

dock_areas = {'top': None, 'left': None, 'right': None, 'bottom': None}

Open image file and display in viewer.

original_image_changed = None

Save current image to file.

The current behavior is not ideal: It saves the image displayed on screen, so all images will be converted to RGB, and the image size is not preserved (resizing the viewer window will alter the size of the saved image).


Show ImageViewer and attached plugins.

This behaves much like and


Update displayed image.

This method can be overridden or extended in subclasses and plugins to react to image changes.