colour.plotting.plot_sds_in_chromaticity_diagram_CIE1960UCS¶
- colour.plotting.plot_sds_in_chromaticity_diagram_CIE1960UCS(sds, cmfs='CIE 1931 2 Degree Standard Observer', chromaticity_diagram_callable_CIE1960UCS=<function plot_chromaticity_diagram_CIE1960UCS>, annotate_kwargs=None, plot_kwargs=None, **kwargs)[source]¶
Plots given spectral distribution chromaticity coordinates into the CIE 1960 UCS Chromaticity Diagram.
- Parameters
sds (array_like or MultiSpectralDistributions) – Spectral distributions or multi-spectral distributions to plot. sds can be a single
colour.MultiSpectralDistributions
class instance, a list ofcolour.MultiSpectralDistributions
class instances or a list ofcolour.SpectralDistribution
class instances.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 thecolour.plotting.filter_cmfs()
definition.chromaticity_diagram_callable_CIE1960UCS (callable, optional) – Callable responsible for drawing the CIE 1960 UCS Chromaticity Diagram.
annotate_kwargs (dict or array_like, optional) –
Keyword arguments for the
plt.annotate()
definition, used to annotate the resulting chromaticity coordinates with their respective spectral distribution names.annotate_kwargs
can be either a single dictionary applied to all the arrows with same settings or a sequence of dictionaries with different settings for each spectral distribution. The following special keyword arguments can also be used:annotate : bool, whether to annotate the spectral distributions.
plot_kwargs (dict or array_like, optional) –
Keyword arguments for the
plt.plot()
definition, used to control the style of the plotted spectral distributions.plot_kwargs
can be either a single dictionary applied to all the plotted spectral distributions with same settings or a sequence of dictionaries with different settings for each plotted spectral distributions. The following special keyword arguments can also be used:illuminant : unicode or
colour.SpectralDistribution
, the illuminant used to compute the spectral distributions colours. The default is the illuminant associated with the whitepoint of the default plotting colourspace.illuminant
can be of any type or form supported by thecolour.plotting.filter_cmfs()
definition.cmfs : unicode, the standard observer colour matching functions used for computing the spectral distributions colours.
cmfs
can be of any type or form supported by thecolour.plotting.filter_cmfs()
definition.normalise_sd_colours : bool, whether to normalise the computed spectral distributions colours. The default is True.
use_sd_colours : bool, whether to use the computed spectral distributions colours under the plotting colourspace illuminant. Alternatively, it is possible to use the
plt.plot()
definitioncolor
argument with pre-computed values. The default is True.
**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. Also handles keywords arguments for deprecation management.
- Returns
Current figure and axes.
- Return type
Examples
>>> A = SDS_ILLUMINANTS['A'] >>> D65 = SDS_ILLUMINANTS['D65'] >>> plot_sds_in_chromaticity_diagram_CIE1960UCS([A, D65]) ... (<Figure size ... with 1 Axes>, <...AxesSubplot...>)