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 (dict, optional) – Keywords arguments.
Returns: Current figure or None.
Return type: Figure
Examples
>>> from colour import ( ... ILLUMINANTS_RELATIVE_SPDS, ... LIGHT_SOURCES_RELATIVE_SPDS, ... SpectralShape) >>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('F2') >>> light_source = LIGHT_SOURCES_RELATIVE_SPDS.get('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 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: Current figure or None.
Return type: Figure
Examples
>>> from colour import ILLUMINANTS_RELATIVE_SPDS >>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('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 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: Current figure or None.
Return type: Figure
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])
-
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: Current figure or None.
Return type: Figure
Examples
>>> from colour import ILLUMINANTS_RELATIVE_SPDS >>> illuminant = ILLUMINANTS_RELATIVE_SPDS.get('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 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: Current figure or None.
Return type: Figure
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])