colour.plotting.quality Module¶

Colour Quality Plotting¶

Defines the colour quality plotting objects:

single_spd_colour_rendering_index_bars_plot()
multi_spd_colour_rendering_index_bars_plot()
single_spd_colour_quality_scale_bars_plot()
multi_spd_colour_quality_scale_bars_plot()

colour.plotting.quality.colour_quality_bars_plot(specifications, labels=True, hatching=None, hatching_repeat=1, **kwargs)[source]¶

Plots the colour quality data of given illuminants or light sources colour quality specifications.

Other Parameters:
Parameters:	specifications (array_like) – Array of illuminants or light sources colour quality specifications. labels (bool, optional) – Add labels above bars. hatching (bool or None, optional) – Use hatching for the bars. hatching_repeat (int, optional) – Hatching pattern repeat.
	*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

>>> from colour import (
...     ILLUMINANTS_RELATIVE_SPDS,
...     LIGHT_SOURCES_RELATIVE_SPDS,
...     SpectralShape)
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS['F2']
>>> light_source = LIGHT_SOURCES_RELATIVE_SPDS['Kinoton 75P']
>>> light_source = light_source.clone().align(SpectralShape(360, 830, 1))
>>> cqs_i = colour_quality_scale(illuminant, additional_data=True)
>>> cqs_l = colour_quality_scale(light_source, additional_data=True)
>>> colour_quality_bars_plot([cqs_i, cqs_l])  

colour.plotting.quality.single_spd_colour_rendering_index_bars_plot(spd, **kwargs)[source]¶

Plots the Colour Rendering Index (CRI) of given illuminant or light source spectral power distribution.

Other Parameters:
Parameters:	spd (SpectralPowerDistribution) – Illuminant or light source spectral power distribution to plot the Colour Rendering Index (CRI).
	*kwargs (dict, optional) – {`boundaries()`, `canvas()`, `decorate()`, `display()`}, Please refer to the documentation of the previously listed definitions. labels* (bool, optional) – {`colour_quality_bars_plot()`}, Add labels above bars. hatching (bool or None, optional) – {`colour_quality_bars_plot()`}, Use hatching for the bars. hatching_repeat (int, optional) – {`colour_quality_bars_plot()`}, Hatching pattern repeat.
Returns:	Current figure or None.
Return type:	Figure

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS['F2']
>>> single_spd_colour_rendering_index_bars_plot(  
...     illuminant)

colour.plotting.quality.multi_spd_colour_rendering_index_bars_plot(spds, **kwargs)[source]¶

Plots the Colour Rendering Index (CRI) of given illuminants or light sources spectral power distributions.

Other Parameters:
Parameters:	spds (array_like) – Array of illuminants or light sources spectral power distributions to plot the Colour Rendering Index (CRI).
	*kwargs (dict, optional) – {`boundaries()`, `canvas()`, `decorate()`, `display()`}, Please refer to the documentation of the previously listed definitions. labels* (bool, optional) – {`colour_quality_bars_plot()`}, Add labels above bars. hatching (bool or None, optional) – {`colour_quality_bars_plot()`}, Use hatching for the bars. hatching_repeat (int, optional) – {`colour_quality_bars_plot()`}, Hatching pattern repeat.
Returns:	Current figure or None.
Return type:	Figure

Examples

>>> from colour import (
...     ILLUMINANTS_RELATIVE_SPDS,
...     LIGHT_SOURCES_RELATIVE_SPDS)
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS['F2']
>>> light_source = LIGHT_SOURCES_RELATIVE_SPDS['Kinoton 75P']
>>> multi_spd_colour_rendering_index_bars_plot(  
...     [illuminant, light_source])

colour.plotting.quality.single_spd_colour_quality_scale_bars_plot(spd, **kwargs)[source]¶

Plots the Colour Quality Scale (CQS) of given illuminant or light source spectral power distribution.

Other Parameters:
Parameters:	spd (SpectralPowerDistribution) – Illuminant or light source spectral power distribution to plot the Colour Quality Scale (CQS).
	*kwargs (dict, optional) – {`boundaries()`, `canvas()`, `decorate()`, `display()`}, Please refer to the documentation of the previously listed definitions. labels* (bool, optional) – {`colour_quality_bars_plot()`}, Add labels above bars. hatching (bool or None, optional) – {`colour_quality_bars_plot()`}, Use hatching for the bars. hatching_repeat (int, optional) – {`colour_quality_bars_plot()`}, Hatching pattern repeat.
Returns:	Current figure or None.
Return type:	Figure

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS['F2']
>>> single_spd_colour_quality_scale_bars_plot(  
...     illuminant)

colour.plotting.quality.multi_spd_colour_quality_scale_bars_plot(spds, **kwargs)[source]¶

Plots the Colour Quality Scale (CQS) of given illuminants or light sources spectral power distributions.

Other Parameters:
Parameters:	spds (array_like) – Array of illuminants or light sources spectral power distributions to plot the Colour Quality Scale (CQS).
	*kwargs (dict, optional) – {`boundaries()`, `canvas()`, `decorate()`, `display()`}, Please refer to the documentation of the previously listed definitions. labels* (bool, optional) – {`colour_quality_bars_plot()`}, Add labels above bars. hatching (bool or None, optional) – {`colour_quality_bars_plot()`}, Use hatching for the bars. hatching_repeat (int, optional) – {`colour_quality_bars_plot()`}, Hatching pattern repeat.
Returns:	Current figure or None.
Return type:	Figure

Examples

>>> from colour import (
...     ILLUMINANTS_RELATIVE_SPDS,
...     LIGHT_SOURCES_RELATIVE_SPDS)
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS['F2']
>>> light_source = LIGHT_SOURCES_RELATIVE_SPDS['Kinoton 75P']
>>> multi_spd_colour_quality_scale_bars_plot(  
...     [illuminant, light_source])