WOLFRAM

Wolfram Language & System Documentation Center

PixelValuePositions[image,val]

returns a list of pixel positions in image that exactly match the value val.

PixelValuePositions[image,val,d]

returns all pixel positions that have values within a distance d from val.

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

PixelValuePositions

PixelValuePositions[image,val]

returns a list of pixel positions in image that exactly match the value val.

PixelValuePositions[image,val,d]

returns all pixel positions that have values within a distance d from val.

Details

  • PixelValuePositions finds and returns pixels of specific values in 2D and 3D images and is typically used for locating features or removing artifacts.
  • PixelValuePositions assumes a pixel-aligned coordinate system that is shifted by 0.5 to the left and down with respect to the standard image coordinate system.
  • Use ImageValuePositions to get positions in the standard image coordinate system.
  • The pixel value val can be in one of the following forms:
  • sa scalar
    colora color
    {s1,s2,…}a list of channel values
    "Max"pixels with maximum intensity
    "Min"pixels with minimum intensity
  • In 3D, PixelValuePositions[image,val] returns the positions {xp,yp,zp}, such that pixel position corresponds to the center of the bottom-left front pixel.

Examples

open all close all

Basic Examples  (3)

Extract positions of the white pixels:

Wolfram Language code: PixelValuePositions[[image], 1]

Positions of the pixels with values within the specified distance from white:

Wolfram Language code: PixelValuePositions[[image], White, .05]

Positions of white pixels in a 3D image:

Wolfram Language code: PixelValuePositions[[image], White]

Scope  (4)

Positions of the pixels with maximum intensity:

Wolfram Language code: PixelValuePositions[[image], "Max"]

Positions of the pixels with minimum intensity:

Wolfram Language code: PixelValuePositions[[image], "Min"]

Positions of red pixels:

Wolfram Language code: PixelValuePositions[[image], Red]

Positions of the pixels with values within the specified distance from red:

Wolfram Language code: PixelValuePositions[[image], Red, .1]

Applications  (2)

Extract data coordinates in an image:

Wolfram Language code: img = [image]; pos = PixelValuePositions[img, Green, .1]

Find a best-fit sine function:

Wolfram Language code: FindFit[pos, a Sin[b x] + c, {a, b, c}, x]

Extract coordinates of annotations in a document:

Wolfram Language code: img = [image]; pos = PixelValuePositions[img, Red, 0.35];

Make the handwritten annotations disappear:

Wolfram Language code: HighlightImage[img, {White, pos}]

Properties & Relations  (2)

PixelValuePositions[image,val] is equivalent to PixelValuePositions[image,val,0]:

Wolfram Language code: PixelValuePositions[[image], Gray] == ImageValuePositions[[image], Gray, 0]

PixelValuePositions[image,val] is equivalent to ImageValuePositions[image,val] plus :

Wolfram Language code: PixelValuePositions[[image], Gray, 0.05] == ImageValuePositions[[image], Gray, 0.05] + 0.5
Wolfram Research (2012), PixelValuePositions, Wolfram Language function, https://reference.wolfram.com/language/ref/PixelValuePositions.html.

Text

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

CMS

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

APA

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

BibTeX

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

BibLaTeX

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