WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

ConformImages
✖
ConformImages

✖
ConformImages[{image1,image2,…}]

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

✖
ConformImages[{image1,image2,…},spec]

returns all images of the specified spec.

✖
ConformImages[{image1,image2,…},spec,fitting]

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
    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:
  • ColorSpace Automaticoutput color space
    ImageSizeAutomaticthe default displayed size of the image
    InterleavingAutomaticwhether to interleave channels
    MagnificationAutomatichow to magnify the displayed image
    Padding Automaticmethod 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.

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Conform images:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-litgd7
Out[1]=1

Conform 3D images:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-hisoke
Out[1]=1

Scope  (6)Survey of the scope of standard use cases

Image Size  (1)

Conform image sizes using automatic sizing:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-62ga6i
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-xawv2r
Out[2]=2

Conform to a specific size:

In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-yykcdg
Out[3]=3

Conform each image to have the maximum width and automatic height:

In[4]:=4
✖
https://wolfram.com/xid/0dqugdjm7vo-k0vkd9
Out[4]=4

Use smallest width and height:

In[5]:=5
✖
https://wolfram.com/xid/0dqugdjm7vo-nstoi8
Out[5]=5

Use smallest width and largest height:

In[6]:=6
✖
https://wolfram.com/xid/0dqugdjm7vo-elptiw
Out[6]=6

Image Properties  (3)

Specify the common data type:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-j71kl6
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-3wo6e8
Out[2]=2

Specify both size and data type:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-to8e9y
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-5lee59
Out[2]=2

Use an image to specify conforming properties:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-0n1jut
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-hv8tjp
Out[2]=2

Fitting Methods  (2)

By default, images are stretched to fit in the common size:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-b6w5tj
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-ikdv6z
Out[2]=2

Specify a different fitting method:

In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-u7ibn4
Out[3]=3

Conform properties of a list of 3D images:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-9jx12f
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-cefw5z
Out[2]=2

Options  (6)Common values & functionality for each option

Boxed  (1)

For 3D images, the Boxed option is inherited from original images:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-gktwwi
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-r7legl
Out[2]=2

Use Boxed->True for all images:

In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-qq13a4
Out[3]=3

ColorFunction  (2)

By default, ColorFunction is set to Automatic:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-q6mjev
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-ih06zh
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-gqfn9w
Out[3]=3

Specify the output color function:

In[4]:=4
✖
https://wolfram.com/xid/0dqugdjm7vo-26n9x9
Out[4]=4

ColorFunction is set to Automatic if the input and output color spaces do not match:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-tcrsto
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-3uh3qx
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-0n8txb
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0dqugdjm7vo-7dfldm
Out[4]=4

ColorSpace  (1)

By default, a color space that can store the most image information is selected:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-cawuc6
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-bqwakg
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-ffvjhs
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0dqugdjm7vo-x8uvlv
Out[4]=4

Specify the output color space:

In[5]:=5
✖
https://wolfram.com/xid/0dqugdjm7vo-klbozp
Out[5]=5
In[6]:=6
✖
https://wolfram.com/xid/0dqugdjm7vo-x7ibpv
Out[6]=6

Padding  (2)

Default padding value is chosen based on the fitting method:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-coc6vl

With "Pad" fitting method, a common border color is used when available. Otherwise black is used:

In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-nowagz
Out[2]=2

Specify the padding value:

In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-4y1uuh
Out[3]=3

Black padding is used with "Letterbox", "Pillarbox", and "Windowbox" fitting methods:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-ychwvx
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-2wobo
Out[2]=2

Applications  (2)Sample problems that can be solved with this function

Conform a list of face images:

In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-hsrybq
Out[2]=2

Assemble an array of images:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-vusqn1
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-j1rjy2
Out[2]=2

Properties & Relations  (1)Properties of the function, and connections to other functions

For multichannel images with a different number of channels, the maximum number of channels is used:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-oi9f3w
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-igoq0f
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-f6st1b
Out[3]=3

Zero is used for non-existing channels:

In[4]:=4
✖
https://wolfram.com/xid/0dqugdjm7vo-rgewrv
Out[4]=4

Possible Issues  (1)Common pitfalls and unexpected behavior

For images with ColorSpace->Automatic, pixel values with fewer channels are zero padded:

In[1]:=1
✖
https://wolfram.com/xid/0dqugdjm7vo-cya5ho
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0dqugdjm7vo-62jfi2
Out[2]=2

Specify the output ColorSpace:

In[3]:=3
✖
https://wolfram.com/xid/0dqugdjm7vo-bnwlso
Out[3]=3
Wolfram Research (2014), ConformImages, Wolfram Language function, https://reference.wolfram.com/language/ref/ConformImages.html.
✖
Wolfram Research (2014), ConformImages, Wolfram Language function, https://reference.wolfram.com/language/ref/ConformImages.html.

Text

Wolfram Research (2014), ConformImages, Wolfram Language function, https://reference.wolfram.com/language/ref/ConformImages.html.

✖
Wolfram Research (2014), ConformImages, Wolfram Language function, https://reference.wolfram.com/language/ref/ConformImages.html.

CMS

Wolfram Language. 2014. "ConformImages." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ConformImages.html.

✖
Wolfram Language. 2014. "ConformImages." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ConformImages.html.

APA

Wolfram Language. (2014). ConformImages. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ConformImages.html

✖
Wolfram Language. (2014). ConformImages. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ConformImages.html

BibTeX

@misc{reference.wolfram_2025_conformimages, author="Wolfram Research", title="{ConformImages}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/ConformImages.html}", note=[Accessed: 20-April-2025 ]}

✖
@misc{reference.wolfram_2025_conformimages, author="Wolfram Research", title="{ConformImages}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/ConformImages.html}", note=[Accessed: 20-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_conformimages, organization={Wolfram Research}, title={ConformImages}, year={2014}, url={https://reference.wolfram.com/language/ref/ConformImages.html}, note=[Accessed: 20-April-2025 ]}

✖
@online{reference.wolfram_2025_conformimages, organization={Wolfram Research}, title={ConformImages}, year={2014}, url={https://reference.wolfram.com/language/ref/ConformImages.html}, note=[Accessed: 20-April-2025 ]}