colour.plotting.diagrams.plot_sds_in_chromaticity_diagram#

colour.plotting.diagrams.plot_sds_in_chromaticity_diagram(sds: Union[Sequence[Union[colour.colorimetry.spectrum.SpectralDistribution, colour.colorimetry.spectrum.MultiSpectralDistributions]], colour.colorimetry.spectrum.MultiSpectralDistributions], 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', annotate_kwargs: Optional[Union[Dict, List[Dict]]] = None, plot_kwargs: Optional[Union[Dict, List[Dict]]] = None, **kwargs: Any) Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes][source]#

Plot given spectral distribution chromaticity coordinates into the Chromaticity Diagram using given method.

Parameters
Returns

Current figure and axes.

Return type

tuple

Examples

>>> A = SDS_ILLUMINANTS['A']
>>> D65 = SDS_ILLUMINANTS['D65']
>>> annotate_kwargs = [
...     {'xytext': (-25, 15), 'arrowprops':{'arrowstyle':'-'}},
...     {}
... ]
>>> plot_kwargs = [
...     {
...         'illuminant': SDS_ILLUMINANTS['E'],
...         'markersize' : 15,
...         'normalise_sd_colours': True,
...         'use_sd_colours': True
...     },
...     {'illuminant': SDS_ILLUMINANTS['E']},
... ]
>>> plot_sds_in_chromaticity_diagram(
...     [A, D65], annotate_kwargs=annotate_kwargs, plot_kwargs=plot_kwargs)
... 
(<Figure size ... with 1 Axes>, <...AxesSubplot...>)
plot_sds_in_chromaticity_diagram