ChromaticityPlot3D
✖
ChromaticityPlot3D
Details and Options
- ChromaticityPlot3D 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 such colors in an image.
- ChromaticityPlot3D converts and displays the color coordinates in colspace to coordinates in refcolspace color space.
- 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 "LUV" LUVColor "LCH" LCHColor 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 
(default)"CIE76" CIE 1976 
"XYZ" CIE 1931 
"LAB" CIE 1976 
"LCH" CIE 
"LUV" CIE 1976 
"RGB" RGB cube "HSB" HSB cube - ChromaticityPlot3D accepts all Graphics3D options with the following additions and changes: [List of all options]
-
Appearance None appearance of the visible spectrum Axes True whether to draw axes AxesLabel Automatic axes labels BoundaryStyle Automatic the style for the boundary of each region BoxRatios {1,1,1} bounding 3D box ratios FillingStyle Automatic filling style for each color space MaxPlotPoints 2000 maximum number of colors or pixels to show Mesh None whether to draw a mesh MeshStyle Automatic the style for mesh divisions PlotLegends Automatic legends for each space PlotPoints Automatic number of sample points in each dimension PlotStyle Automatic specify the style for colors and images PlotTheme $PlotTheme overall theme for the plot ViewPoint {1,1.5,-2.} viewing position ViewVertical {1,0,0} direction to make vertical WhitePoint Automatic what white point to show - Possible settings for Appearance are:
-
None do not show the visible spectrum "VisibleSpectrum" show the curve corresponding to the visible spectrum - Typical settings for PlotLegends include:
-
None add no legend Automatic use automatic legending "Expressions" use color space name as legend labels {lbl1,lbl2,…} use lbli for the i 
inputPlaced[lspec,…] specify placement of legend -
AlignmentPoint Center the default point in the graphic to align with Appearance None appearance of the visible spectrum AspectRatio Automatic ratio of height to width Axes True whether to draw axes AxesEdge Automatic on which edges to put axes AxesLabel Automatic axes labels AxesOrigin Automatic where axes should cross AxesStyle {} graphics directives to specify the style for axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic BoundaryStyle Automatic the style for the boundary of each region Boxed True whether to draw the bounding box BoxRatios {1,1,1} bounding 3D box ratios BoxStyle {} style specifications for the box ClipPlanes None clipping planes ClipPlanesStyle Automatic style specifications for clipping planes ContentSelectable Automatic whether to allow contents to be selected ControllerLinking False when to link to external rotation controllers ControllerPath Automatic what external controllers to try to use Epilog {} 2D graphics primitives to be rendered after the main plot FaceGrids None grid lines to draw on the bounding box FaceGridsStyle {} style specifications for face grids FillingStyle Automatic filling style for each color space FormatType TraditionalForm default format type for text ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels, etc. ImageSize Automatic absolute size at which to render the graphic LabelStyle {} style specifications for labels Lighting Automatic simulated light sources to use MaxPlotPoints 2000 maximum number of colors or pixels to show Mesh None whether to draw a mesh MeshStyle Automatic the style for mesh divisions Method Automatic details of 3D graphics methods to use PlotLabel None a label for the plot PlotLegends Automatic legends for each space PlotPoints Automatic number of sample points in each dimension PlotRange All range of values to include PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic final display region to be filled PlotStyle Automatic specify the style for colors and images PlotTheme $PlotTheme overall theme for the plot PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} 2D graphics primitives to be rendered before the main plot RotationAction "Fit" how to render after interactive rotation SphericalRegion Automatic whether to make the circumscribing sphere fit in the final display area Ticks Automatic specification for ticks TicksStyle {} style specification for ticks TouchscreenAutoZoom False whether to zoom to fullscreen when activated on a touchscreen ViewAngle Automatic angle of the field of view ViewCenter Automatic point to display at the center ViewMatrix Automatic explicit transformation matrix ViewPoint {1,1.5,-2.} viewing position ViewProjection Automatic projection method for rendering objects distant from the viewer ViewRange All range of viewing distances to include ViewVector Automatic position and direction of a simulated camera ViewVertical {1,0,0} direction to make vertical WhitePoint Automatic what white point to show
List of all options
Examples
open allclose allBasic Examples (2)Summary of the most common use cases
Scope (8)Survey of the scope of standard use cases
Visualize the sRGB gamut in the CIE 1931 Yxy reference space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-e8eb7z
Out[1]=1
Visualize the gamut in the CIE 1931 XYZ reference space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-67d5gf
Out[1]=1
Compare two gamuts in the CIE 1976 
space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-3yfsua
Out[1]=1
Show a list of RGB colors in the RGB cube:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-to49hz
Out[1]=1
Visualize color regions in 3D:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-n3c8a7
Out[1]=1
Visualize the pixels of an image:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-nd2n9k
Out[1]=1
Visualize the pixels of a 3D image:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ch6z4s
Out[1]=1
Visualize the color distribution of a graphics object:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-q9hixw
Out[1]=1
Options (40)Common values & functionality for each option
Appearance (1)
Axes (3)
AxesLabel (3)
AxesOrigin (2)
AxesStyle (4)
Change the style for the axes:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-biq829
Out[1]=1
Specify a style for each axis:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-jf0bax
Out[1]=1
Use different styles for the ticks and the axes:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-c96j1c
Out[1]=1
Use different styles for the labels and the axes:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ciebr4
Out[1]=1
BoundaryStyle (3)
BoxRatios (1)
By default, side-length ratios of 1 are used:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-sb01xs
Out[1]=1
Use BoxRatios->Automatic to use natural side-length ratios:
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-5oqt4q
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-wbklxs
Out[3]=3
FillingStyle (3)
By default, one space is fully opaque and colored:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-9hvzoo
Out[1]=1
Make the plot partially transparent:
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-pynvvi
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-s3lslc
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-dykcgk
Out[4]=4
With multiple spaces, by default all are partially transparent:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-hlsda6
Out[1]=1
Individually define the appearance for each space:
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-3vmncg
Out[2]=2
If the specified list of styles is shorter than the list of color spaces, it is cyclically padded:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-8bhv9s
Out[1]=1
MaxPlotPoints (1)
By default, the maximum number of points in the plot is limited:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-weidkk
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-l8xq1y
Out[2]=2
Increase the limit to accommodate all points:
In[3]:=3
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-12r8h
Out[3]=3
Mesh (6)
By default, no mesh is displayed:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-el6kq0
Out[1]=1
Use five mesh lines in each direction:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-273uly
Out[1]=1
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-rqjpow
Out[1]=1
The resolution of the full mesh is taken from the PlotPoints option:
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ysibm1
Out[2]=2
Show only the mesh for each space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-7ad4os
Out[1]=1
Use five mesh lines in each direction for every space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-jign5c
Out[1]=1
Specify whether to show the mesh individually for each space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ij07om
Out[1]=1
MeshStyle (1)
PlotLegends (2)
By default, the legends are not shown for one color space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-5n4d3k
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-qq37ss
Out[2]=2
By default, the legends are shown for multiple spaces:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-d4b9my
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-jrmvpc
Out[2]=2
PlotPoints (1)
PlotPoints specifies the density of the grid:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-jgxa5k
Out[1]=1
PlotStyle (1)
PlotTheme (3)
WhitePoint (5)
By default, the white point is not shown:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-xvy3zs
Out[1]=1
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-2sijhl
Out[1]=1
Show white points for multiple spaces:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ilsib5
Out[1]=1
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ycvhvb
Out[1]=1
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-dev8i8
Out[1]=1
Applications (2)Sample problems that can be solved with this function
Visualize shades of green in the RGB cube:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-v3i57v
Out[1]=1
Shades of green in the HSB cube:
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ladwkl
Out[2]=2
ImageAdjust rescales RGB values to 0 and 1. Visualize the transformation in the Lab color space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-0lkz32
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-caapbb
Out[2]=2
Properties & Relations (2)Properties of the function, and connections to other functions
ProPhoto RGB is designed to cover most of the visible portion of the Lab space:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-o8b40
Out[1]=1
ChromaticityPlot3D can visualize symbolic color regions specified by ColorsNear:
In[1]:=1
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-ed0xjn
In[2]:=2
✖
https://wolfram.com/xid/0d4i9x2mtoftxybc-d9i9g7
Out[2]=2
Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).
✖
Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).Text
Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).
✖
Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).CMS
Wolfram Language. 2014. "ChromaticityPlot3D." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html.
✖
Wolfram Language. 2014. "ChromaticityPlot3D." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html.APA
Wolfram Language. (2014). ChromaticityPlot3D. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html
✖
Wolfram Language. (2014). ChromaticityPlot3D. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChromaticityPlot3D.htmlBibTeX
✖
@misc{reference.wolfram_2025_chromaticityplot3d, author="Wolfram Research", title="{ChromaticityPlot3D}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html}", note=[Accessed: 23-March-2025
]}BibLaTeX
✖
@online{reference.wolfram_2025_chromaticityplot3d, organization={Wolfram Research}, title={ChromaticityPlot3D}, year={2019}, url={https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html}, note=[Accessed: 23-March-2025
]}