colour.plotting.plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931¶
- colour.plotting.plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931(RGB: ArrayLike, colourspace: Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str, Sequence[Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str]]] = 'sRGB', chromaticity_diagram_callable_CIE1931: Callable = plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931, scatter_kwargs: Optional[Dict] = None, **kwargs: Any) Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes] [source]¶
Plot given RGB colourspace array in the CIE 1931 Chromaticity Diagram.
- Parameters
RGB (ArrayLike) – RGB colourspace array.
colourspace (Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str, Sequence[Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str]]]) – RGB colourspace of the RGB array.
colourspace
can be of any type or form supported by thecolour.plotting.filter_RGB_colourspaces()
definition.chromaticity_diagram_callable_CIE1931 (Callable) – Callable responsible for drawing the CIE 1931 Chromaticity Diagram.
scatter_kwargs (Optional[Dict]) –
Keyword arguments for the
matplotlib.pyplot.scatter()
definition. The following special keyword arguments can also be used:c
: Ifc
is set to RGB, the scatter will use the colours as given by theRGB
argument.
kwargs (Any) – {
colour.plotting.artist()
,colour.plotting.diagrams.plot_chromaticity_diagram()
,colour.plotting.models.plot_RGB_colourspaces_in_chromaticity_diagram()
,colour.plotting.render()
}, See the documentation of the previously listed definitions.
- Returns
Current figure and axes.
- Return type
Examples
>>> RGB = np.random.random((128, 128, 3)) >>> plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931( ... RGB, 'ITU-R BT.709') ... (<Figure size ... with 1 Axes>, <...AxesSubplot...>)