lets_plot.scale_fill_hue(h=None, c=None, l=None, h_start=None, direction=None, name=None, breaks=None, labels=None, limits=None, na_value=None, guide=None, trans=None, format=None)

Qualitative color scale with evenly spaced hues for fill aesthetic.

  • h (list) – Range of hues (two numerics), in [0, 360].

  • c (int) – Chroma (intensity of color), maximum value varies depending on.

  • l (int) – Luminance (lightness), in [0, 100].

  • direction ({1, -1}, default=1) – Direction to travel around the color wheel, 1=clockwise, -1=counter-clockwise.

  • name (str) – 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.

  • breaks (list) – A numeric vector of positions (of ticks).

  • labels (list of str) – A vector of labels (on ticks).

  • limits (list) – 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.

  • na_value – Missing values will be replaced with this value.

  • guide – 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.

  • format (str) – 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.

Return type



Define qualitative color scale with evenly spaced hues for filling color aesthetic.


1from lets_plot import *
3data = {'x': list(range(-16, 16))}
4ggplot(data) + geom_tile(aes(x='x', fill='x')) + \
5    scale_fill_hue(c=50, l=80, h=[0, 50])