colour.plotting.plot_visible_spectrum_section

colour.plotting.plot_visible_spectrum_section(cmfs: Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str]]] = 'CIE 1931 2 Degree Standard Observer', illuminant: Union[colour.colorimetry.spectrum.SpectralDistribution, str] = 'D65', model: Union[Literal['CAM02LCD', 'CAM02SCD', 'CAM02UCS', 'CAM16LCD', 'CAM16SCD', 'CAM16UCS', 'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW', 'DIN99', 'Hunter Lab', 'Hunter Rdab', 'ICaCb', 'ICtCp', 'IPT', 'IgPgTg', 'Jzazbz', 'OSA UCS', 'Oklab', 'hdr-CIELAB', 'hdr-IPT'], str] = 'CIE xyY', axis: Union[Literal['+z', '+x', '+y'], str] = '+z', origin: float = 0.5, normalise: bool = True, show_section_colours: bool = True, show_section_contour: bool = True, **kwargs: Any) → Tuple[matplotlib.figure.Figure, matplotlib.axes._axes.Axes]

Plot the visible spectrum volume, i.e. Rösch-MacAdam colour solid, section colours along given axis and origin.

Parameters

• cmfs (Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str, Sequence[Union[colour.colorimetry.spectrum.MultiSpectralDistributions, str]]]) – Standard observer colour matching functions, default to the CIE 1931 2 Degree Standard Observer. cmfs can be of any type or form supported by the colour.plotting.filter_cmfs() definition.

• illuminant (Union[colour.colorimetry.spectrum.SpectralDistribution, str]) – Illuminant spectral distribution, default to CIE Illuminant D65. illuminant can be of any type or form supported by the colour.plotting.filter_illuminants() definition.

• model (Union[Literal['CAM02LCD', 'CAM02SCD', 'CAM02UCS', 'CAM16LCD', 'CAM16SCD', 'CAM16UCS', 'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW', 'DIN99', 'Hunter Lab', 'Hunter Rdab', 'ICaCb', 'ICtCp', 'IPT', 'IgPgTg', 'Jzazbz', 'OSA UCS', 'Oklab', 'hdr-CIELAB', 'hdr-IPT'], str]) – Colourspace model, see colour.COLOURSPACE_MODELS attribute for the list of supported colourspace models.

• axis (Union[Literal['+z', '+x', '+y'], str]) – Axis the hull section will be normal to.

• origin (float) – Coordinate along axis at which to plot the hull section.

• normalise (bool) – Whether to normalise axis to the extent of the hull along it.

• show_section_colours (bool) – Whether to show the hull section colours.

• show_section_contour (bool) – Whether to show the hull section contour.

• kwargs (Any) – {colour.plotting.artist(), colour.plotting.render(), colour.plotting.section.plot_hull_section_colours() colour.plotting.section.plot_hull_section_contour()}, See the documentation of the previously listed definitions.

Returns

Current figure and axes.

Return type

tuple

Examples

>>> from colour.utilities import is_trimesh_installed
>>> if is_trimesh_installed:
...     plot_visible_spectrum_section(
...         section_colours='RGB', section_opacity=0.15)
...     
(<Figure size ... with 1 Axes>, <...AxesSubplot...>)

previous

colour.plotting.quality.plot_colour_quality_bars

next

colour.plotting.plot_RGB_colourspace_section