colour.plotting.plot_RGB_scatter#

colour.plotting.plot_RGB_scatter(RGB: ArrayLike, colourspace: RGB_Colourspace | str | Sequence[RGB_Colourspace | str] = 'sRGB', model: 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', colourspaces: RGB_Colourspace | str | Sequence[RGB_Colourspace | str] | None = None, segments: int = 8, show_grid: bool = True, grid_segments: int = 10, show_spectral_locus: bool = False, spectral_locus_colour: ArrayLike | str | None = None, points_size: float = 12, cmfs: MultiSpectralDistributions | str | Sequence[MultiSpectralDistributions | str] = 'CIE 1931 2 Degree Standard Observer', chromatically_adapt: bool = False, convert_kwargs: dict | None = None, **kwargs: Any) → Tuple[plt.Figure, Axes3D][source]#

Plot given RGB colourspace array in a scatter plot.

Parameters:

RGB (ArrayLike) – RGB colourspace array.
colourspace (RGB_Colourspace | str | Sequence[RGB_Colourspace | str]) – RGB colourspace of the RGB array. colourspace can be of any type or form supported by the colour.plotting.common.filter_RGB_colourspaces() definition.
model (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.
colourspaces (RGB_Colourspace | str | Sequence[RGB_Colourspace | str] | None) – RGB colourspaces to plot the gamuts. colourspaces elements can be of any type or form supported by the colour.plotting.common.filter_RGB_colourspaces() definition.
segments (int) – Edge segments count for each RGB colourspace cubes.
show_grid (bool) – Whether to show a grid at the bottom of the RGB colourspace cubes.
grid_segments (int) – Edge segments count for the grid.
show_spectral_locus (bool) – Whether to show the spectral locus.
spectral_locus_colour (ArrayLike | str | None) – Spectral locus colour.
points_size (float) – Scatter points size.
cmfs (MultiSpectralDistributions | str | Sequence[MultiSpectralDistributions | str]) – Standard observer colour matching functions used for computing the spectral locus boundaries. cmfs can be of any type or form supported by the colour.plotting.common.filter_cmfs() definition.
chromatically_adapt (bool) – Whether to chromatically adapt the RGB colourspaces given in colourspaces to the whitepoint of the default plotting colourspace.
convert_kwargs (dict | None) – Keyword arguments for the colour.convert() definition.
kwargs (Any) – {colour.plotting.artist(), colour.plotting.plot_RGB_colourspaces_gamuts()}, See the documentation of the previously listed definitions.

Returns:

Current figure and axes.

Return type:

tuple

Examples

>>> RGB = np.random.random((128, 128, 3))
>>> plot_RGB_scatter(RGB, "ITU-R BT.709")  
(<Figure size ... with 1 Axes>, <...Axes3D...>)