colour.plotting.plot_multi_colour_swatches(colour_swatches, width=1, height=1, spacing=0, columns=None, direction='+y', text_kwargs=None, background_colour=1.0, 1.0, 1.0, compare_swatches=None, **kwargs)[source]

Plots given colours swatches.

  • colour_swatches (array_like) – Colour swatch sequence, either a regular array_like or a sequence of colour.plotting.ColourSwatch class instances.

  • width (numeric, optional) – Colour swatch width.

  • height (numeric, optional) – Colour swatch height.

  • spacing (numeric, optional) – Colour swatches spacing.

  • columns (int, optional) – Colour swatches columns count, defaults to the colour swatch count or half of it if comparing.

  • direction (unicode, optional) – {‘+y’, ‘-y’} Row stacking direction.

  • text_kwargs (dict, optional) – Parameters for the plt.text() definition, visible can be set to make the text visible, offset can be set to define the text offset.

  • background_colour (array_like or unicode, optional) – Background colour.

  • compare_swatches (unicode, optional) – {None, ‘Diagonal’, ‘Stacked’}, Whether to compare the swatches, in which case the colour swatch count must be an even number with alternating reference colour swatches and test colour swatches. Stacked will draw the test colour swatch in the center of the reference colour swatch, Diagonal will draw the reference colour swatch in the upper left diagonal area and the test colour swatch in the bottom right diagonal area.

Other Parameters

**kwargs (dict, optional) – {colour.plotting.artist(), colour.plotting.render()}, Please refer to the documentation of the previously listed definitions. Also handles keywords arguments for deprecation management.


Current figure and axes.

Return type



>>> RGB_1 = ColourSwatch(RGB=(0.45293517, 0.31732158, 0.26414773))
>>> RGB_2 = ColourSwatch(RGB=(0.77875824, 0.57726450, 0.50453169))
>>> plot_multi_colour_swatches([RGB_1, RGB_2])  
(<Figure size ... with 1 Axes>, <matplotlib.axes._subplots.AxesSubplot object at 0x...>)