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.