3-D multilevel blocked image
specifies additional options, such as the scale factors and interpolation method, using
name-value arguments. For example, specify
mbim = makeMultiLevel3D(
Interpolation="cubic" to use
bicubic interpolation when resizing each level of the image.
bim — Blocked image
Blocked image, specified as a
object containing 3-D image data. If the blocked image has multiple resolution levels,
makeMultiLevel3D uses the image at the finest resolution
Specify optional pairs of arguments as
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.
mbim = makeMultiLevel3D(bim,Interpolation="cubic") resizes
each level using cubic interpolation.
Scales — Scale factors
vector of positive numbers
Scale factors, specified as a vector of positive numbers. If you want the new
multilevel blocked image to include the original blocked image, then include
1 as an element of
[1 0.66 0.5 0.33] creates a 4-level blocked image with
levels that are 1, 0.66, 0.5, and 0.33 times the size of the original
[0.5 0.1] creates a 2-level blocked image with levels
that are 0.5 and 0.1 times the size of the original image.
BlockSize — Block size
3-element vector of positive integers
Block size of data, specified as a 3-element vector of positive integers. The
default value is equal to the block size of
bim at the finest
Interpolation — Interpolation method
"linear" (default) |
Interpolation method, specified as
"cubic". When the method is
"cubic", the function also
OutputLocation — Location of output folder
string scalar | character vector
Location of the output folder, specified as a string scalar or character vector.
UseParallel argument is
OutputLocation as a valid path on the client session, and use
AlternateFileSystemRoots property of the input blocked image
bim to specify the required mapping for worker sessions.
Adapter — Adapter used for writing blocked image data
Adapter used for writing blocked image data, specified as an adapter object with write capabilities. This table lists the supported adapters included with the toolbox.
|Store each block as a binary file in a folder|
|Store blocks in a single HDF5 image|
|Store each block as an HDF5 file in a folder|
|Store blocks in a variable in main memory|
|Store each block as a MAT file in a folder|
You can also specify a custom adapter that performs custom writing operations. For
more information, see
If the source of
bim is in memory, and you do not specify the
OutputLocation argument, then the default adapter is an
adapter. Otherwise, the default value is an
UseParallel — Use parallel processing
0 (default) |
Use parallel processing, specified as
Adapter argument must support parallel
processing. You must specify a valid
This argument requires Parallel Computing Toolbox™.
DisplayWaitbar — Display wait bar
1 (default) |
Display wait bar, specified as
makeMultiLevel3D function displays a wait bar for long-running
operations. If you cancel the wait bar, the
function returns partial output, if available.
mbim — Multilevel blocked image
Multilevel blocked image, returned as a
object. The function orders the levels from finest to coarsest resolution.
If you want to create overview levels for a very large blocked image, consider creating the overview levels in memory, and then combining the original image and the overview levels using the
concatenateLevelsfunction. This approach does not require creating a second copy of the original image.
Introduced in R2023a