colour.plotting.quality Module

Colour Quality Plotting

Defines the colour quality plotting objects:

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 (dict, optional) – 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 (dict, optional) – 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 (dict, optional) – 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 (dict, optional) – 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 (dict, optional) – 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