Plotting

Common

colour.plotting

ColourSwatch(RGB, name)

Define a data structure for a colour swatch.

artist(**kwargs)	Return the current figure and its axes or create a new one.
camera(**kwargs)	Configure camera settings for the current 3D visualization.
colour_cycle(**kwargs)	Create a colour cycle iterator using the specified colour map.
colour_style([use_style])	Return the Colour plotting style configuration.
label_rectangles(labels, rectangles[, ...])	Add labels above specified rectangles.
override_style(**kwargs)	Decorate a function to override Matplotlib style.
plot_image(image[, imshow_kwargs, text_kwargs])	Plot the specified image using matplotlib.
plot_multi_colour_swatches(colour_swatches)	Plot colour swatches with configurable layout and comparison options.
plot_multi_functions(functions[, samples, ...])	Plot specified functions.
plot_single_colour_swatch(colour_swatch, ...)	Plot a single colour swatch.
plot_single_function(function[, samples, ...])	Plot the specified function.
render(**kwargs)	Render the current figure while adjusting various settings such as the bounding box, title, or background transparency.
uniform_axes3d(**kwargs)	Set equal aspect ratio to the specified 3D axes.

Ancillary Objects

colour.plotting.common

filter_cmfs(filterers[, allow_non_siblings])	Filter the colour matching functions matching the specified filterers.
filter_colour_checkers(filterers[, ...])	Filter the colour checkers matching the specified filterers.
filter_illuminants(filterers[, ...])	Filter the illuminants matching the specified filterers.
filter_passthrough(mapping, filterers[, ...])	Filter mapping objects matching specified filterers while passing through class instances whose type is one of the mapping element types.
filter_RGB_colourspaces(filterers[, ...])	Filter the RGB colourspaces matching the specified filterers.
font_scaling(scaling, value)	Set a temporary Matplotlib font scaling using a context manager.
KwargsArtist	Define keyword argument types for the colour.plotting.artist() definition.
KwargsCamera	Define the keyword argument types for the colour.plotting.camera() definition.
KwargsRender	Define the keyword argument types for the colour.plotting.render() definition.

Colorimetry

colour.plotting

plot_blackbody_colours([shape, cmfs])	Plot blackbody colours across a temperature range.
plot_blackbody_spectral_radiance([...])	Plot the spectral radiance of a blackbody at the specified temperature.
plot_multi_cmfs(cmfs, **kwargs)	Plot the specified colour matching functions.
plot_multi_illuminant_sds(illuminants, **kwargs)	Plot the spectral distributions of the specified illuminants.
plot_multi_lightness_functions(functions, ...)	Plot the specified Lightness functions.
plot_multi_luminance_functions(functions, ...)	Plot the specified Luminance functions.
plot_multi_sds(sds[, plot_kwargs])	Plot specified spectral distributions.
plot_single_cmfs([cmfs])	Plot specified colour matching functions.
plot_single_illuminant_sd(illuminant[, cmfs])	Plot the specified single illuminant spectral distribution.
plot_single_lightness_function(function, ...)	Plot the specified Lightness function.
plot_single_luminance_function(function, ...)	Plot the specified Luminance function.
plot_single_sd(sd[, cmfs, ...])	Plot the specified spectral distribution.
plot_visible_spectrum([cmfs, ...])	Plot the visible colour spectrum using the specified standard observer CIE XYZ colour matching functions.

Colour Vision Deficiency

colour.plotting

plot_cvd_simulation_Machado2009(RGB[, ...])

Perform colour vision deficiency simulation on the specified RGB colourspace array using the Machado et al. (2009) model.

Colour Characterisation

colour.plotting

plot_multi_colour_checkers(colour_checkers, ...)	Plot and compare the specified colour checkers.
plot_single_colour_checker([colour_checker])	Plot the specified colour checker.

Corresponding Chromaticities

colour.plotting

plot_corresponding_chromaticities_prediction([...])

Plot the corresponding chromaticities prediction for the specified chromatic adaptation model.

CIE Chromaticity Diagrams

colour.plotting

LABELS_CHROMATICITY_DIAGRAM_DEFAULT	Represent a delimiter and case-insensitive dict-like object supporting both slug keys (SEO-friendly, human-readable versions with delimiters) and canonical keys (slugified keys without delimiters).
lines_spectral_locus([cmfs, labels, method])	Return the Spectral Locus line vertices, i.e., positions, normals and colours, using the specified method.
METHODS_CHROMATICITY_DIAGRAM	Represent a delimiter and case-insensitive dict-like object supporting both slug keys (SEO-friendly, human-readable versions with delimiters) and canonical keys (slugified keys without delimiters).
plot_chromaticity_diagram_CIE1931([cmfs, ...])	Plot the CIE 1931 Chromaticity Diagram.
plot_chromaticity_diagram_CIE1960UCS([cmfs, ...])	Plot the CIE 1960 UCS Chromaticity Diagram.
plot_chromaticity_diagram_CIE1976UCS([cmfs, ...])	Plot the CIE 1976 UCS Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1931(sds)	Plot specified spectral distribution chromaticity coordinates in the CIE 1931 Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1960UCS(sds)	Plot spectral distribution chromaticity coordinates in the CIE 1960 UCS Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1976UCS(sds)	Plot specified spectral distribution chromaticity coordinates in the CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.diagrams

