Plotting#

Common#

colour.plotting

colour_style([use_style])

Return Colour plotting style.

colour_cycle(**kwargs)

Return a colour cycle iterator using given colour map.

artist(**kwargs)

Return the current figure and its axes or creates a new one.

camera(**kwargs)

Set the camera settings.

render(**kwargs)

Render 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)

Set equal aspect ratio to given 3d axes.

plot_single_colour_swatch(colour_swatch, ...)

Plot given colour swatch.

plot_multi_colour_swatches(colour_swatches)

Plot given colours swatches.

plot_single_function(function[, samples, ...])

Plot given function.

plot_multi_functions(functions[, samples, ...])

Plot given functions.

plot_image(image[, imshow_kwargs, text_kwargs])

Plot given image.

Ancillary Objects

colour.plotting.common

KwargsArtist(*args, **kwargs)

Define the keyword argument types for the colour.plotting.artist() definition.

KwargsCamera(*args, **kwargs)

Define the keyword argument types for the colour.plotting.camera() definition.

KwargsRender(*args, **kwargs)

Define the keyword argument types for the colour.plotting.render() definition.

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.

Ancillary Objects

colour.plotting.temperature

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[, ...])

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.