show_cmaps

show_cmaps(*args, **kwargs)[source]

Generate a table of the registered colormaps or the input colormaps categorized by source. Adapted from this example.

Parameters:

  • *args (colormap-spec, optional) – Colormap names or objects.

  • N (int, default: rc['image.lut'] = 256) – The number of levels in each colorbar.

  • unknown (str, default: 'User') – Category name for colormaps that are unknown to ultraplot. Set this to False to hide unknown colormaps.

  • include (str or sequence of str, default: None) – Category names to be shown in the table. Use this to limit the table to a subset of categories. Valid categories are 'Grayscale', 'Matplotlib sequential', 'Matplotlib cyclic', 'Seaborn sequential', 'Seaborn diverging', 'UltraPlot sequential', 'UltraPlot diverging', 'Other sequential', 'Other diverging', 'cmOcean sequential', 'cmOcean diverging', 'cmOcean cyclic', 'Scientific colour maps sequential', 'Scientific colour maps diverging', 'Scientific colour maps cyclic', 'ColorBrewer2.0 sequential', 'ColorBrewer2.0 diverging', 'SciVisColor blues', 'SciVisColor greens', 'SciVisColor yellows', 'SciVisColor oranges', 'SciVisColor browns', 'SciVisColor reds', 'SciVisColor purples', 'MATLAB', 'GNUplot', 'GIST', 'Other'.

  • ignore (str or sequence of str, default: 'MATLAB', 'GNUplot', 'GIST', 'Other') – Used only if include was not passed. Category names to be removed from the table. Use of the default ignored colormaps is discouraged because they contain non-uniform color transitions (see the user guide).

  • length (unit-spec, optional) – The length of each colorbar. If float, units are inches. If string, interpreted by units.

  • width (float or str, optional) – The width of each colorbar. If float, units are inches. If string, interpreted by units.

  • rasterized (bool, default: rc['colorbar.rasterized'] = False) – Whether to rasterize the colorbar solids. This increases rendering time and decreases file sizes for vector graphics.

Returns:

See also

show_colorspaces, show_channels, show_cycles, show_colors, show_fonts