assembles a single image from an array of images.


assembles images using the fitting method.

Details and Options

  • ImageAssemble assembles an array of 2D or 3D images into a single image.
  • ImageAssemble creates a collage from an array images, which can be used to compare the effects of one or two parameters on an image, or to visualize different steps of a procedure.
  • ImageAssemble[{image1,image2,}] assembles the imagei as a row.
  • By default, using no fitting specification, the imageij should have commensurate sizes.
  • Possible settings for fitting include:
  • Nonedo not attempt to match the dimensions
    "Fill"fit the smaller dimension; crop the other if necessary
    "Fit"fit the whole image; keep the aspect ratio; pad if necessary
    "Stretch"stretch the image to fit by resampling
  • If any imageij is Missing[], corresponding pixels are replaced with the background color.
  • The following options can be specified:
  • Background Automaticbackground color to use
    PaddingSize 0padding size around the whole image
    ResamplingAutomaticresampling method to use
    Spacings 0spacing between images
  • Settings for Spacings can have the following forms:
  • specapply spec to all gaps between images
    {specx,specy,}applies specific spacing for each dimension


open allclose all

Basic Examples  (2)

Assemble a 2D array of images:

Show the result of edge detection using varying radius and threshold values:

Scope  (11)

Data  (7)

Assemble a row of images:

Assemble a column of images:

Assemble an array of images:

Assemble images of different types and color spaces:

The data may contain missing elements:

The rows and columns with only Missing elements are skipped:

Assemble a list of 3D images:

Fitting  (4)

Assemble images of commensurate sizes:

Assemble images of different sizes fitting the larger dimension:

Assemble images of different sizes fitting the smaller dimension:

Assemble images of different sizes by resizing them:

Options  (9)

Background  (2)

The value of Background is used for whole-image padding as well as spacing. By default, 0 is used:

Specify the background color:

Setting Background to Transparent will result in an image with an alpha channel:

PaddingSize  (2)

By default, the whole image is not padded:

Use PaddingSize to pad the whole image:

Use Background to specify the padding scheme:

Specify a different padding size for each side in the form {{left,right},{bottom,top}}:

Spacings  (5)

By default, no spacing is added between images:

Specify the amount of spacings:

Specify different spacings in and directions:

The value of Background specifies the color of spacings between images:

Specify spacings in three dimensions for arrays of rank 3:

Applications  (7)

Search the web for some images:

Assemble images by cropping them to commensurate sizes:

Assemble different steps of fractal sets:

Assemble a collection of Delacroix's artworks:

Assemble images smoothly by assembling at different scales using image pyramids:

Create image pyramids:

Merge at all scales:

Reconstruct the image:

Compare with the single scale assembly:

Assemble together different effects applied to an image:

Explore the effect of an increasing filter radius on successive slices of an image:

Detect and highlight object in frames from a video:

Check which frame contains a dog:

Create a visualization of which frames contain a dog:

Properties & Relations  (2)

ImageAssemble and ImagePartition are reverse operations:

By default, ImageAssemble requires images to have commensurate sizes:

Use the fitting argument to preprocess the set:

Use ConformImages to perform custom fitting:

Wolfram Research (2008), ImageAssemble, Wolfram Language function, (updated 2020).


Wolfram Research (2008), ImageAssemble, Wolfram Language function, (updated 2020).


Wolfram Language. 2008. "ImageAssemble." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020.


Wolfram Language. (2008). ImageAssemble. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_imageassemble, author="Wolfram Research", title="{ImageAssemble}", year="2020", howpublished="\url{}", note=[Accessed: 12-July-2024 ]}


@online{reference.wolfram_2024_imageassemble, organization={Wolfram Research}, title={ImageAssemble}, year={2020}, url={}, note=[Accessed: 12-July-2024 ]}