Skip to content

ManiVaultStudio/ImageViewerPlugin

Repository files navigation

Image Viewer Plugin Build Status

Viewer plugin for high dimensional images in the ManiVault visual analytics framework.

git clone git@github.com:ManiVaultStudio/ImageViewerPlugin.git

Drag & drop an image data set from the data hierarchy into an open viewer or right-click a the data hierarchy item and select View -> Image Viewer. You can add multiple images to an image viewer instance and change their visibility and layering order.


Image viewers with open setting panel and single-channel colormapped images (left), a false color RGB image (right top) and a 2D colormapped image (right bottom). Each viewer shows a different high-dimensional image with several dozen data channels.

Next to layering, the image viewer is also capable of automatically layouting image datasets side-by-side (see gallery below). To achieve this, select multiple image datasets from the data hierarchy, right click View -> Images and select from either:

  • Grid layout: images are arranged in a grid
  • Horizontal: images are layed out left-to-right
  • Vertical: images are arranged bottom-to-top-to
  • Stacked: images are layered on top of each other (identical to adding multiple images via drag & drop)

Features

  • Colormapping by dimension/channel:
    • Mono: Using a one-dimensional colormap
    • Duo: Using a two-dimensional colormap
    • RGB/HSL/LAB: map any data channel to any of the respective color space dimensions
    • Adjust brightness and contrast of each mapped dimensions
  • Zoom and pan navigation
  • Value interpolation: Nearest Neighbor and Bilinear
  • Selections:
    • Automatically synchronize selections (default) or delay global notification until manual selection is finished
    • Several selection types: Rectangle (default), Lasso, Brush and Polygon
  • Creating subsets: Create subset from selection
  • Multiple layers:
    • View multiple image data sets
    • Adjust transparency individually
  • Inspect pixel values of all currently rendered channels

Keybindings

Selection

  • R Rectangle (default)
  • L Lasso
  • B Brush, circular: Mouse wheel adjusts the radius
  • P Polygon: left-click to add a vertex, right-click to finish
  • S Sample: single pixel, opens pixel value inspection overlay
  • Shift Add to selection (while pressed)
  • Control Remove from selection (while pressed)

Navigation

  • Spacebar Switch to navigation when in selection mode (while pressed)
  • Mouse grab Pan
  • Mouse wheel Zoom
  • D Zoom around selection
  • Z Reset zoom to overview

Gallery

Have a look at the wiki for more showcases of the image viewer's feature set.


Select multiple images in the data hierarchy to open them side-by-side (left), e.g. in a grid (right)...

...or horizontal (left) as well as vertical (right)


Sample pixel values (left) and multiple imaged stacked (right)