colour.plotting.diagrams.plot_chromaticity_diagram#

colour.plotting.diagrams.plot_chromaticity_diagram(cmfs: colour.colorimetry.spectrum.MultiSpectralDistributions | str | collections.abc.Sequence[colour.colorimetry.spectrum.MultiSpectralDistributions | str] = 'CIE 1931 2 Degree Standard Observer', show_diagram_colours: bool = True, show_spectral_locus: bool = True, method: Union[Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'], str] = 'CIE 1931', **kwargs: Any) → Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes][source]#

Plot the Chromaticity Diagram according to given method.

Parameters

cmfs (colour.colorimetry.spectrum.MultiSpectralDistributions | str | collections.abc.Sequence[colour.colorimetry.spectrum.MultiSpectralDistributions | str]) – Standard observer colour matching functions used for computing the spectral locus boundaries. cmfs can be of any type or form supported by the colour.plotting.common.filter_cmfs() definition.
show_diagram_colours (bool) – Whether to display the Chromaticity Diagram background colours.
show_spectral_locus (bool) – Whether to display the Spectral Locus.
method (Union[Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'], str]) – Chromaticity Diagram method.
kwargs (Any) – {colour.plotting.artist(), colour.plotting.diagrams.plot_spectral_locus(), colour.plotting.diagrams.plot_chromaticity_diagram_colours(), colour.plotting.render()}, See the documentation of the previously listed definitions.

Returns

Current figure and axes.

Return type

tuple

Examples

>>> plot_chromaticity_diagram()  
(<Figure size ... with 1 Axes>, <...Axes...>)