Image Color Summarizer

RGB, HSV, LCH & Lab image color statistics and clustering—simple and easy
NEW v0.70 — significant changes to the code and output format have been made.
The color summarizer URL has changed to (details)

the image color summarizer

The colour summarizer will produce descriptive colour statistics for an image. Reported will be the average, median, minimum and maximum of each component of RGB, HSV, LCH and Lab. Average hues are calculated using mean of circular quantities.

Some of the questions the summarizer will answer are

The color clustering function tells you the representative colors of the image and shows you how the pixels in the image partition into groups.


LCH is the perceptually uniform equivalent of HSV, and defines colors using intuitive and perceptually-based luminance (perceived brightness), chroma (richness) and hue. If you are doing any kind of image analysis, it's likely that LCH will be much more useful to you than HSV or RGB.

To learn about LCH, see my presentation about color spaces and perceptual uniformity.


If you are a data geek, you'll be happy to know that XML or plain-text API output of the image statistics now includes RGB and HSV histograms, as well as individual pixel values. Munge away!

The purpose of this utility is to generate metadata that summarizes an image's colour characteristics for inclusion in an image database, such as Flickr. In particular this tool is being used to generate metadata for Flickr's Color Fields group.

get started already

If you are curious, see the summarizer run or look at examples. Of course, why not provide your own image for analysis? You should read the FAQ to see how things work.

color summarizer web service

I also provide a simple web service. See a plain-text output or XML output of this analysis.

an example

A little car—lonely, broken and in Havana. I know that feeling.

Here's how the color summarizer describes this image:

altitude antidote aqua beau black blue botticelli bronze brown cod columbia cork dark derby desert drought dust eighth escape geebung goldenrod grey half joss judge jungle kabul malta mash medium metallic millbrook mist moleskin nullarbor pale paperback parchment pizza rich rickshaw road rock rocky rodeo smoky soho sweetwaters triple yellow ziggurat


Image statistics are computed using every pixel in the image. Therefore, analysis of images in which the background is dominant will be skewed by the background color. Specifically, statistics for product images (e.g. an items photographed on a white background) can be difficult to interpret.

The answer to this is to mask areas (e.g. white, or close to white) of the image before carrying out statistics, but this is not implemented. But it will be soon.