colour.plotting.plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931

colour.plotting.plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931(colourspaces, cmfs='CIE 1931 2 Degree Standard Observer', chromaticity_diagram_callable_CIE1931=<function plot_chromaticity_diagram_CIE1931>, show_whitepoints=True, show_pointer_gamut=False, chromatically_adapt=False, plot_kwargs=None, **kwargs)[source]

Plots given RGB colourspaces in the CIE 1931 Chromaticity Diagram.

Parameters

  • colourspaces (unicode or RGB_Colourspace or array_like) – RGB colourspaces to plot. colourspaces elements can be of any type or form supported by the colour.plotting.filter_RGB_colourspaces() definition.

  • cmfs (unicode or XYZ_ColourMatchingFunctions, optional) – 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.filter_cmfs() definition.

  • chromaticity_diagram_callable_CIE1931 (callable, optional) – Callable responsible for drawing the CIE 1931 Chromaticity Diagram.

  • show_whitepoints (bool, optional) – Whether to display the RGB colourspaces whitepoints.

  • show_pointer_gamut (bool, optional) – Whether to display the Pointer’s Gamut.

  • chromatically_adapt (bool, optional) – Whether to chromatically adapt the RGB colourspaces given in colourspaces to the whitepoint of the default plotting colourspace.

  • plot_kwargs (dict or array_like, optional) – Keyword arguments for the plt.plot() definition, used to control the style of the plotted RGB colourspaces. plot_kwargs can be either a single dictionary applied to all the plotted RGB colourspaces with same settings or a sequence of dictionaries with different settings for each plotted RGB colourspace.

  • **kwargs (dict, optional) – {colour.plotting.artist(), colour.plotting.diagrams.plot_chromaticity_diagram(), colour.plotting.render()}, Please refer to the documentation of the previously listed definitions.

Returns

Current figure and axes.

Return type

tuple

Examples

>>> plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931(
...     ['ITU-R BT.709', 'ACEScg', 'S-Gamut'])
... 
(<Figure size ... with 1 Axes>, <...AxesSubplot...>)
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931