colour.plotting.diagrams Module

CIE Chromaticity Diagrams Plotting

Defines the CIE chromaticity diagrams plotting objects:

colour.plotting.diagrams.CIE_1931_chromaticity_diagram_colours_plot(surface=1, samples=4096, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1931 Chromaticity Diagram colours.

Parameters:
  • surface (numeric, optional) – Generated markers surface.
  • samples (numeric, optional) – Samples count on one axis.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1931_chromaticity_diagram_colours_plot()  
True
colour.plotting.diagrams.CIE_1931_chromaticity_diagram_plot(cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1931 Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1931_chromaticity_diagram_plot()  
True
colour.plotting.diagrams.CIE_1960_UCS_chromaticity_diagram_colours_plot(surface=1, samples=4096, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1960 UCS Chromaticity Diagram colours.

Parameters:
  • surface (numeric, optional) – Generated markers surface.
  • samples (numeric, optional) – Samples count on one axis.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1960_UCS_chromaticity_diagram_colours_plot()  
True
colour.plotting.diagrams.CIE_1960_UCS_chromaticity_diagram_plot(cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1960 UCS Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1960_UCS_chromaticity_diagram_plot()  
True
colour.plotting.diagrams.CIE_1976_UCS_chromaticity_diagram_colours_plot(surface=1, samples=4096, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1976 UCS Chromaticity Diagram colours.

Parameters:
  • surface (numeric, optional) – Generated markers surface.
  • samples (numeric, optional) – Samples count on one axis.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1976_UCS_chromaticity_diagram_colours_plot()  
True
colour.plotting.diagrams.CIE_1976_UCS_chromaticity_diagram_plot(cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots the CIE 1976 UCS Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> CIE_1976_UCS_chromaticity_diagram_plot()  
True
colour.plotting.diagrams.spds_CIE_1931_chromaticity_diagram_plot(spds, cmfs='CIE 1931 2 Degree Standard Observer', annotate=True, **kwargs)[source]

Plots given spectral power distribution chromaticity coordinates into the CIE 1931 Chromaticity Diagram.

Parameters:
  • spds (list, optional) – Spectral power distributions to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • annotate (bool) – Should resulting chromaticity coordinates annotated with their respective spectral power distribution names.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> A = ILLUMINANTS_RELATIVE_SPDS['A']
>>> D65 = ILLUMINANTS_RELATIVE_SPDS['D65']
>>> spds_CIE_1931_chromaticity_diagram_plot([A, D65])  
True
colour.plotting.diagrams.spds_CIE_1960_UCS_chromaticity_diagram_plot(spds, cmfs='CIE 1931 2 Degree Standard Observer', annotate=True, **kwargs)[source]

Plots given spectral power distribution chromaticity coordinates into the CIE 1960 UCS Chromaticity Diagram.

Parameters:
  • spds (list, optional) – Spectral power distributions to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • annotate (bool) – Should resulting chromaticity coordinates annotated with their respective spectral power distribution names.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> A = ILLUMINANTS_RELATIVE_SPDS['A']
>>> D65 = ILLUMINANTS_RELATIVE_SPDS['D65']
>>> spds_CIE_1960_UCS_chromaticity_diagram_plot([A, D65])  
True
colour.plotting.diagrams.spds_CIE_1976_UCS_chromaticity_diagram_plot(spds, cmfs='CIE 1931 2 Degree Standard Observer', annotate=True, **kwargs)[source]

Plots given spectral power distribution chromaticity coordinates into the CIE 1976 UCS Chromaticity Diagram.

Parameters:
  • spds (list, optional) – Spectral power distributions to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • annotate (bool) – Should resulting chromaticity coordinates annotated with their respective spectral power distribution names.
  • **kwargs (**) – Keywords arguments.
Returns:

Definition success.

Return type:

bool

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> A = ILLUMINANTS_RELATIVE_SPDS['A']
>>> D65 = ILLUMINANTS_RELATIVE_SPDS['D65']
>>> spds_CIE_1976_UCS_chromaticity_diagram_plot([A, D65])  
True