lets_plot.scale_color_viridis(alpha=None, begin=None, end=None, direction=None, option=None, name=None, breaks=None, labels=None, limits=None, na_value=None, guide=None, trans=None, format=None)

The viridis color maps are designed to be perceptually-uniform, both in regular form and also when converted to black-and-white.

The viridis color scales are suitable for viewers with common forms of colour blindness. See also https://bids.github.io/colormap/.

alphafloat, default=1.0

Alpha transparency channel. (0 means transparent and 1 means opaque).

beginfloat, default=0.0

Corresponds to a color hue to start at. Accepts values between 0 and 1. Should be less than end.

endfloat, default=1.0

Corresponds to a color hue to end with. Accepts values between 0 and 1. Should be greater than begin.

direction{1, -1}, default=1

Sets the order of colors in the scale. If -1, the order of colors is reversed.

optionstr, default=”D” (or “viridis”)
The colormap to use:
  • “magma” (or “A”),

  • “inferno” (or “B”)

  • “plasma” (or “C”)

  • “viridis” (or “D”)

  • “cividis” (or “E”)

  • “turbo”

  • “twilight”


The name of the scale - used as the axis label or the legend title. If None, the default, the name of the scale is taken from the first mapping used for that aesthetic.


A vector specifying values to display as ticks on axis.

labelslist of strings

A vector of labels (on ticks).


Continuous scale: a numeric vector of length two providing limits of the scale. Discrete scale: a vector specifying the data range for the scale and the default order of their display in guides.


Missing values will be replaced with this value.


Guide to use for this scale. It can either be a string (‘colorbar’, ‘legend’) or a call to a guide function (guide_colorbar(), guide_legend()) specifying additional arguments. ‘none’ will hide the guide.

trans{‘identity’, ‘log10’, ‘sqrt’, ‘reverse’}

Name of built-in transformation.


Defines the format for labels on the scale. The syntax resembles Python’s: ‘.2f’ -> ‘12.45’ ‘Num {}’ -> ‘Num 12.456789’ ‘TTL: {.2f}$’ -> ‘TTL: 12.45$’ For more info see https://lets-plot.org/pages/formats.html.


Scale specification.


Can be used for both, contituous and discrete data.


1from lets_plot import *
3x = list(range(10))
4ggplot({'x': x, 'y': x}, aes('x', 'y')) + \
5    geom_point(aes(color='x'), shape=13, size=5) + \
6    scale_color_viridis(option='cividis', direction=-1)