plot_chromaticity_diagram([cmfs, ...])	Plot the Chromaticity Diagram using the specified method.
plot_chromaticity_diagram_colours([samples, ...])	Plot the Chromaticity Diagram colours using the specified method.
plot_sds_in_chromaticity_diagram(sds[, ...])	Plot specified spectral distribution chromaticity coordinates into the Chromaticity Diagram using the specified method.
plot_spectral_locus([cmfs, ...])	Plot the Spectral Locus using the specified method.

Colour Models

colour.plotting

plot_constant_hue_loci(data[, model, ...])	Plot specified constant hue loci colour matches data such as that from [HB95] or [EF98] that are easily loaded with Colour - Datasets.
plot_ellipses_MacAdam1942_in_chromaticity_diagram_CIE1931([...])	Plot MacAdam (1942) Ellipses (Observer PGN) in the CIE 1931 Chromaticity Diagram.
plot_ellipses_MacAdam1942_in_chromaticity_diagram_CIE1960UCS([...])	Plot MacAdam (1942) Ellipses (Observer PGN) in the CIE 1960 UCS Chromaticity Diagram.
plot_ellipses_MacAdam1942_in_chromaticity_diagram_CIE1976UCS([...])	Plot MacAdam (1942) Ellipses (Observer PGN) in the CIE 1976 UCS Chromaticity Diagram.
plot_multi_cctfs(cctfs[, cctf_decoding])	Plot the specified colour component transfer functions.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931(RGB)	Plot specified RGB colourspace array in the CIE 1931 Chromaticity Diagram.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1960UCS(RGB)	Plot the specified RGB colourspace array in the CIE 1960 UCS Chromaticity Diagram.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1976UCS(RGB)	Plot the specified RGB colourspace array in the CIE 1976 UCS Chromaticity Diagram.
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931(...)	Plot specified RGB colourspaces in the CIE 1931 Chromaticity Diagram.
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1960UCS(...)	Plot specified RGB colourspaces in the CIE 1960 UCS Chromaticity Diagram.
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1976UCS(...)	Plot the specified RGB colourspaces in the CIE 1976 UCS Chromaticity Diagram.
plot_single_cctf(cctf[, cctf_decoding])	Plot specified colourspace colour component transfer function.

Ancillary Objects

colour.plotting.models

colourspace_model_axis_reorder(a, model[, ...])	Reorder the axes of the specified colourspace model array \(a\) to match the standard axes order used for volume plotting.
lines_pointer_gamut([method])	Return the Pointer's Gamut line vertices, i.e., positions, normals, and colours, using the specified chromaticity diagram method.
plot_ellipses_MacAdam1942_in_chromaticity_diagram([...])	Plot MacAdam (1942) Ellipses (Observer PGN) in the Chromaticity Diagram using the specified method.
plot_pointer_gamut([pointer_gamut_colours, ...])	Plot Pointer's Gamut using the specified plotting method.
plot_RGB_chromaticities_in_chromaticity_diagram(RGB)	Plot the specified RGB colourspace array in the Chromaticity Diagram using the specified method.
plot_RGB_colourspaces_in_chromaticity_diagram(...)	Plot specified RGB colourspaces in the Chromaticity Diagram using the specified method.

Colour Notation Systems

colour.plotting

plot_multi_munsell_value_functions(...)	Plot the specified Munsell value functions.
plot_single_munsell_value_function(function, ...)	Plot the specified Munsell value function.

Optical Phenomena

colour.plotting

plot_single_sd_rayleigh_scattering([...])	Plot a single Rayleigh scattering spectral distribution.
plot_the_blue_sky([cmfs])	Plot the blue sky spectral radiance distribution.
plot_sky_luminance_distribution_CIE2003([...])	Plot the CIE Standard General Sky luminance distribution for the given sky type.
plot_sky_radiance_Wilkie2021(dataset[, ...])	Plot the Prague Sky Model sky radiance distribution for the given atmospheric configuration and wavelength.
plot_sky_colour_Wilkie2021(dataset[, ...])	Plot a true colour rendering of the sky using the Prague Sky Model.
plot_single_layer_thin_film(n, t[, theta, ...])	Plot reflectance and/or transmittance of a single-layer thin film.
plot_multi_layer_thin_film(n, t[, theta, ...])	Plot reflectance and/or transmittance of a multi-layer thin film stack.
plot_thin_film_comparison(configurations[, ...])	Plot comparison of multiple thin film configurations.
plot_thin_film_spectrum(n, t[, theta, shape])	Plot reflectance spectrum of thin film using Transfer Matrix Method.
plot_thin_film_iridescence(n[, t, theta, ...])	Plot thin film iridescence colours.
plot_thin_film_reflectance_map(n[, t, ...])	Plot thin film reflectance as a 2D pseudocolor map.
plot_multi_layer_stack(configurations[, ...])	Plot a multilayer stack as a stacked horizontal bar chart with optional ray paths.

