Plotting

Common

colour.plotting

ColourSwatch(RGB, name)

Define a data structure for a colour swatch.

z

colour_style colour_cycle artist camera render label_rectangles uniform_axes3d plot_single_colour_swatch plot_multi_colour_swatches plot_single_function plot_multi_functions plot_image

Ancillary Objects

colour.plotting.common

KwargsArtist	Define the 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.
filter_passthrough(mapping, filterers[, ...])	Return mapping objects matching given filterers while passing through class instances whose type is one of the mapping element types.
filter_RGB_colourspaces(filterers[, ...])	Return the RGB colourspaces matching given filterers.
filter_cmfs(filterers[, allow_non_siblings])	Return the colour matching functions matching given filterers.
filter_illuminants(filterers[, ...])	Return the illuminants matching given filterers.
filter_colour_checkers(filterers[, ...])	Return the colour checkers matching given filterers.

Colorimetry

colour.plotting

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

Colour Vision Deficiency

colour.plotting

plot_cvd_simulation_Machado2009(RGB[, ...])

Perform 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])	Plot given colour checker.
plot_multi_colour_checkers(colour_checkers, ...)	Plot and compares given colour checkers.

Corresponding Chromaticities

colour.plotting

plot_corresponding_chromaticities_prediction([...])

Plot given chromatic adaptation model corresponding chromaticities prediction.

CIE Chromaticity Diagrams

colour.plotting

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 given spectral distribution chromaticity coordinates into the CIE 1931 Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1960UCS(sds)	Plot given spectral distribution chromaticity coordinates into the CIE 1960 UCS Chromaticity Diagram.
plot_sds_in_chromaticity_diagram_CIE1976UCS(sds)	Plot given spectral distribution chromaticity coordinates into the CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.diagrams

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

Colour Models

colour.plotting

plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931(...)	Plot given RGB colourspaces in the CIE 1931 Chromaticity Diagram.
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1960UCS(...)	Plot given RGB colourspaces in the CIE 1960 UCS Chromaticity Diagram.
plot_RGB_colourspaces_in_chromaticity_diagram_CIE1976UCS(...)	Plot given RGB colourspaces in the CIE 1976 UCS Chromaticity Diagram.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931(RGB)	Plot given RGB colourspace array in the CIE 1931 Chromaticity Diagram.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1960UCS(RGB)	Plot given RGB colourspace array in the CIE 1960 UCS Chromaticity Diagram.
plot_RGB_chromaticities_in_chromaticity_diagram_CIE1976UCS(RGB)	Plot given RGB colourspace array in the CIE 1976 UCS Chromaticity Diagram.
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_single_cctf(cctf[, cctf_decoding])	Plot given colourspace colour component transfer function.
plot_multi_cctfs(cctfs[, cctf_decoding])	Plot given colour component transfer functions.
plot_constant_hue_loci(data[, model, ...])	Plot 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

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([pointer_gamut_colours, ...])	Plot Pointer's Gamut according to given method.
plot_RGB_colourspaces_in_chromaticity_diagram(...)	Plot given RGB colourspaces in the Chromaticity Diagram according to given method.
plot_RGB_chromaticities_in_chromaticity_diagram(RGB)	Plot given RGB colourspace array in the Chromaticity Diagram according to given method.
plot_ellipses_MacAdam1942_in_chromaticity_diagram([...])	Plot MacAdam (1942) Ellipses (Observer PGN) in the Chromaticity Diagram according to given method.

Colour Notation Systems

colour.plotting

plot_single_munsell_value_function(function, ...)	Plot given Lightness function.
plot_multi_munsell_value_functions(...)	Plot given Munsell value functions.

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.

Colour Quality

colour.plotting

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

Ancillary Objects

colour.plotting.quality

plot_colour_quality_bars(specifications[, ...])

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

Gamut Section Plotting

colour.plotting

plot_visible_spectrum_section([cmfs, ...])	Plot the visible spectrum volume, i.e. Rösch-MacAdam colour solid, section colours along given axis and origin.
plot_RGB_colourspace_section(colourspace[, ...])	Plot given RGB colourspace section colours along given axis and origin.

Ancillary Objects

colour.plotting.section

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

Colour Temperature & Correlated Colour Temperature

colour.plotting

plot_planckian_locus_in_chromaticity_diagram_CIE1931(...)	Plot the Planckian Locus and given illuminants in CIE 1931 Chromaticity Diagram.
plot_planckian_locus_in_chromaticity_diagram_CIE1960UCS(...)	Plot the Planckian Locus and given illuminants in CIE 1960 UCS Chromaticity Diagram.
plot_planckian_locus_in_chromaticity_diagram_CIE1976UCS(...)	Plot the Planckian Locus and given illuminants in CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.temperature

plot_daylight_locus([...])	Plot the Daylight Locus according to given method.
plot_planckian_locus([...])	Plot the Planckian Locus according to given method.
plot_planckian_locus_in_chromaticity_diagram(...)	Plot the Planckian Locus and given illuminants in the Chromaticity Diagram according to given method.

Colour Models Volume

colour.plotting

plot_RGB_colourspaces_gamuts(colourspaces[, ...])	Plot given RGB colourspaces gamuts in given reference colourspace.
plot_RGB_scatter(RGB[, colourspace, model, ...])	Plot given 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 given spectral distribution according to given 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 given spectral distribution.
plot_single_sd_colour_rendition_report_intermediate(sd)	Generate the intermediate ANSI/IES TM-30-18 Colour Rendition Report for given spectral distribution.
plot_single_sd_colour_rendition_report_simple(sd)	Generate the simple ANSI/IES TM-30-18 Colour Rendition Report for given spectral distribution.

Automatic Colour Conversion Graph

colour.plotting

plot_automatic_colour_conversion_graph(filename)

Plot Colour automatic colour conversion graph using Graphviz and pyraphviz.