ChromaticityPlot

ChromaticityPlot[colspace]

plots a 2D slice of the color space colspace.

ChromaticityPlot[color]

plots the specific color.

ChromaticityPlot[{col1,col2,…}]

plots multiple colors and color spaces.

ChromaticityPlot[image]

plots the pixels of image as individual colors.

ChromaticityPlot[…,refcolspace]

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
    "RGB"RGBColor
    "CMYK"CMYKColor
    "HSB"Hue
    "XYZ"XYZColor
    "LAB"LABColor
    "LCH"LCHColor
    "LUV"LUVColor
    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
  • Possible settings for WhitePoint include:
  • Automaticautomatically determine the white point to use
    Noneno white points
    Allall white points
    "name"use a named white point
    coluse the color col as white point
    {wp1,…}show several white points wpi

Examples

open allclose all

Basic Examples  (2)

Chromaticity plot of the sRGB space:

Compare the gamut of two RGB color spaces:

Scope  (7)

Chromaticity diagram of an ICC profile:

Visualize a random list of RGB colors:

Visualize the pixels of an image:

Visualize the pixels of a 3D image:

Specify the reference color space:

Specify the luminance level:

CIE 1976 UCS (uniform chromaticity scale) diagram:

Visualize distribution of an image's pixels as well as a color space:

Options  (31)

Appearance  (5)

By default, a filled visible spectrum is rendered:

Show the boundary of the visible spectrum only:

Use Appearance->None to remove the visible spectrum:

Use PlotStyle as a suboption to specify a custom style:

Display wavelengths on the visible spectrum using the "Wavelengths"->True suboption:

AspectRatio  (3)

By default, ChromaticityPlot determines the height to width ratio from the plot range:

Make the height the same as the width with AspectRatio1:

Make the height half of the width:

AspectRatioFull adjusts the height and width to tightly fit inside other constructs:

BoundaryStyle  (2)

By default, the boundary style is automatically chosen:

Use a specific style:

Use BoundaryStyle->None to show no boundary:

Specify boundary style for different color spaces:

FillingStyle  (5)

By default, the gamut is not filled:

Fill the gamut:

Filled gamuts of multiple color spaces:

Individually define the filling style for each space:

If the specified list of styles is shorter than the list of color spaces, it is cyclically padded:

FrameLabel  (1)

By default, appropriate labels are displayed for each coordinate:

Specify custom labels:

MaxPlotPoints  (1)

By default, the maximum number of points in the plot is limited:

Show all points:

PlotLegends  (2)

By default, the legends are not shown for one color space:

Show the plot legend:

By default, the legends are shown for gamut comparison:

Turn the legends off:

PlotPoints  (1)

Automatic setting of PlotPoints might not be sufficient for rendering very small regions:

Increase the plot points to see the region:

PlotRange  (3)

By default, the plot range used is sufficient for all the supported color spaces:

The default plot range may be too small for samples from an unbounded space:

Choose a plot range that encompasses everything in the plot:

Choose a custom plot range:

PlotStyle  (1)

By default, each directive or pixel is plotted with its actual color:

Use a custom style:

PlotTheme  (3)

Use a theme with dark background in a high-contrast color scheme:

Change the boundary styles:

Use a monochrome theme:

WhitePoint  (4)

By default, the white point is shown:

Turn the white point off:

White points for multiple spaces:

Show a specific white point:

Show all supported daylight white points:

Applications  (2)

Compare built-in CMYK and an imported CMYK color profile:

Visualize colors in the rainbow color scheme:

Properties & Relations  (1)

Adobe RGB was designed to include most of the colors in the printers' gamuts:

Notice that the sRGB space does not include parts of the U.S. Web coated CMYK space at luminance 0.2:

Wolfram Research (2014), ChromaticityPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot.html (updated 2019).

Text

Wolfram Research (2014), ChromaticityPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot.html (updated 2019).

CMS

Wolfram Language. 2014. "ChromaticityPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/ChromaticityPlot.html.

APA

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

BibTeX

@misc{reference.wolfram_2021_chromaticityplot, author="Wolfram Research", title="{ChromaticityPlot}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/ChromaticityPlot.html}", note=[Accessed: 28-May-2022 ]}

BibLaTeX

@online{reference.wolfram_2021_chromaticityplot, organization={Wolfram Research}, title={ChromaticityPlot}, year={2019}, url={https://reference.wolfram.com/language/ref/ChromaticityPlot.html}, note=[Accessed: 28-May-2022 ]}