Colour Quality

colour.plotting

plot_multi_sds_colour_quality_scales_bars(sds)	Plot the Colour Quality Scale (CQS) of the specified illuminants or light sources spectral distributions.
plot_multi_sds_colour_rendering_indexes_bars(...)	Plot the Colour Rendering Index (CRI) of the specified illuminants or light sources spectral distributions.
plot_single_sd_colour_quality_scale_bars(sd)	Plot the Colour Quality Scale (CQS) of the specified illuminant or light source spectral distribution.
plot_single_sd_colour_rendering_index_bars(sd, ...)	Plot the Colour Rendering Index (CRI) of the specified illuminant or light source spectral distribution.

Ancillary Objects

colour.plotting.quality

plot_colour_quality_bars(specifications[, ...])

Plot the colour quality data of the specified illuminants or light sources colour quality specifications.

Gamut Section Plotting

colour.plotting

plot_RGB_colourspace_section(colourspace[, ...])	Plot the specified RGB colourspace section colours along the specified axis and origin.
plot_visible_spectrum_section([cmfs, ...])	Plot the visible spectrum volume section colours along the specified axis and origin.

Ancillary Objects

colour.plotting.section

plot_hull_section_colours(hull[, model, ...])	Plot the section colours of the specified trimesh hull along the specified axis and origin.
plot_hull_section_contour(hull[, model, ...])	Plot the section contour of the specified trimesh hull along the specified axis and origin.

Colour Temperature & Correlated Colour Temperature

colour.plotting

LABELS_PLANCKIAN_LOCUS_DEFAULT	Represent a delimiter and case-insensitive dict-like object supporting both slug keys (SEO-friendly, human-readable versions with delimiters) and canonical keys (slugified keys without delimiters).
lines_daylight_locus([mireds, method])	Return the Daylight Locus line vertices including positions, normals, and colours using the specified chromaticity diagram method.
lines_planckian_locus([labels, mireds, ...])	Return the Planckian Locus line vertices with positions, normals, and colours using the specified chromaticity diagram method.
plot_planckian_locus_in_chromaticity_diagram_CIE1931([...])	Plot the Planckian Locus and specified illuminants in the CIE 1931 Chromaticity Diagram.
plot_planckian_locus_in_chromaticity_diagram_CIE1960UCS([...])	Plot the Planckian Locus and specified illuminants in the CIE 1960 UCS Chromaticity Diagram.
plot_planckian_locus_in_chromaticity_diagram_CIE1976UCS([...])	Plot the Planckian Locus and specified illuminants in the CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.temperature

plot_daylight_locus([...])	Plot the Daylight Locus using the specified chromaticity diagram method.
plot_planckian_locus([...])	Plot the Planckian Locus using the specified method.
plot_planckian_locus_in_chromaticity_diagram([...])	Plot the Planckian Locus and specified illuminants in the Chromaticity Diagram using the specified method.

Colour Models Volume

colour.plotting

plot_RGB_colourspaces_gamuts(colourspaces[, ...])	Plot the gamuts of the specified RGB colourspaces in the specified reference colourspace.
plot_RGB_scatter(RGB[, colourspace, model, ...])	Plot the specified RGB colourspace array in a scatter plot.

ANSI/IES TM-30-18 Colour Rendition Report

colour.plotting

plot_single_sd_colour_rendition_report(sd[, ...])

Generate the ANSI/IES TM-30-18 Colour Rendition Report for the specified spectral distribution using the specified method.

Ancillary Objects

colour.plotting.tm3018

plot_single_sd_colour_rendition_report_full(sd)	Generate the full ANSI/IES TM-30-18 Colour Rendition Report for the specified spectral distribution.
plot_single_sd_colour_rendition_report_intermediate(sd)	Generate the intermediate ANSI/IES TM-30-18 Colour Rendition Report for the specified spectral distribution.
plot_single_sd_colour_rendition_report_simple(sd)	Generate the simple ANSI/IES TM-30-18 Colour Rendition Report for the specified spectral distribution.

Automatic Colour Conversion Graph

colour.plotting

plot_automatic_colour_conversion_graph(filename)

Plot Colour automatic colour conversion graph using Graphviz and pyraphviz.