colour.plotting.plot_visible_spectrum¶
- colour.plotting.plot_visible_spectrum(cmfs: Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str]]] = 'CIE 1931 2 Degree Standard Observer', out_of_gamut_clipping: bool = True, **kwargs: Any) Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes] [source]¶
Plot the visible colours spectrum using given standard observer CIE XYZ colour matching functions.
- Parameters
cmfs (Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str]]]) – Standard observer colour matching functions used for computing the spectrum domain and colours.
cmfs
can be of any type or form supported by thecolour.plotting.filter_cmfs()
definition.out_of_gamut_clipping (bool) – Whether to clip out of gamut colours otherwise, the colours will be offset by the absolute minimal colour leading to a rendering on gray background, less saturated and smoother.
kwargs (Any) – {
colour.plotting.artist()
,colour.plotting.plot_single_sd()
,colour.plotting.render()
}, See the documentation of the previously listed definitions.
- Returns
Current figure and axes.
- Return type
References
[Spi15]
Examples
>>> plot_visible_spectrum() (<Figure size ... with 1 Axes>, <...AxesSubplot...>)