imresize3

Resize 3-D volumetric intensity image

Syntax

B = imresize3(V,scale)

B = imresize3(V,[numrows numcols numplanes])

B = imresize3(___,method)

B = imresize3(___,Name,Value)

Description

B = imresize3(V,scale) returns the volume B that is scale times the size of 3-D numeric or categorical volume V.

B = imresize3(V,[numrows numcols numplanes]) returns the volume B that has the number of rows, columns, and planes specified by the 3-element vector [numrows numcols numplanes].

B = imresize3(___,method) returns the volume B, where method specifies the interpolation method used.

B = imresize3(___,Name,Value) returns a resized volume where Name,Value pairs control aspects of the operation.

Examples

Resize 3-D Volumetric Image

Read MRI volume into the workspace.

s = load('mri');
mriVolumeOriginal = squeeze(s.D);
sizeO = size(mriVolumeOriginal);

Visualize the volume.

figure;
slice(double(mriVolumeOriginal),sizeO(2)/2,sizeO(1)/2,sizeO(3)/2);
shading interp, colormap gray;
title('Original');

Resize the volume, reducing the size of all dimensions by one-half. This example uses the default interpolation method and antialiasing.

mriVolumeResized = imresize3(mriVolumeOriginal, 0.5);
sizeR = size(mriVolumeResized);

Visualize the resized volume.

figure;
slice(double(mriVolumeResized),sizeR(2)/2,sizeR(1)/2,sizeR(3)/2);
shading interp, colormap gray;
title('Resized');

Input Arguments

V — Volume to be resized

3-D numeric array | 3-D categorical array

Volume to be resized, specified as a 3-D numeric array or 3-D categorical array.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | categorical

scale — Scale factor

numeric scalar

Scale factor, specified as a numeric scalar.

• If scale is less than 1, then the output image is smaller than the input volume.

• If scale is greater than 1, then the output image is larger than the input volume.

imresize3 applies the scale factor to each dimension in the volume. To apply a different resize factor to each dimension, use the Scale name-value pair argument.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

[numrows numcols numplanes] — Size of output volume

3-element vector of positive integers

Size of output volume, specified as a 3-element vector of positive integers in the form [rows columns planes]. If you specify one numeric value and the other two values as NaNs, then imresize3 computes the other two elements automatically to preserve the aspect ratio.

Data Types: single | double

method — Interpolation method

"nearest" | "linear" | "box" | "triangle" | "lanczos2" | "lanczos3"

Interpolation method, specified as one of the values in the following table that identifies a general method or a named interpolation kernel.

Method	Description
"nearest"	Nearest-neighbor interpolation. Nearest-neighbor interpolation is the only interpolation method supported for categorical images and it is the default method for images of this type.
"linear"	Linear interpolation
"cubic"	Cubic interpolation. Cubic interpolation is the default for numeric volumes. Note Cubic interpolation can produce pixel values outside the original range.
Interpolation Kernel	Description
"box"	Box-shaped kernel. The box-shaped kernel is the only interpolation kernel supported for categorical images.
"triangle"	Triangular kernel (equivalent to "linear")
"lanczos2"	Lanczos-2 kernel
"lanczos3"	Lanczos-3 kernel

Data Types: char | string

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "Antialiasing",false

Antialiasing — Perform antialiasing when shrinking a volume

true | false

Perform antialiasing when shrinking a volume, specified as true or false.

• If method is "nearest", then the default value of Antialiasing is false.

• If the interpolation method is the "box" interpolation kernel and the input volume is categorical, then the default value of Antialiasing is false.

• For all other interpolation methods, the default value of Antialiasing is true.

Data Types: logical

Method — Interpolation method

"cubic" (default) | string scalar | character vector

Interpolation method, specified as a string scalar or character vector. For details, see method.

Data Types: char | string

OutputSize — Size of output volume

3-element vector of positive integers

Size of the output volume, specified as a 3-element vector of positive integers of the form [rows cols planes].

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Scale — Resize scale factor

positive number | 3-element vector of positive numbers

Resize scale factor, specified as a positive number or 3-element vector of positive numbers. If you specify a scalar, then imresize3 applies the same scale factor to each dimension in the volume. If you specify a 3-element vector, then imresize3 applies a different scale value to each dimension.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

B — Resized volume

array

Resized volume, returned as an array of the same class as the input volume, V.

Extended Capabilities

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2017a

R2021b: Support for thread-based environments

imresize3 now supports thread-based environments.