Plotting

Common

colour.plotting

colour_style([use_style])	Returns Colour plotting style.
colour_cycle(**kwargs)	Returns a colour cycle iterator using given colour map.
artist(**kwargs)	Returns the current figure and its axes or creates a new one.
camera(**kwargs)	Sets the camera settings.
render(**kwargs)	Renders the current figure while adjusting various settings such as the bounding box, the title or background transparency.
label_rectangles(labels, rectangles[, …])	Add labels above given rectangles.
uniform_axes3d(**kwargs)	Sets equal aspect ratio to given 3d axes.
plot_single_colour_swatch(colour_swatch, …)	Plots given colour swatch.
plot_multi_colour_swatches(colour_swatches)	Plots given colours swatches.
plot_single_function(function[, samples, …])	Plots given function.
plot_multi_functions(functions[, samples, …])	Plots given functions.
plot_image(image[, text_parameters, …])	Plots given image.

Colorimetry

colour.plotting

plot_single_sd(sd[, cmfs, …])	Plots given spectral distribution.
plot_multi_sds(sds[, cmfs, use_sds_colours, …])	Plots given spectral distributions.
plot_single_cmfs([cmfs])	Plots given colour matching functions.
plot_multi_cmfs([cmfs])	Plots given colour matching functions.
plot_single_illuminant_sd([illuminant, cmfs])	Plots given single illuminant spectral distribution.
plot_multi_illuminant_sds([illuminants])	Plots given illuminants spectral distributions.
plot_visible_spectrum([cmfs, …])	Plots the visible colours spectrum using given standard observer CIE XYZ colour matching functions.
plot_single_lightness_function([function])	Plots given Lightness function.
plot_multi_lightness_functions([functions])	Plots given Lightness functions.
plot_single_luminance_function([function])	Plots given Luminance function.
plot_multi_luminance_functions([functions])	Plots given Luminance functions.
plot_blackbody_spectral_radiance([…])	Plots given blackbody spectral radiance.
plot_blackbody_colours([shape, cmfs])	Plots blackbody colours.

Colour Vision Deficiency

colour.plotting

plot_cvd_simulation_Machado2009(RGB[, …])

Performs colour vision deficiency simulation on given RGB colourspace array using Machado et al.(2009) model..

Colour Characterisation

colour.plotting

plot_single_colour_checker([colour_checker])	Plots given colour checker.
plot_multi_colour_checkers([colour_checkers])	Plots and compares given colour checkers.

Corresponding Chromaticities

colour.plotting

plot_corresponding_chromaticities_prediction([…])

Plots given chromatic adaptation model corresponding chromaticities prediction.

CIE Chromaticity Diagrams

colour.plotting

plot_chromaticity_diagram_CIE1931([cmfs, …])	Plots the CIE 1931 Chromaticity Diagram.
plot_chromaticity_diagram_CIE1960UCS([cmfs, …])	Plots the CIE 1960 UCS Chromaticity Diagram.
plot_chromaticity_diagram_CIE1976UCS([cmfs, …])	Plots the CIE 1976 UCS Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1931(sds)	Plots given spectral distribution chromaticity coordinates into the CIE 1931 Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1960UCS(sds)	Plots given spectral distribution chromaticity coordinates into the CIE 1960 UCS Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1976UCS(sds)	Plots given spectral distribution chromaticity coordinates into the CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.diagrams

plot_spectral_locus([cmfs, …])	Plots the Spectral Locus according to given method.
plot_chromaticity_diagram_colours([samples, …])	Plots the Chromaticity Diagram colours according to given method.
plot_chromaticity_diagram([cmfs, …])	Plots the Chromaticity Diagram according to given method.
plot_sds_in_chromaticity_diagram(sds[, …])	Plots given spectral distribution chromaticity coordinates into the Chromaticity Diagram using given method.

Colour Models

colour.plotting

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

Ancillary Objects

colour.plotting.models

common_colourspace_model_axis_reorder(a[, model])	Reorder the axes of given colourspace model \(a\) array according to the most common volume plotting axes order.
plot_pointer_gamut([method])	Plots Pointer’s Gamut according to given method.
plot_RGB_colourspaces_in_chromaticity_diagram([…])	Plots given RGB colourspaces in the Chromaticity Diagram according to given method.
plot_RGB_chromaticities_in_chromaticity_diagram(RGB)	Plots given RGB colourspace array in the Chromaticity Diagram according to given method.

Colour Notation Systems

colour.plotting

plot_single_munsell_value_function([function])	Plots given Lightness function.
plot_multi_munsell_value_functions([functions])	Plots given Munsell value functions.

Optical Phenomena

colour.plotting

plot_single_sd_rayleigh_scattering([…])	Plots a single Rayleigh scattering spectral distribution.
plot_the_blue_sky([cmfs])	Plots the blue sky.

Colour Quality

colour.plotting

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

Ancillary Objects

colour.plotting.quality

plot_colour_quality_bars(specifications[, …])

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

Colour Temperature & Correlated Colour Temperature

colour.plotting

plot_planckian_locus_in_chromaticity_diagram_CIE1931([…])	Plots the Planckian Locus and given illuminants in CIE 1931 Chromaticity Diagram.
plot_planckian_locus_in_chromaticity_diagram_CIE1960UCS([…])	Plots the Planckian Locus and given illuminants in CIE 1960 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.temperature

plot_planckian_locus([…])	Plots the Planckian Locus according to given method.
plot_planckian_locus_CIE1931([…])	Plots the Planckian Locus according to CIE 1931 method.
plot_planckian_locus_CIE1960UCS([…])	Plots the Planckian Locus according to CIE 1960 UCS method.
plot_planckian_locus_in_chromaticity_diagram([…])	Plots the Planckian Locus and given illuminants in the Chromaticity Diagram according to given method.

Colour Models Volume

colour.plotting

plot_RGB_colourspaces_gamuts([colourspaces, …])	Plots given RGB colourspaces gamuts in given reference colourspace.
plot_RGB_scatter(RGB, colourspace[, …])	Plots given RGB colourspace array in a scatter plot.

Geometry Plotting Utilities

colour.plotting

quad([plane, origin, width, height, depth])	Returns the vertices of a quad geometric element in counter-clockwise order.
grid([plane, origin, width, height, depth, …])	Returns the vertices of a grid made of quads.
cube([plane, origin, width, height, depth, …])	Returns the vertices of a cube made of grids.

Automatic Colour Conversion Graph

colour.plotting

plot_automatic_colour_conversion_graph(filename)

Plots Colour automatic colour conversion graph using Graphviz and pyraphviz.