Skip to Main Content Skip to Search
Product Documentation

imhist - Display histogram of image data

Syntax

imhist(I)
imhist(I, n)
imhist(X, map)
[counts,x] = imhist(...)

Description

imhist(I) displays a histogram for the image I above a grayscale colorbar. The number of bins in the histogram is specified by the image type. If I is a grayscale image, imhist uses a default value of 256 bins. If I is a binary image, imhist uses two bins.

imhist(I, n) displays a histogram where n specifies the number of bins used in the histogram. n also specifies the length of the colorbar. If I is a binary image, n can only have the value 2.

imhist(X, map) displays a histogram for the indexed image X. This histogram shows the distribution of pixel values above a colorbar of the colormap map. The colormap must be at least as long as the largest index in X. The histogram has one bin for each entry in the colormap.

[counts,x] = imhist(...) returns the histogram counts in counts and the bin locations in x so that stem(x,counts) shows the histogram. For indexed images, imhist returns the histogram counts for each colormap entry; the length of counts is the same as the length of the colormap.

Tips

For intensity images, the n bins of the histogram are each half-open intervals of width A/(n−1). In particular, for intensity images that are not int16, the pth bin is the half-open interval

where x is the intensity value. For int16 intensity images, the pth bin is the half-open interval

where x is the intensity value. The scale factor A depends on the image class. A is 1 if the intensity image is double or single, A is 255 if the intensity image is uint8, and A is 65535 if the intensity image is uint16 or int16.

Class Support

An input intensity image can be of class uint8, int8, uint16, int16, uint32, int32, single, double, or logical. An input indexed image can be of class uint8, uint16, single, double, or logical.

Examples

I = imread('pout.tif');
imhist(I)

See Also

hist | histeq

  


Recommended Products

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS