Plotting#

Common#

colour.plotting

ColourSwatch(RGB, name)

Define a data structure for a colour swatch.

colour_style([use_style])

Get Colour plotting style.

override_style(**kwargs)

Decorate a function to override Matplotlib style.

colour_cycle(**kwargs)

Create a colour cycle iterator using specified colour map.

artist(**kwargs)

Get the current figure and its axes or create 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 specified rectangles.

uniform_axes3d(**kwargs)

Set equal aspect ratio to specified 3d axes.

plot_single_colour_swatch(colour_swatch, ...)

Plot specified colour swatch.

plot_multi_colour_swatches(colour_swatches)

Plot specified colours swatches.

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

Plot specified function.

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

Plot specified functions.

plot_image(image[, imshow_kwargs, text_kwargs])

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

Filter mapping objects matching specified filterers while passing through class instances whose type is one of the mapping element types.

filter_RGB_colourspaces(filterers[, ...])

Filter the RGB colourspaces matching specified filterers.

filter_cmfs(filterers[, allow_non_siblings])

Filter the colour matching functions matching specified filterers.

filter_illuminants(filterers[, ...])

Filter the illuminants matching specified filterers.

filter_colour_checkers(filterers[, ...])

Filter the colour checkers matching specified filterers.

Colorimetry#

colour.plotting

plot_single_sd(sd[, cmfs, ...])

Plot specified spectral distribution.

plot_multi_sds(sds[, plot_kwargs])

Plot specified spectral distributions.

plot_single_cmfs([cmfs])

Plot specified colour matching functions.

plot_multi_cmfs(cmfs, **kwargs)

Plot specified colour matching functions.

plot_single_illuminant_sd(illuminant[, cmfs])

Plot specified single illuminant spectral distribution.

plot_multi_illuminant_sds(illuminants, **kwargs)

Plot specified illuminants spectral distributions.

plot_visible_spectrum([cmfs, ...])

Plot the visible colours spectrum using specified standard observer CIE XYZ colour matching functions.

plot_single_lightness_function(function, ...)

Plot specified Lightness function.

plot_multi_lightness_functions(functions, ...)

Plot specified Lightness functions.

plot_single_luminance_function(function, ...)

Plot specified Luminance function.

plot_multi_luminance_functions(functions, ...)

Plot specified Luminance functions.

plot_blackbody_spectral_radiance([...])

Plot specified 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 specified RGB colourspace array using Machado et al. (2009) model.

Colour Characterisation#

colour.plotting

plot_single_colour_checker([colour_checker])

Plot specified colour checker.

plot_multi_colour_checkers(colour_checkers, ...)

Plot and compares specified colour checkers.

Corresponding Chromaticities#

colour.plotting

plot_corresponding_chromaticities_prediction([...])

Plot specified 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 specified 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 specified spectral distribution chromaticity coordinates into the CIE 1931 Chromaticity Diagram.

plot_sds_in_chromaticity_diagram_CIE1960UCS(sds)

Plot specified spectral distribution chromaticity coordinates into the CIE 1960 UCS Chromaticity Diagram.

plot_sds_in_chromaticity_diagram_CIE1976UCS(sds)

Plot specified 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 specified method.

plot_chromaticity_diagram_colours([samples, ...])

Plot the Chromaticity Diagram colours according to specified method.

plot_chromaticity_diagram([cmfs, ...])

Plot the Chromaticity Diagram according to specified method.

plot_sds_in_chromaticity_diagram(sds[, ...])

Plot specified spectral distribution chromaticity coordinates into the Chromaticity Diagram using specified method.

Colour Models#

colour.plotting

plot_RGB_colourspaces_in_chromaticity_diagram_CIE1931(...)

Plot specified RGB colourspaces in the CIE 1931 Chromaticity Diagram.

plot_RGB_colourspaces_in_chromaticity_diagram_CIE1960UCS(...)

Plot specified RGB colourspaces in the CIE 1960 UCS Chromaticity Diagram.

plot_RGB_colourspaces_in_chromaticity_diagram_CIE1976UCS(...)

Plot specified RGB colourspaces in the CIE 1976 UCS Chromaticity Diagram.

plot_RGB_chromaticities_in_chromaticity_diagram_CIE1931(RGB)

