colour.plotting.diagrams Module¶

CIE Chromaticity Diagrams Plotting¶

Defines the CIE chromaticity diagrams plotting objects:

• CIE_1931_chromaticity_diagram_plot()
• CIE_1960_UCS_chromaticity_diagram_plot()
• CIE_1976_UCS_chromaticity_diagram_plot()
• spds_CIE_1931_chromaticity_diagram_plot()
• spds_CIE_1960_UCS_chromaticity_diagram_plot()
• spds_CIE_1976_UCS_chromaticity_diagram_plot()

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