WOLFRAM

Wolfram Language & System Documentation Center

ImagePartition[image,s]

partitions an image into an array of ss-pixel subimages.

ImagePartition[image,{w,h}]

partitions an image into an array of subimages of pixel width w and pixel height h.

ImagePartition[image,{w,h},{dw,dh}]

uses pixel offsets dw and dh.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Data  
Parameters  
Options  
Padding  
Applications  
Properties & Relations  
Neat Examples  
See Also
Related Guides
History
Cite this Page

ImagePartition

ImagePartition[image,s]

partitions an image into an array of ss-pixel subimages.

ImagePartition[image,{w,h}]

partitions an image into an array of subimages of pixel width w and pixel height h.

ImagePartition[image,{w,h},{dw,dh}]

uses pixel offsets dw and dh.

Details and Options

  • ImagePartition returns an array of smaller overlapping or non-overlapping subimages.
  • ImagePartition works with 2D and 3D images.
  • ImagePartition by default picks out non-overlapping subimages.
  • ImagePartition[image,s] generates as many ss subimages as possible, dropping incomplete subimages at the edges.
  • ImagePartition[image,{s}] instead includes incomplete subimages at the edges.
  • In ImagePartition[image,{wspec,hspec},…], the following forms can be used for wspec and hspec:
  • sallow only size s
    UpTo[s]allow any size up to s
    Scaled[a]allow a multiple a of the size
    {Scaled[a]}allow any size up to the multiple a of the size
    {smin,smax}allow any size smin through smax
  • ImagePartition supports the option Padding.
  • The default setting is Padding->None, which drops subimages at the edges whose sizes are not consistent with {wspec,hspec}.

Examples

open all close all

Basic Examples  (1)

Partition an image into blocks of size 16 by 16:

Wolfram Language code: ImagePartition[[image], 16] // Grid

Scope  (5)

Data  (2)

Partition a color image into equal-size blocks, dropping some pixels at the borders:

Wolfram Language code: ImagePartition[ [image], 32]// Grid

Partition a 3D image:

Wolfram Language code: ImagePartition[[image], {40}]

Parameters  (3)

Specify the partition size using scaled dimensions:

Wolfram Language code: ImagePartition[[image], Scaled[1 / 3]]//Grid

Partition into blocks not larger than the specified scaled dimensions:

Wolfram Language code: ImagePartition[[image], {Scaled[1 / 3]}]//Grid

Specify different scaled dimensions in horizontal and vertical directions:

Wolfram Language code: ImagePartition[[image], Scaled[{1 / 3, 1 / 2}]]//Grid

Options  (1)

Padding  (1)

By default, Padding->None is used:

Wolfram Language code: i = [image]; ImagePartition[i, 45]//Grid

Pad the image with a specified color:

Wolfram Language code: ImagePartition[i, 45, Padding -> Red]//Grid

Specify a different padding scheme:

Wolfram Language code: ImagePartition[i, 45, Padding -> "Fixed"]//Grid

Applications  (3)

Ordinal measurement descriptor of an image:

Wolfram Language code: i = [image];

Partition the image into subimages:

Wolfram Language code: list = Flatten[ImagePartition[i, {Scaled[1 / 8]}]]

Compute the ordering of mean intensity of each image:

Wolfram Language code: SortBy[list, ImageMeasurements[#, "MeanIntensity"]&]

Add some spacing between image partitions:

Wolfram Language code: i = [image];
Wolfram Language code: ImagePad[ImageAssemble[ImagePartition[i, {Scaled[1 / 4]}] /. i_Image :> ImagePad[i, 5, Gray]], 5, Automatic]

Add spacing between 3D partitions:

Wolfram Language code: engine = ExampleData[{"TestImage3D", "CTengine"}]
Wolfram Language code: ImageAssemble[ImagePartition[engine, {Scaled[1 / 2]}] /. i_Image3D :> ImagePad[i, 20, 0]]

Properties & Relations  (1)

ImagePartition and ImageAssemble are reverse operations:

Wolfram Language code: i = RandomImage[1, {10, 10}]; ImageDistance[i, ImageAssemble[ImagePartition[i, {25}]]]

Neat Examples  (1)

Create a mosaic effect by averaging colors in small partitions:

Wolfram Language code: Map[MeanFilter[#, 10]&, ImagePartition[[image], 10], {2}]//ImageAssemble
Wolfram Research (2008), ImagePartition, Wolfram Language function, https://reference.wolfram.com/language/ref/ImagePartition.html (updated 2015).

Text

Wolfram Research (2008), ImagePartition, Wolfram Language function, https://reference.wolfram.com/language/ref/ImagePartition.html (updated 2015).

CMS

Wolfram Language. 2008. "ImagePartition." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/ImagePartition.html.

APA

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

BibTeX

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

BibLaTeX

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