Plot specified RGB colourspace array in the CIE 1931 Chromaticity Diagram.

plot_RGB_chromaticities_in_chromaticity_diagram_CIE1960UCS(RGB)

Plot specified RGB colourspace array in the CIE 1960 UCS Chromaticity Diagram.

plot_RGB_chromaticities_in_chromaticity_diagram_CIE1976UCS(RGB)

Plot specified 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 specified colourspace colour component transfer function.

plot_multi_cctfs(cctfs[, cctf_decoding])

Plot specified colour component transfer functions.

plot_constant_hue_loci(data[, model, ...])

Plot specified 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 specified 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 specified method.

plot_pointer_gamut([pointer_gamut_colours, ...])

Plot Pointer's Gamut according to specified method.

plot_RGB_colourspaces_in_chromaticity_diagram(...)

Plot specified RGB colourspaces in the Chromaticity Diagram according to specified method.

plot_RGB_chromaticities_in_chromaticity_diagram(RGB)

Plot specified RGB colourspace array in the Chromaticity Diagram according to specified method.

plot_ellipses_MacAdam1942_in_chromaticity_diagram([...])

Plot MacAdam (1942) Ellipses (Observer PGN) in the Chromaticity Diagram according to specified method.

Colour Notation Systems#

colour.plotting

plot_single_munsell_value_function(function, ...)

Plot specified Lightness function.

plot_multi_munsell_value_functions(...)

Plot specified 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 specified illuminant or light source spectral distribution.

plot_multi_sds_colour_rendering_indexes_bars(...)

Plot the Colour Rendering Index (CRI) of specified illuminants or light sources spectral distributions.

plot_single_sd_colour_quality_scale_bars(sd)

Plot the Colour Quality Scale (CQS) of specified illuminant or light source spectral distribution.

plot_multi_sds_colour_quality_scales_bars(sds)

Plot the Colour Quality Scale (CQS) of specified illuminants or light sources spectral distributions.

Ancillary Objects

colour.plotting.quality

plot_colour_quality_bars(specifications[, ...])

Plot the colour quality data of specified 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 specified axis and origin.

plot_RGB_colourspace_section(colourspace[, ...])

Plot specified RGB colourspace section colours along specified axis and origin.

Ancillary Objects

colour.plotting.section

plot_hull_section_colours(hull[, model, ...])

Plot the section colours of specified trimesh hull along specified axis and origin.

plot_hull_section_contour(hull[, model, ...])

Plot the section contour of specified trimesh hull along specified 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 specified 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 specified method.

plot_planckian_locus_in_chromaticity_diagram_CIE1931([...])

Plot the Planckian Locus and specified illuminants in CIE 1931 Chromaticity Diagram.

plot_planckian_locus_in_chromaticity_diagram_CIE1960UCS([...])

Plot the Planckian Locus and specified illuminants in CIE 1960 UCS Chromaticity Diagram.

plot_planckian_locus_in_chromaticity_diagram_CIE1976UCS([...])

Plot the Planckian Locus and specified illuminants in CIE 1976 UCS Chromaticity Diagram.

Ancillary Objects

colour.plotting.temperature

plot_daylight_locus([...])

Plot the Daylight Locus according to specified method.

plot_planckian_locus([...])

Plot the Planckian Locus according to specified method.

plot_planckian_locus_in_chromaticity_diagram([...])

Plot the Planckian Locus and specified illuminants in the Chromaticity Diagram according to specified method.

Colour Models Volume#

colour.plotting

plot_RGB_colourspaces_gamuts(colourspaces[, ...])

Plot specified RGB colourspaces gamuts in specified reference colourspace.

plot_RGB_scatter(RGB[, colourspace, model, ...])

Plot specified 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 specified spectral distribution according to specified 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 specified spectral distribution.

plot_single_sd_colour_rendition_report_intermediate(sd)

Generate the intermediate ANSI/IES TM-30-18 Colour Rendition Report for specified spectral distribution.

plot_single_sd_colour_rendition_report_simple(sd)

Generate the simple ANSI/IES TM-30-18 Colour Rendition Report for specified spectral distribution.

Automatic Colour Conversion Graph#

colour.plotting

plot_automatic_colour_conversion_graph(filename)

Plot Colour automatic colour conversion graph using Graphviz and pyraphviz.