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(axes) 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, decoding_cctf]) Plots given colourspace colour component transfer function.
plot_multi_cctfs([cctfs, decoding_cctf]) Plots given colour component transfer functions.

Ancillary Objects

colour.plotting.models

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(…) 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_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.