colour.plotting.plot_RGB_colourspaces_gamuts(colourspaces, reference_colourspace='CIE xyY', segments=8, show_grid=True, grid_segments=10, show_spectral_locus=False, spectral_locus_colour=None, cmfs='CIE 1931 2 Degree Standard Observer', chromatically_adapt=False, convert_kwargs=None, **kwargs)[source]

Plots given RGB colourspaces gamuts in given reference colourspace.

  • colourspaces (str or RGB_Colourspace or array_like) – RGB colourspaces to plot the gamuts. colourspaces elements can be of any type or form supported by the colour.plotting.filter_RGB_colourspaces() definition.

  • reference_colourspace (str, optional) – Reference colourspace model to plot the gamuts into, see colour.COLOURSPACE_MODELS attribute for the list of supported colourspace models.

  • segments (int, optional) – Edge segments count for each RGB colourspace cubes.

  • show_grid (bool, optional) – Whether to show a grid at the bottom of the RGB colourspace cubes.

  • grid_segments (bool, optional) – Edge segments count for the grid.

  • show_spectral_locus (bool, optional) – Whether to show the spectral locus.

  • spectral_locus_colour (array_like, optional) – Spectral locus colour.

  • cmfs (str or XYZ_ColourMatchingFunctions, optional) – 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.filter_cmfs() definition.

  • chromatically_adapt (bool, optional) – Whether to chromatically adapt the RGB colourspaces given in colourspaces to the whitepoint of the default plotting colourspace.

  • convert_kwargs (dict, optional) – Keyword arguments for the colour.convert() definition.

  • **kwargs (dict, optional) – {colour.plotting.artist(), colour.plotting.volume.nadir_grid()}, Please refer to the documentation of the previously listed definitions.

  • face_colours (array_like, optional) – Face colours array such as face_colours = (None, (0.5, 0.5, 1.0)).

  • edge_colours (array_like, optional) – Edge colours array such as edge_colours = (None, (0.5, 0.5, 1.0)).

  • face_alpha (numeric, optional) – Face opacity value such as face_alpha = (0.5, 1.0).

  • edge_alpha (numeric, optional) – Edge opacity value such as edge_alpha = (0.0, 1.0).


Current figure and axes.

Return type



>>> plot_RGB_colourspaces_gamuts(['ITU-R BT.709', 'ACEScg', 'S-Gamut'])
(<Figure size ... with 1 Axes>, <...Axes3DSubplot...>)