ImageLevels

ImageLevels[image]
gives a list of pixel values and counts for each channel in image.

ImageLevels[image,bspec]
bins pixel values using bin specification bspec.

ImageLevels[image,bspec,range]
gives counts for bins in the given range.

Details and OptionsDetails and Options

  • ImageLevels returns a list of levels for each channel in the form , where counts the values satisfying , except for the last bin, which uses .
  • Binary images have the form .
  • ImageLevels works with arbitrary grayscale and multichannel 2D and 3D images.
  • The binning specification bspec, which by default uses 256 levels, can be any of the following:
  • nn equally spaced bins
    Automaticautomatic choice of binning
    Allreturn tally of all available pixel values
    "Byte"256 levels after converting data values to a type
  • The range can be of the following forms:
  • Automaticautomatic ranges depending on the color space
    Allinclude all values for each channel
    {All,max}include values below max
    {min,All}include values above min
    {min,max}include values between min and max
    {range1,}different ranges for each channel
  • The following defaults are used for range, depending on the image color space. The ranges are chosen to include the subspace of the color space.
  • "Grayscale","RGB","CMYK","HSB"
    "XYZ"
    "LAB"
    "LCH"
    "LUV"
  • The following options can be specified:
  • Method"IncludeOutOfRange"method to use
  • Possible settings for Method include:
  • "IncludeOutOfRange"values below range in first bin and values above range in last bin
    "ExcludeOutOfRange"do not count out-of-range values
Introduced in 2010
(8.0)
| Updated in 2014
(10.0)