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.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

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

Plots the CIE 1931 Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • show_diagram_colours (bool, optional) – Whether to display the chromaticity diagram background colours.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

>>> CIE_1931_chromaticity_diagram_plot()  
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.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

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

Plots the CIE 1960 UCS Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • show_diagram_colours (bool, optional) – Whether to display the chromaticity diagram background colours.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

>>> CIE_1960_UCS_chromaticity_diagram_plot()  
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.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

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

Plots the CIE 1976 UCS Chromaticity Diagram.

Parameters:
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
  • show_diagram_colours (bool, optional) – Whether to display the chromaticity diagram background colours.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

>>> CIE_1976_UCS_chromaticity_diagram_plot()  
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 (array_like, 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.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1931_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

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])  
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 (array_like, 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.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1960_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

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])  
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 (array_like, 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.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1976_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

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])