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 also known as chromatic diagram.
  • 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:
  • Appearance Automaticappearance of visible spectrum
    BoundaryStyle Automaticthe style for the boundary of each region
    FillingStyle Automaticfilling style for each color space
    Frame Truewhether to show the frame
    FrameLabel Automaticframe labels
    MaxPlotPoints 2000maximum number of colors or pixels to show
    PlotLegends Automaticlegends for each space
    PlotPoints Automaticinitial number of sample points
    PlotRange Automaticthe range of values to include in the plot
    PlotRangeClippingTruewhether to clip at the plot range
    PlotStyle Automaticspecify the style for colors and images
    PlotTheme $PlotThemeoverall theme for the plot
    WhitePoint Automaticwhat 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  (72)

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:

Axes  (3)

By default, ChromaticityPlot uses a frame instead of axes:

Use axes instead of a frame:

Turn each axis on individually:

AxesLabel  (3)

Axes are not labeled by default:

Place a label on the y axis:

Specify axes labels:

AxesOrigin  (2)

The position of the axes is determined automatically:

Specify an explicit origin for the axes:

AxesStyle  (4)

Change the style of the axes:

Specify the style of each axis:

Use different styles for the ticks and the axes:

Use different styles for the labels and the axes:

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:

Frame  (4)

ChromaticityPlot uses a frame by default:

Use FrameFalse to turn off the frame:

Draw the frame on the left and right edges:

Draw the frame on the left and bottom edges:

FrameLabel  (5)

By default, appropriate labels are displayed for each coordinate:

Place a label along the bottom frame of the chart:

Frame labels are placed on the bottom and left frame edges by default:

Place labels on each of the edges in the frame:

Use a customized style for both labels and frame tick labels:

FrameStyle  (2)

Specify a style for the frame:

Specify style for each frame edge:

FrameTicks  (6)

Frame ticks are placed automatically by default:

By default, the top and right edges have tick marks but no tick labels:

Use All to include tick labels on all edges:

Place tick marks at specific positions:

Draw frame tick marks at the specified positions with specific labels:

Specify the lengths for tick marks as a fraction of the graphics size:

Use different sizes in the positive and negative directions for each tick mark:

Specify a style for each frame tick:

FrameTicksStyle  (3)

By default, the frame ticks and frame tick labels use the same styles as the frame:

Specify an overall style for the ticks, including the labels:

Use a different style for each frame edge:

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:

Ticks  (6)

Ticks are placed automatically on each axis:

Use TicksNone to draw axes without any tick marks:

Place tick marks at the specified positions:

Draw tick marks at the specified positions with specific labels:

Specify the lengths for ticks as a fraction of graphics size:

Use different sizes in the positive and negative directions for each tick:

Specify a style for each tick:

TicksStyle  (4)

By default, the ticks and tick labels use the same styles as the axis:

Specify an overall ticks style, including for tick labels:

Specify a ticks style for each of the axes:

Use a different style for the tick labels and tick marks:

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_2023_chromaticityplot, author="Wolfram Research", title="{ChromaticityPlot}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/ChromaticityPlot.html}", note=[Accessed: 31-May-2023 ]}

BibLaTeX

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