returns a list of images where all imagei are made to have conforming properties, including dimensions, data type, color space, and interleaving.


returns all images of the specified spec.


resizes images using the specified fitting method.

Details and Options

  • ConformImages is typically used as a preprocessing step to algorithms that need images that are uniform in some way, such as classification, dimensionality reduction, and assembling into bigger images.
  • ConformImages works with a list of 2D as well as 3D images.
  • Image specification spec can be one of the following:
  • imagetake the conforming properties from image
    sizeimage dimensions specification
    imagetypeimage type as in ImageType
    {spec1,spec2,}specification for multiple properties
  • By default, the smallest imagetype that can represent the data stored in all imagei is used.
  • The following size specifications can be used:
  • wwidth w, using a height to give the median aspect ratio
    {w,h}width and height of the output image
    {w,d,h}width, depth, and height of a 3D image
  • Any of the w, d, and h can be one of the following:
  • valscalar value
    Tiny,Small,Medium,Largepredefined absolute sizes
    ffunction f to be applied to a list of sizes in each dimension
  • ConformImages[{image1,image2,}] resizes all images to have the median width and a height to give the median aspect ratio.
  • Possible values for fitting include:
  • "Fill"fit the smaller dimension; crop the other if necessary
    "Fit"fit the whole image; keep the aspect ratio; pad if necessary
    "Pad"pad and/or crop without resampling
    "Stretch"stretch the image to fit by resampling
    "Letterbox"fit the width; pad and/or crop in other dimensions
    "Pillarbox"fit the height; pad and/or crop in other dimensions
    "Windowbox"fit to the center; pad all sides
  • The default fitting method is "Stretch".
  • ConformImages has the same options as Image and Image3D with the following additions and changes:
  • ColorSpaceAutomaticoutput color space
    ImageSizeAutomaticthe default displayed size of the image
    InterleavingAutomaticwhether to interleave channels
    MagnificationAutomatichow to magnify the displayed image
    PaddingAutomaticmethod used to make same-size images
  • By default, all other option settings are inherited from individual input images, which would be equivalent to option->Inherited.
  • With ColorSpace->Automatic, a color space in which all images can be represented is chosen.
  • With Interleaving->Automatic, interleaving is set to False only if no input image is interleaved.


open allclose all

Basic Examples  (2)

Conform images:

Click for copyable input

Conform 3D images:

Click for copyable input

Scope  (6)

Options  (6)

Applications  (2)

Properties & Relations  (1)

Possible Issues  (1)

See Also

Image  ImageResize  ColorConvert  Image3D

Introduced in 2014