colour.plotting.diagrams.plot_spectral_locus#

colour.plotting.diagrams.plot_spectral_locus(cmfs: MultiSpectralDistributions | str | Sequence[MultiSpectralDistributions | str] = 'CIE 1931 2 Degree Standard Observer', spectral_locus_colours: ArrayLike | str | None = None, spectral_locus_opacity: float = 1, spectral_locus_labels: Sequence | None = None, method: Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'] | str = 'CIE 1931', **kwargs: Any) Tuple[Figure, Axes][source]#

Plot the Spectral Locus according to given method.

Parameters:
  • cmfs (MultiSpectralDistributions | str | Sequence[MultiSpectralDistributions | str]) – Standard observer colour matching functions used for computing the spectral locus boundaries. cmfs can be of any type or form supported by the colour.plotting.common.filter_cmfs() definition.

  • spectral_locus_colours (ArrayLike | str | None) – Colours of the Spectral Locus, if spectral_locus_colours is set to RGB, the colours will be computed according to the corresponding chromaticity coordinates.

  • spectral_locus_opacity (float) – Opacity of the Spectral Locus.

  • spectral_locus_labels (Sequence | None) – Array of wavelength labels used to customise which labels will be drawn around the spectral locus. Passing an empty array will result in no wavelength labels being drawn.

  • method (Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'] | str) – Chromaticity Diagram method.

  • kwargs (Any) – {colour.plotting.artist(), colour.plotting.render()}, See the documentation of the previously listed definitions.

Returns:

Current figure and axes.

Return type:

tuple

Examples

>>> plot_spectral_locus(spectral_locus_colours="RGB")  
(<Figure size ... with 1 Axes>, <...Axes...>)
plot_spectral_locus