blockedImage
Description
A blockedImage
object is an image made from discrete blocks. You
can use a blocked image to:
Process multiresolution (also known as multilevel or pyramidal) images
Process images, volumes, or multidimensional images that are too large to fit into memory
Process volumes or multidimensional images as 3-D or higher-dimensional blocks
Perform block processing on images in nonstandard image formats
Creation
Syntax
Description
Create Read-only blockedImage
Object
[bim1,bim2,...] = blockedImage(
creates an array of sources
)blockedImage
objects from multiple sources. The
sources can be a collection of files or folders with image data. The number of blocked
images is equal to the number of sources.
[___] = blockedImage(___,Name=Value)
creates a blockedImage
object and sets one or more of the Adapter
, AlternateFileSystemRoots
,
BlockSize
,
UserData
,
WorldStart
,
WorldEnd
properties using name-value arguments.
Create Writable blockedImage
Object
bim = blockedImage(
creates a writeable destination
,size
,blockSize
,initialValue
,Mode="w")blockedImage
object at one or multiple resolution
levels. destination
specifies the location of the writable data.
size
and blockSize
indicate the image size
and the block size, respectively, at each resolution level.
initialValue
indicates the initial value for each array element.
The size
, blockSize
, and
initialValue
arguments set the Size
, BlockSize
,
and InitialValue
properties,
respectively.
bim = blockedImage(
creates a writeable destination
,size
,blockSize
,initialValue
,Mode="w",Name=Value)blockedImage
object and sets one or more of the
Adapter
, AlternateFileSystemRoots
,
UserData
,
WorldStart
,
WorldEnd
properties using name-value arguments.
Input Arguments
Properties
Object Functions
apply | Process blocks of blocked image |
concatenateLevels | Concatenate levels from multiple blocked images |
crop | Create cropped version of blocked image |
blocksub2sub | Convert block subscripts to pixel subscripts |
gather | Collect blocks into current workspace |
getBlock | Read specific block of blocked image |
getRegion | Read arbitrary region of blocked image |
setBlock | Put data in specific block of blocked image |
makeMultiLevel2D | 2-D multilevel blocked image |
makeMultiLevel3D | 3-D multilevel blocked image |
sub2blocksub | Convert pixel subscripts to block subscripts |
sub2world | Convert pixel subscripts to block subscripts |
world2sub | Convert world coordinates to pixel subscripts |
write | Write blocked image data to new destination |
Examples
Tips
The
blockproc
function is an alternative toblockedImage
for processing 2-D blocks of single-resolution in-memory images.