Skip to content

Tour of the viewer

In this tutorial you open several kinds of images, move around them, change how they are displayed and look at them as a heatmap and in 3D. By the end you will know where every group of toolbar buttons is and what it is for.

Time: about 10 minutes. You need: the live demo.

1. Open an image

  1. Open the live demo. The gallery of samples is on the left and the viewer on the right.
  2. Click the sample img01.png (grey muscle tissue).

What you should see: the image fills the viewer. Above it is the toolbar. At the bottom right is the minimap, a small copy of the whole image with a red rectangle marking the part you are looking at.

The viewer with img01.png open: toolbar above, image, minimap at the bottom right

The toolbar is organised in groups, left to right:

Group What it holds
Plot type The dropdown that switches between Image, Heatmap, Surface and the other views
Display Intensity lines, Channels & Histogram, Smoothen
Image actions Download as PNG, Fit to view
Zoom Zoom box, Pan, Zoom in, Zoom out
Regions Region Editor, Selection and the drawing tools, Undo, Redo, Delete
Segmentation Segment (SAM), SAM point prompts, model picker, Cellpose
Help Opens this guide

Hover over any button to see its name and keyboard shortcut. The toolbar reference describes them all.

2. Zoom and pan

  1. Scroll the mouse wheel over a muscle fibre. The image zooms in and out around the pointer.
  2. Click once on the image. It zooms in towards the point you clicked.
  3. Press and drag the image to pan.
  4. Press + and - to zoom in and out one step at a time, around the centre of the view.
  5. Drag the red rectangle in the minimap, or click elsewhere in it, to jump to another part of the image.
  6. Click Fit to view to see the whole image again.

Now try the zoom box:

  1. Press B (or click Zoom box).
  2. Drag a rectangle around a few fibres and release.

What you should see: the view zooms to exactly the box you drew. The tool stays active so you can draw another box. Press B again to turn it off.

3. A gigapixel image and the scale bar

  1. In the gallery, click the tile WSI · CMU-1 · 1.5 Gpx (CC0), an H&E whole-slide image of 1.5 billion pixels.
  2. Zoom in on the tissue. Sharp tiles load as you zoom; you never download the whole image.

What you should see: a scale bar at the bottom left, in µm or mm. It shows only for images that record their pixel size, and its length always stays a round number (1, 2 or 5 times a power of ten).

Whole-slide image with the minimap at the bottom right and the scale bar at the bottom left

4. Raw pixels or smooth

  1. Open img01.png again and zoom in until you can see individual pixels as blocks.
  2. Click Smoothen. The blocks are blended (bilinear smoothing) and the button's icon turns white.
  3. Click it again to go back to raw pixels.

SIV opens images showing raw pixels on purpose, so you can inspect exact pixel values when zoomed in.

5. Brightness, contrast and colours

  1. Click the sample img04.png (cells with blue nuclei and green cytoplasm).
  2. Click Channels & Histogram. A floating dialog opens.

What you should see: a table with the Red, Green and Blue channels, each with a colour swatch and a Show checkbox, then a histogram of the selected channel and the Min, Max and Gamma sliders.

The Channels & Histogram dialog for an RGB image

  1. Untick Show for Green. Only the nuclei remain. Tick it again.
  2. Click the Green row, then drag Max down to about 120. The cytoplasm becomes brighter.
  3. Click Auto. Min and max are set so that 0.1% of pixels are saturated at each end.
  4. Click Reset to undo your contrast changes.
  5. Close the dialog with its ×.

Grayscale images have a Colormap list in the same dialog; you will use it in the how-to guides.

6. Other plot types

  1. Open img01.png and pick Heatmap in the plot-type dropdown. The image is drawn as a heatmap with a colour bar.

img01.png in the Heatmap plot type

  1. Pick Surface. The intensities become a 3D height field. Drag to rotate it; scroll to zoom.
  2. Notice that the zoom buttons were replaced by 3D camera buttons: Zoom, Pan, Orbital rotation, Turntable rotation and Reset camera.
  3. Pick Image to return to the 2D view.

Now a 3D stack:

  1. In the gallery, open the micro-ct folder.
  2. Right-click any slice. The whole folder loads as a z-stack.

What you should see: a Slice slider in the toolbar, reading "z of max". Press Left and Right to step through the slices.

  1. Pick Volume in the plot-type dropdown. After a few seconds the stack is drawn as a 3D volume.
  2. Drag to rotate it.

The micro-CT stack rendered as a 3D volume

The plot-type dropdown only offers what the open image can show. Volume and Isosurface need a z-stack, and Contour needs a grayscale or multichannel image. See Plot types.

7. Move the toolbar out of the way

  1. Press and drag the handle at the far left of the toolbar.
  2. Drop it anywhere over the image. The toolbar now floats.
  3. Click Dock to top to put it back.

What you learned

  • How to open images and find your way around them: wheel, click-to-zoom, drag, zoom box, minimap and Fit to view.
  • Where the scale bar comes from and how to switch between raw and smoothed pixels.
  • How to show or hide channels and adjust min, max and gamma.
  • How the plot-type dropdown changes the view, including the 3D ones.

Next

Continue with Annotate your first image, or read the Navigation and Channels & Histogram reference pages.