Docs for 0.13.1
All versions

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.canvastools
skimage.viewer.plugins
skimage.viewer.qt
skimage.viewer.utils
skimage.viewer.viewers
skimage.viewer.widgets Widgets for interacting with ImageViewer.

warn

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

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

CollectionViewer

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.
Parameters:

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]
keyPressEvent(event)[source]
update_index(name, index)[source]

Select image on display using index into image collection.

ImageViewer

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.

Parameters:

image : array

Image being viewed.

Examples

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

Attributes

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]
add_tool(tool)[source]
closeEvent(event)[source]
connect_event(event, callback)[source]

Connect callback function to matplotlib event and return id.

disconnect_event(callback_id)[source]

Disconnect callback by its id (returned by connect_event).

dock_areas = {'left': None, 'bottom': None, 'top': None, 'right': None}
image
open_file(filename=None)[source]

Open image file and display in viewer.

original_image_changed = None
redraw()[source]
remove_tool(tool)[source]
reset_image()[source]
save_to_file(filename=None)[source]

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(main_window=True)[source]

Show ImageViewer and attached plugins.

This behaves much like matplotlib.pyplot.show and QWidget.show.

update_image(image)[source]

Update displayed image.

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