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.

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 (**) – Keywords arguments.
Returns:	Definition success.
Return type:	bool

Examples

>>> from colour import (
...     ILLUMINANTS_RELATIVE_SPDS,
...     LIGHT_SOURCES_RELATIVE_SPDS)
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('F2')
>>> light_source = LIGHT_SOURCES_RELATIVE_SPDS.get('Kinoton 75P')
>>> 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])  
True

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

Plots the colour rendering index of given illuminant or light source spectral power distribution.

Parameters:	spd (SpectralPowerDistribution) – Illuminant or light source spectral power distribution to plot the colour rendering index. **kwargs (**) – Keywords arguments.
Returns:	Definition success.
Return type:	bool

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('F2')
>>> single_spd_colour_rendering_index_bars_plot(  
...     illuminant)
True

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

Plots the colour rendering index of given illuminants or light sources spectral power distributions.

Parameters:	spds (array_like) – Array of illuminants or light sources spectral power distributions to plot the colour rendering index. **kwargs (**) – Keywords arguments.
Returns:	Definition success.
Return type:	bool

Examples

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

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

Plots the colour quality scale of given illuminant or light source spectral power distribution.

Parameters:	spd (SpectralPowerDistribution) – Illuminant or light source spectral power distribution to plot the colour quality scale. **kwargs (**) – Keywords arguments.
Returns:	Definition success.
Return type:	bool

Examples

>>> from colour import ILLUMINANTS_RELATIVE_SPDS
>>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('F2')
>>> single_spd_colour_quality_scale_bars_plot(  
...     illuminant)
True

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

Plots the colour quality scale of given illuminants or light sources spectral power distributions.

Parameters:	spds (array_like) – Array of illuminants or light sources spectral power distributions to plot the colour quality scale. **kwargs (**) – Keywords arguments.
Returns:	Definition success.
Return type:	bool

Examples

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