colour.plotting.models.plot_RGB_colourspaces_in_chromaticity_diagram¶
- colour.plotting.models.plot_RGB_colourspaces_in_chromaticity_diagram(colourspaces: Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str, Sequence[Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str]]], cmfs: Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str]]] = 'CIE 1931 2 Degree Standard Observer', chromaticity_diagram_callable: Callable = plot_chromaticity_diagram, method: Union[Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'], str] = 'CIE 1931', show_whitepoints: bool = True, show_pointer_gamut: bool = False, chromatically_adapt: bool = False, plot_kwargs: Optional[Union[Dict, List[Dict]]] = None, **kwargs: Any) Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes] [source]¶
Plot given RGB colourspaces in the Chromaticity Diagram according to given method.
- Parameters
colourspaces (Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str, Sequence[Union[colour.models.rgb.rgb_colourspace.RGB_Colourspace, str]]]) – RGB colourspaces to plot.
colourspaces
elements can be of any type or form supported by thecolour.plotting.filter_RGB_colourspaces()
definition.cmfs (Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[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 thecolour.plotting.filter_cmfs()
definition.chromaticity_diagram_callable (Callable) – Callable responsible for drawing the Chromaticity Diagram.
method (Union[Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'], str]) – Chromaticity Diagram method.
show_whitepoints (bool) – Whether to display the RGB colourspaces whitepoints.
show_pointer_gamut (bool) – Whether to display the Pointer’s Gamut.
chromatically_adapt (bool) – Whether to chromatically adapt the RGB colourspaces given in
colourspaces
to the whitepoint of the default plotting colourspace.plot_kwargs (Optional[Union[Dict, List[Dict]]]) – Keyword arguments for the
matplotlib.pyplot.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 the same settings or a sequence of dictionaries with different settings for each plotted RGB colourspace.kwargs (Any) – {
colour.plotting.artist()
,colour.plotting.diagrams.plot_chromaticity_diagram()
,colour.plotting.models.plot_pointer_gamut()
,colour.plotting.render()
}, See the documentation of the previously listed definitions.
- Returns
Current figure and axes.
- Return type
Examples
>>> plot_kwargs = [ ... {'color': 'r'}, ... {'linestyle': 'dashed'}, ... {'marker': None} ... ] >>> plot_RGB_colourspaces_in_chromaticity_diagram( ... ['ITU-R BT.709', 'ACEScg', 'S-Gamut'], plot_kwargs=plot_kwargs) ... (<Figure size ... with 1 Axes>, <...AxesSubplot...>)