WOLFRAM

Wolfram Language & System Documentation Center

ImageStitch[{image1,image2,…}]

gives a composed image from an unordered list of imagei.

ImageStitch[{{image11,image12,…},{image21,image22,…},…}]

returns a stitched image from a matrix of images imageij, according to their array position.

ImageStitch[images,canvas]

projects the stitched image onto the geometry specified by canvas.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Canvas  
Options  
Method  
TransformationClass  
Applications  
Properties & Relations  
Possible Issues  
See Also
Related Guides
History
Cite this Page

ImageStitch

ImageStitch[{image1,image2,…}]

gives a composed image from an unordered list of imagei.

ImageStitch[{{image11,image12,…},{image21,image22,…},…}]

returns a stitched image from a matrix of images imageij, according to their array position.

ImageStitch[images,canvas]

projects the stitched image onto the geometry specified by canvas.

Details and Options

  • ImageStitch merges overlapping images into a single image. It is typically used when larger scenes are acquired through smaller subimages, such as a panoramic image of a scene, a sample under a microscope or satellite images of the Earth.
  • Images are always stitched together to show the object or scene as a 2D image.
  • By default, the most suitable canvas geometry is chosen.
  • Possible projection canvas geometries are:
  • "Plane"planar stitching
    "Cylinder"rolled out cylindrical projection
    "Sphere"return an equirectangular projection
  • By default, the center of gaze is assumed to be the center of the stitched image.
  • The stitched image will have the same orientation as the most central subimage.
  • To specify the center of gaze and orientation of the resulting image, additional canvas specifications are:
  • {"canvas",n}places the center of gaze at the center of the n^(th) image
    {"canvas",n{x,y}}center of gaze at the {x,y} position in the n^(th) image
    {"canvas",n{x,y},α}rotates the image vertical by angle
    {"canvas",n{x1,y1},m{x2,y2}}rotates the image such that {x1,y1} of the n^(th) image and {x2,y2} of the m^(th) image fall on a horizontal line
  • The following options can be specified:
  • Method Automaticsettings to use for stitching
    TransformationClass Automaticgeometrical relation between images
  • The Method option can be used to specify the following settings:
  • "HistogramEqualization"Truewhether to perform brightness equalization on images
    "ImageBlending""Feathering"the method to blend images
    "KeypointMethod"Automaticthe ImageCorrespondingPoints method
  • Possible settings for "ImageBlending" are "Feathering" (default), {"Feathering",σ} or None.

Examples

open all close all

Basic Examples  (1)

Stitch together a list of images:

Wolfram Language code: imgs = {[image], [image], [image], [image], [image], [image], [image], [image], [image]};
Wolfram Language code: ImageStitch[imgs]

Scope  (1)

Canvas  (1)

By default, the most suitable canvas is automatically chosen:

Wolfram Language code: imgs = {[image], [image], [image]};
Wolfram Language code: ImageStitch[imgs]

Enforce a planar stitching:

Wolfram Language code: ImageStitch[imgs, "Plane"]

Enforce cylindrical stitching:

Wolfram Language code: ImageStitch[imgs, "Cylinder"]

Perform spherical stitching:

Wolfram Language code: ImageStitch[imgs, "Sphere"]

Specify the center of gaze to be the coordinate in the third image:

Wolfram Language code: ImageStitch[imgs, {"Plane", 3 -> {50, 120}}]

Options  (3)

Method  (2)

By default, feathering is applied to image boundaries to blend stitched images:

Wolfram Language code: images = {[image], [image], [image]};
Wolfram Language code: ImageStitch[images, Method -> {"ImageBlending" -> "Feathering"}]

Specify the scale of image blending:

Wolfram Language code: ImageStitch[images, Method -> {"ImageBlending" -> {"Feathering", 20}}]

Turn off image blending:

Wolfram Language code: ImageStitch[images, Method -> {"ImageBlending" -> None}]

By default, histogram equalization is performed on images:

Wolfram Language code: list = {[image], [image], [image], [image]};
Wolfram Language code: ImageStitch[list]

Turn off the histogram equalization:

Wolfram Language code: ImageStitch[list, Method -> {"HistogramEqualization" -> False}]

TransformationClass  (1)

By default, the transformation class is automatically picked:

Wolfram Language code: images = {[image], [image], [image]};
Wolfram Language code: ImageStitch[images]

Use a specific transformation:

Wolfram Language code: ImageStitch[images, TransformationClass -> "Rigid"]

Applications  (5)

Stitch images with different orientations:

Wolfram Language code: ImageStitch[{[image], [image], [image]} ]

Stitch an array of scanned microscopy images:

Wolfram Language code: grid = {{[image], [image], [image], [image]}, {[image], [image], [image], [image]}, {[image], [image], [image], [image]}};
Wolfram Language code: ImageStitch[grid, TransformationClass -> "Rigid"]

Stitch a sequence of aerial photographs:

Wolfram Language code: ImageStitch[{[image], [image], [image]}]

A vertical panorama of a sequoia tree:

Wolfram Language code: ImageStitch[{[image], [image], [image]}]

Stitch images including some camera rotations:

Wolfram Language code: ImageStitch[{[image], [image], [image]}]

Properties & Relations  (1)

Different images may have captured parts of the scene with different exposures:

Wolfram Language code: ImageStitch[{[image], [image], [image], [image], [image], [image], [image], [image], [image]}]

Perform color tone mapping to make larger parts of the resulting image visible:

Wolfram Language code: ColorToneMapping[%, Method -> "LogLuminance"]

Possible Issues  (1)

Images taken from different view points can introduce varying parallax that perspective transforms cannot handle, and stitching may produce artifacts:

Wolfram Language code: ImageStitch[{[image], [image], [image], [image]}]
Wolfram Research (2021), ImageStitch, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageStitch.html (updated 2022).

Text

Wolfram Research (2021), ImageStitch, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageStitch.html (updated 2022).

CMS

Wolfram Language. 2021. "ImageStitch." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/ImageStitch.html.

APA

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

BibTeX

@misc{reference.wolfram_2026_imagestitch, author="Wolfram Research", title="{ImageStitch}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/ImageStitch.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_imagestitch, organization={Wolfram Research}, title={ImageStitch}, year={2022}, url={https://reference.wolfram.com/language/ref/ImageStitch.html}, note=[Accessed: 13-June-2026]}