Plotting#

Common#

colour.plotting

ColourSwatch(RGB, name)

Define a data structure for a colour swatch.

colour_style([use_style])

Return Colour plotting style.

override_style(**kwargs)

Decorate a function to override Matplotlib 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

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.

font_scaling(scaling, value)

Define a context manager setting temporarily a Matplotlib font scaling.

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

METHODS_CHROMATICITY_DIAGRAM

Implement a delimiter and case-insensitive dict-like object with support for slugs, i.e. SEO friendly and human-readable version of the keys but also canonical keys, i.e. slugified keys without delimiters.

LABELS_CHROMATICITY_DIAGRAM_DEFAULT

Implement a delimiter and case-insensitive dict-like object with support for slugs, i.e. SEO friendly and human-readable version of the keys but also canonical keys, i.e. slugified keys without delimiters.

lines_spectral_locus([cmfs, labels, method])

Return the Spectral Locus line vertices, i.e. positions, normals and colours, according to given method.

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.

lines_pointer_gamut([method])

Return the Pointer's Gamut line vertices, i.e. positions, normals and colours, according to given method.

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

lines_daylight_locus([mireds, method])

Return the Daylight Locus line vertices, i.e. positions, normals and colours, according to given method.

LABELS_PLANCKIAN_LOCUS_DEFAULT

Implement a delimiter and case-insensitive dict-like object with support for slugs, i.e. SEO friendly and human-readable version of the keys but also canonical keys, i.e. slugified keys without delimiters.

lines_planckian_locus([labels, mireds, ...])

Return the Planckian Locus line vertices, i.e. positions, normals and colours, according to given method.

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.