plots a 2D slice of the color space colspace.


plots the specific color.


plots multiple colors and color spaces.


plots the pixels of image as individual colors.


uses the reference color space refcolspace.

Details and Options

  • ChromaticityPlot is typically used to visualize one or several color spaces compared to the visual spectrum. It is also used to visualize one or several colors in an image.
  • ChromaticityPlot converts the color coordinates in colspace to coordinates in refcolspace color space and displays a slice given by constant luminance 0.01. For an individual color, the resulting converted color is projected to the slice of constant luminance.
  • Color specification color can be any color directive or a color neighborhood given as a ColorsNear object.
  • Possible colspace values that can also be a ColorSpace option setting are:
  • "Grayscale"GrayLevel
    ColorProfileData[][i]color profile with the specified rendering intent
  • Other possible colspace values:
  • "AdobeRGB"Adobe RGB (1998) color space
    "AppleRGB"Apple RGB color space
    "CIERGB"CIE RGB color space
    "ProPhotoRGB"ProPhoto RGB
    "sRGB"standard sRGB color space
    "WideGamutRGB"large gamut RGB (a.k.a. Adobe Wide Gamut RGB)
  • Possible refcolspace specifications include:
  • "CIE31"CIE 1931 xy chromaticity diagram (default)
    "CIE76"CIE 1976 UCS chromaticity diagram
    {"ref",l}any of the above spaces at luminance
  • Luminance is the Y coordinate of the XYZ space.
  • Colors or image pixels are rendered as black points if their luminance is the same as the reference luminance and as gray points otherwise.
  • ChromaticityPlot accepts all Graphics options with the following additions and changes:
  • AppearanceAutomaticappearance of visible spectrum
    BoundaryStyleAutomaticthe style for the boundary of each region
    FillingStyleAutomaticfilling style for each color space
    FrameTruewhether to show the frame
    FrameLabelAutomaticframe labels
    MaxPlotPoints2000maximum number of colors or pixels to show
    PlotLegendsAutomaticlegends for each space
    PlotPointsAutomaticinitial number of sample points
    PlotRangeAutomaticthe range of values to include in the plot
    PlotRangeClippingTruewhether to clip at the plot range
    PlotStyleAutomaticspecify the style for colors and images
    PlotTheme$PlotThemeoverall theme for the plot
    WhitePointAutomaticwhat white point to show
  • Possible settings for Appearance are:
  • Nonedo not show the visible spectrum
    Automaticautomatically determine appearance
    "VisibleSpectrum"curve corresponding to the visible spectrum
    "FilledVisibleSpectrum"filled visible spectrum (default)
  • Typical settings for PlotLegends include:
  • Noneadd no legend
    Automaticuse automatic legending
    "Expressions"use colspace name as legend labels
    {lbl1,lbl2,}use lbli for the i^(th) input
    Placed[lspec,]specify placement of legend


open all close all

Basic Examples  (2)

Chromaticity plot of the sRGB space:

Click for copyable input

Compare the gamut of two RGB color spaces:

Click for copyable input

Scope  (7)

Options  (28)

Applications  (2)

Properties & Relations  (1)

Introduced in 2014
Updated in 2019