Volume Viewer

View volumetric data and labeled volumetric data

expand all in page

Description

The Volume Viewer app enables you to view 3-D volumetric data and 3-D labeled volumetric data. Using this app, you can:

Load 3-D image volumes and labels.
Explore images as 2-D slice planes or 3-D volumes.
Apply preset or custom alphamaps and colormaps to 2-D and 3-D displays.
Export volume rendering and camera settings to apply outside the app.

Note

The app is not supported in MATLAB^® Online™. For details, see Specifications and Limitations.

Open the Volume Viewer App

MATLAB toolstrip: Open the Apps tab, under Image Processing and Computer Vision, click the Volume Viewer app icon.
MATLAB command prompt: Enter volumeViewer.

Examples

expand all

Load Labeled Volume into Volume Viewer

Load a labeled volume into the workspace.

load(fullfile(toolboxdir("images"),"imdata","BrainMRILabeled", ...
    "labels","label_001.mat"));

Open the labeled volume in Volume Viewer. Use the VolumeType name-value argument to identify the volume as a labeled volume.
```
volumeViewer(label,VolumeType="labels")
```

Related Examples

Programmatic Use

volumeViewer opens Volume Viewer.

volumeViewer(V) loads the grayscale volume V into Volume Viewer. V is an array of size m-by-n-by-p, of data type logical, uint8, uint16, uint32, int8, int16, int32, single, or double.

volumeViewer(V,L) loads the grayscale volume V and the labeled volume L into Volume Viewer. L is an array of size m-by-n-by-p, of data type categorical, uint8, uint16, uint32, int8, int16, int32, single, or double.

volumeViewer(___,VolumeType=vtype) loads the volumetric data into the app and defines the type of volume using the VolumeType name-value argument. vtype can be either "Volume" or "Labels". If the volume is of data type categorical, the default volume type is "Labels". For volumes of any other class, the default volume type is "Volume". If you specify both an intensity volume and a labeled volume, then Volume Viewer ignores this name-value argument.

volumeViewer(___,ScaleFactors=sfactors) loads the volumetric data into the app, and resizes the volume using the ScaleFactors name-value argument. sfactors is a 1-by-3 positive numeric vector of the form [x y z], where the values are scale factors applied in the x, y, and z directions. The default value is [1 1 1]. If vtype is "Labels", then Volume Viewer ignores this name-value argument.

volumeViewer close closes all open Volume Viewer apps.

Version History

Introduced in R2017a

expand all

R2026a: Updated toolstrip and enhanced rendering editor

The updated Volume Viewer now:

Displays voxel coordinates and intensity for the point beneath the pointer at the bottom of the app window.
Provides horizontal scrollbars for navigating slice planes and labels that indicate the current slice and total number of slices in that plane.
Supports new rendering styles in the Rendering Editor, including cinematic rendering, minimum intensity projection, gradient opacity, and slice planes.
Supports visualizing and adjusting the opacity of the volume and labels simultaneously by selecting the new View Volume and View Labels buttons in the app toolstrip.
Displays options for importing volume and label data together when you select Import in the app toolstrip.