Plotting¶

Common
Colorimetry
Colour Vision Deficiency
Colour Characterisation
Corresponding Chromaticities
CIE Chromaticity Diagrams
Colour Models
Colour Notation Systems
Optical Phenomena
Colour Quality
Colour Temperature & Correlated Colour Temperature
ANSI/IES TM-30-18 Colour Rendition Report
Colour Models Volume
Automatic Colour Conversion Graph

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[, imshow_kwargs, text_kwargs])	Plots given image.

Colorimetry ¶

colour.plotting

`plot_single_sd`(sd[, cmfs, ...])	Plots given spectral distribution.
`plot_multi_sds`(sds[, plot_kwargs])	Plots given spectral distributions.
`plot_single_cmfs`([cmfs])	Plots given colour matching functions.
`plot_multi_cmfs`(cmfs, **kwargs)	Plots given colour matching functions.
`plot_single_illuminant_sd`(illuminant[, cmfs])	Plots given single illuminant spectral distribution.
`plot_multi_illuminant_sds`(illuminants, **kwargs)	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 [] or [] 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`(...)	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.

ANSI/IES TM-30-18 Colour Rendition Report ¶

colour.plotting

plot_single_sd_colour_rendition_report(sd[, ...])

Generates the ANSI/IES TM-30-18 Colour Rendition Report for given spectral distribution according to given method.

Ancillary Objects

colour.plotting.tm3018

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

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.

Automatic Colour Conversion Graph ¶

colour.plotting

plot_automatic_colour_conversion_graph(filename)

Plots Colour automatic colour conversion graph using Graphviz and pyraphviz.