--- title: "ChromaticityPlot3D" language: "en" type: "Symbol" summary: "ChromaticityPlot3D[colspace] returns a 3D gamut of the color space colspace. ChromaticityPlot3D[color] plots the specific color. ChromaticityPlot3D[image] plots the pixels of image as individual colors. ChromaticityPlot3D[{input1, input2, ...}] plots multiple colors, color spaces and images. ChromaticityPlot3D[..., refcolspace] uses the reference color space refcolspace." keywords: - chromaticity diagram - chromaticity coordinates - x y chromaticity diagram - xyY - Yxy - CIE 1931 Yxy - sRGB - Adobe RGB - Apple RGB - CIE RGB - Color Match RGB - wide gamut - wide-gamut RGB - Adobe Wide Gamut RGB - Pro Photo RGB - ROMM RGB - Reference Output Medium Metric canonical_url: "https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html" source: "Wolfram Language Documentation" related_guides: - title: "Color Processing" link: "https://reference.wolfram.com/language/guide/ColorProcessing.en.md" - title: "Image Computation: Update History" link: "https://reference.wolfram.com/language/guide/ImageComputation-UpdateHistory.en.md" - title: "Data Visualization" link: "https://reference.wolfram.com/language/guide/DataVisualization.en.md" related_functions: - title: "ChromaticityPlot" link: "https://reference.wolfram.com/language/ref/ChromaticityPlot.en.md" - title: "RGBColor" link: "https://reference.wolfram.com/language/ref/RGBColor.en.md" - title: "CMYKColor" link: "https://reference.wolfram.com/language/ref/CMYKColor.en.md" - title: "LABColor" link: "https://reference.wolfram.com/language/ref/LABColor.en.md" - title: "LUVColor" link: "https://reference.wolfram.com/language/ref/LUVColor.en.md" - title: "XYZColor" link: "https://reference.wolfram.com/language/ref/XYZColor.en.md" - title: "Hue" link: "https://reference.wolfram.com/language/ref/Hue.en.md" --- # ChromaticityPlot3D ChromaticityPlot3D[colspace] returns a 3D gamut of the color space colspace. ChromaticityPlot3D[color] plots the specific color. ChromaticityPlot3D[image] plots the pixels of image as individual colors. ChromaticityPlot3D[{input1, input2, …}] plots multiple colors, color spaces and images. ChromaticityPlot3D[…, refcolspace] uses the reference color space refcolspace. ## 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 $i$ | * 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 $Y x y$ (default) | | "CIE76" | CIE 1976 $Y u'v'$ | | "XYZ" | CIE 1931 $X Y Z$ | | "LAB" | CIE 1976 $L^* a^* b^*$ | | "LCH" | CIE $L^*$$C^*$$h\left(a^*, b^*\right)$ | | "LUV" | CIE 1976 $L^* u^* v^*$ | | "RGB" | RGB cube | | "HSB" | HSB cube | * ``ChromaticityPlot3D`` accepts all ``Graphics3D`` options with the following additions and changes: [] | | | | | -------------- | ------------- | ------------------------------------------ | | 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$$^{\text{th}}$$ input | | Placed[lspec, …] | specify placement of legend | ### List of all options | | | | | -------------------- | --------------- | ---------------------------------------------------------------------------------- | | 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 | --- ## Examples (55) ### Basic Examples (2) Visualization of the sRGB color gamut: ```wl In[1]:= ChromaticityPlot3D["sRGB"] Out[1]= [image] ``` --- Compare the gamut of two RGB color spaces: ```wl In[1]:= ChromaticityPlot3D[{"WideGamutRGB", "sRGB"}] Out[1]= [image] ``` ### Scope (8) Visualize the sRGB gamut in the CIE 1931 Yxy reference space: ```wl In[1]:= ChromaticityPlot3D["sRGB"] Out[1]= [image] ``` --- Visualize the gamut in the CIE 1931 XYZ reference space: ```wl In[1]:= ChromaticityPlot3D["sRGB", "XYZ"] Out[1]= [image] ``` --- Compare two gamuts in the CIE 1976 $L^*a^*b^*$ space: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "AdobeRGB"}, "LAB"] Out[1]= [image] ``` --- Show a list of RGB colors in the RGB cube: ```wl In[1]:= ChromaticityPlot3D[RandomColor[1000], "RGB"] Out[1]= [image] ``` --- Visualize color regions in 3D: ```wl In[1]:= ChromaticityPlot3D[{ColorsNear[Brown], ColorsNear[Cyan, .05]}] Out[1]= [image] ``` --- Visualize the pixels of an image: ```wl In[1]:= ChromaticityPlot3D[[image]] Out[1]= [image] ``` --- Visualize the pixels of a 3D image: ```wl In[1]:= ChromaticityPlot3D[[image]] Out[1]= [image] ``` --- Visualize the color distribution of a graphics object: ```wl In[1]:= ChromaticityPlot3D[[image]] Out[1]= [image] ``` ### Options (40) #### Appearance (1) By default, only the color space gamuts are displayed: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` Also show the boundary of the visible spectrum: ```wl In[2]:= ChromaticityPlot3D["RGB", Appearance -> "VisibleSpectrum"] Out[2]= [image] ``` #### Axes (3) By default, the box and axes are drawn: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` --- Turn off axes: ```wl In[1]:= ChromaticityPlot3D["RGB", Axes -> False] Out[1]= [image] ``` --- Turn off both axes and box: ```wl In[1]:= ChromaticityPlot3D["RGB", Axes -> False, Boxed -> False] Out[1]= [image] ``` #### AxesLabel (3) By default, appropriate labels are displayed for each coordinate: ```wl In[1]:= ChromaticityPlot3D["sRGB", #]& /@ {"XYZ", "LAB"} Out[1]= [image] ``` --- Place a label on the ``z`` axis: ```wl In[1]:= ChromaticityPlot3D["sRGB", AxesLabel -> "Z-label"] Out[1]= [image] ``` --- Specify axes labels: ```wl In[1]:= ChromaticityPlot3D["sRGB", AxesLabel -> {label1, label2, label3}] Out[1]= [image] ``` #### AxesOrigin (2) The position of the axes is determined automatically: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` --- Specify an explicit origin for the axes: ```wl In[1]:= ChromaticityPlot3D["RGB", AxesOrigin -> {.5, .5, 0}] Out[1]= [image] ``` #### AxesStyle (4) Change the style for the axes: ```wl In[1]:= ChromaticityPlot3D["RGB", AxesStyle -> Red] Out[1]= [image] ``` --- Specify a style for each axis: ```wl In[1]:= ChromaticityPlot3D["RGB", AxesStyle -> {{Thick, StandardBrown}, {Thick, StandardBlue}, {Thick, StandardGreen}}] Out[1]= [image] ``` --- Use different styles for the ticks and the axes: ```wl In[1]:= ChromaticityPlot3D["RGB", AxesStyle -> StandardBlue, TicksStyle -> StandardRed] Out[1]= [image] ``` --- Use different styles for the labels and the axes: ```wl In[1]:= ChromaticityPlot3D["RGB", AxesStyle -> StandardBlue, LabelStyle -> StandardRed] Out[1]= [image] ``` #### BoundaryStyle (3) By default, a boundary for each space is drawn: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "CIERGB"}] Out[1]= [image] ``` --- Use thick boundary: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "CIERGB"}, BoundaryStyle -> Thick] Out[1]= [image] ``` --- Specify color and style of each boundary: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "CIERGB"}, BoundaryStyle -> {Directive[{Red, Dashed}], Directive[{Thick, Blue}]}] Out[1]= [image] ``` #### BoxRatios (1) By default, side-length ratios of 1 are used: ```wl In[1]:= ChromaticityPlot3D["sRGB"] Out[1]= [image] ``` Use ``BoxRatios -> Automatic`` to use natural side-length ratios: ```wl In[2]:= ChromaticityPlot3D["sRGB", BoxRatios -> Automatic] Out[2]= [image] ``` Use custom box ratios: ```wl In[3]:= ChromaticityPlot3D["sRGB", BoxRatios -> {1 / 2, 1, 1}] Out[3]= [image] ``` #### FillingStyle (3) By default, one space is fully opaque and colored: ```wl In[1]:= ChromaticityPlot3D["sRGB"] Out[1]= [image] ``` Make the plot partially transparent: ```wl In[2]:= ChromaticityPlot3D["sRGB", FillingStyle -> Opacity[.5]] Out[2]= [image] ``` Show just the boundaries: ```wl In[3]:= ChromaticityPlot3D["RGB", FillingStyle -> None] Out[3]= [image] ``` Use a specific color: ```wl In[4]:= ChromaticityPlot3D["RGB", FillingStyle -> RGBColor[.2, .4, .6, .8]] Out[4]= [image] ``` --- With multiple spaces, by default all are partially transparent: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "WideGamutRGB"}] Out[1]= [image] ``` Individually define the appearance for each space: ```wl In[2]:= ChromaticityPlot3D[{"RGB", "WideGamutRGB"}, FillingStyle -> {Opacity[.6], Opacity[.3]}] Out[2]= [image] ``` --- If the specified list of styles is shorter than the list of color spaces, it is cyclically padded: ```wl In[1]:= ChromaticityPlot3D[{"WideGamutRGB", "CIERGB", "LAB"}, FillingStyle -> {Opacity[.3], Opacity[.6]}] Out[1]= [image] ``` #### MaxPlotPoints (1) By default, the maximum number of points in the plot is limited: ```wl In[1]:= c = RandomColor[6000, ColorSpace -> "LAB"]; In[2]:= ChromaticityPlot3D[c] Out[2]= [image] ``` Increase the limit to accommodate all points: ```wl In[3]:= ChromaticityPlot3D[c, MaxPlotPoints -> Infinity] Out[3]= [image] ``` #### Mesh (6) By default, no mesh is displayed: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` --- Use five mesh lines in each direction: ```wl In[1]:= ChromaticityPlot3D["RGB", Mesh -> 5] Out[1]= [image] ``` --- Show full mesh: ```wl In[1]:= ChromaticityPlot3D["RGB", Mesh -> Full] Out[1]= [image] ``` The resolution of the full mesh is taken from the ``PlotPoints`` option: ```wl In[2]:= ChromaticityPlot3D["RGB", Mesh -> Full, PlotPoints -> 5] Out[2]= [image] ``` --- Show only the mesh for each space: ```wl In[1]:= ChromaticityPlot3D["RGB", Mesh -> 5, PlotStyle -> None] Out[1]= [image] ``` --- Use five mesh lines in each direction for every space: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "XYZ"}, Mesh -> 5] Out[1]= [image] ``` --- Specify whether to show the mesh individually for each space: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "XYZ"}, Mesh -> {5, None}] Out[1]= [image] ``` #### MeshStyle (1) By default, the boundary style is used for mesh style: ```wl In[1]:= ChromaticityPlot3D["sRGB", Mesh -> 5] Out[1]= [image] ``` Specify a different mesh style: ```wl In[2]:= ChromaticityPlot3D["sRGB", Mesh -> 5, MeshStyle -> Red] Out[2]= [image] ``` #### PlotLegends (2) By default, the legends are not shown for one color space: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` Show the plot legend: ```wl In[2]:= ChromaticityPlot3D["RGB", PlotLegends -> "Expressions"] Out[2]= [image] ``` --- By default, the legends are shown for multiple spaces: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "AdobeRGB"}] Out[1]= [image] ``` Turn the legends off: ```wl In[2]:= ChromaticityPlot3D[{"RGB", "AdobeRGB"}, PlotLegends -> None] Out[2]= [image] ``` #### PlotPoints (1) ``PlotPoints`` specifies the density of the grid: ```wl In[1]:= Table[ChromaticityPlot3D["XYZ", "XYZ", Mesh -> Full, PlotPoints -> n, ImageSize -> 150], {n, {5, 10, 20}}] Out[1]= [image] ``` #### PlotStyle (1) By default, each directive or pixel is plotted with its actual color: ```wl In[1]:= i = RandomImage[ColorSpace -> "RGB"]; In[2]:= ChromaticityPlot3D[i] Out[2]= [image] ``` Use a custom style: ```wl In[3]:= ChromaticityPlot3D[i, PlotStyle -> {Purple, PointSize[Tiny]}] Out[3]= [image] ``` #### PlotTheme (3) Use a theme with simple frame ticks in a bold color scheme: ```wl In[1]:= ChromaticityPlot3D[{"WideGamutRGB", "sRGB"}, PlotTheme -> "Web"] Out[1]= [image] ``` --- Change the boundary styles: ```wl In[1]:= ChromaticityPlot3D[{"WideGamutRGB", "sRGB"}, PlotTheme -> "Web", BoundaryStyle -> {Directive[Thick, Red], Directive[Thick, Blue]}] Out[1]= [image] ``` --- Use a monochrome theme: ```wl In[1]:= ChromaticityPlot3D[{"WideGamutRGB", "sRGB"}, PlotTheme -> "Monochrome"] Out[1]= [image] ``` #### WhitePoint (5) By default, the white point is not shown: ```wl In[1]:= ChromaticityPlot3D["RGB"] Out[1]= [image] ``` --- Turn the white point on: ```wl In[1]:= ChromaticityPlot3D["RGB", WhitePoint -> All] Out[1]= [image] ``` --- Show white points for multiple spaces: ```wl In[1]:= ChromaticityPlot3D[{"RGB", "AdobeRGB"}, WhitePoint -> All] Out[1]= [image] ``` --- Show a specific white point: ```wl In[1]:= ChromaticityPlot3D["RGB", WhitePoint -> "E"] Out[1]= [image] ``` --- Show custom white points: ```wl In[1]:= ChromaticityPlot3D["RGB", WhitePoint -> {XYZColor[.9, 1, .8], XYZColor[.9, 1, 1.1]}] Out[1]= [image] ``` ### Applications (2) Visualize shades of green in the RGB cube: ```wl In[1]:= ChromaticityPlot3D[RandomColor[Hue[1 / 3, _, _], 1000], "RGB"] Out[1]= [image] ``` Shades of green in the HSB cube: ```wl In[2]:= ChromaticityPlot3D[RandomColor[Hue[1 / 3, _, _], 1000], "HSB"] Out[2]= [image] ``` --- ``ImageAdjust`` rescales RGB values to 0 and 1. Visualize the transformation in the Lab color space: ```wl In[1]:= {image = ExampleData[{"TestImage", "House"}], adjusted = ImageAdjust@image} Out[1]= {[image], [image]} In[2]:= ChromaticityPlot3D[#, "LAB", ViewPoint -> Bottom, PlotRange -> {{0, 1}, All, All}, ImageSize -> 150]& /@ {image, adjusted} Out[2]= [image] ``` ### Properties & Relations (2) ProPhoto RGB is designed to cover most of the visible portion of the Lab space: ```wl In[1]:= ChromaticityPlot3D["ProPhotoRGB", "LAB", Appearance -> "VisibleSpectrum"] Out[1]= [image] ``` --- ``ChromaticityPlot3D`` can visualize symbolic color regions specified by ``ColorsNear`` : ```wl In[1]:= ℛ1 = ColorsNear[RGBColor[1, 0, 0], .3, "CIE76"]; ℛ2 = ColorsNear[RGBColor[0.3, 0.47000000000000003, 0.87], .08]; In[2]:= ChromaticityPlot3D[{"RGB", ℛ1, ℛ2}] Out[2]= [image] ``` ### Neat Examples (1) A cube portion of LCH is a cylindrical region in LAB: ```wl In[1]:= ChromaticityPlot3D["LCH", "LAB", Mesh -> 10, PlotPoints -> 35] Out[1]= [image] ``` ## See Also * [`ChromaticityPlot`](https://reference.wolfram.com/language/ref/ChromaticityPlot.en.md) * [`RGBColor`](https://reference.wolfram.com/language/ref/RGBColor.en.md) * [`CMYKColor`](https://reference.wolfram.com/language/ref/CMYKColor.en.md) * [`LABColor`](https://reference.wolfram.com/language/ref/LABColor.en.md) * [`LUVColor`](https://reference.wolfram.com/language/ref/LUVColor.en.md) * [`XYZColor`](https://reference.wolfram.com/language/ref/XYZColor.en.md) * [`Hue`](https://reference.wolfram.com/language/ref/Hue.en.md) ## Related Guides * [Color Processing](https://reference.wolfram.com/language/guide/ColorProcessing.en.md) * [Image Computation: Update History](https://reference.wolfram.com/language/guide/ImageComputation-UpdateHistory.en.md) * [Data Visualization](https://reference.wolfram.com/language/guide/DataVisualization.en.md) ## Related Links * [An Elementary Introduction to the Wolfram Language: Colors and Styles](https://www.wolfram.com/language/elementary-introduction/07-colors-and-styles.html) ## History * [Introduced in 2014 (10.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn100.en.md) \| [Updated in 2019 (12.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn120.en.md)