lets_plot.scale_hue#
- lets_plot.scale_hue(aesthetic, *, h=None, c=None, l=None, h_start=None, direction=None, name=None, breaks=None, labels=None, lablim=None, limits=None, na_value=None, guide=None, trans=None, format=None)#
Qualitative color scale with evenly spaced hues for the specified aesthetics.
- Parameters:
- aestheticstr or list
The name(s) of the aesthetic(s) that this scale works with.
- hlist
Range of hues (two numerics), in [0, 360].
- cint
Chroma (intensity of color), maximum value varies depending on.
- lint
Luminance (lightness), in [0, 100].
- direction{1, -1}, default=1
Direction to travel around the color wheel, 1=clockwise, -1=counter-clockwise.
- namestr
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.
- breakslist or dict
A list of data values specifying the positions of ticks, or a dictionary which maps the tick labels to the breaks values.
- labelslist of str or dict
A list of labels on ticks, or a dictionary which maps the breaks values to the tick labels.
- lablimint, default=None
The maximum label length (in characters) before trimming is applied.
- limitslist
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’, ‘log2’, ‘symlog’, ‘sqrt’, ‘reverse’}
Name of built-in transformation.
- formatstr
Define 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/python/pages/formats.html.
- Returns:
- FeatureSpec or FeatureSpecArray
Scales specification.
Notes
Define qualitative color scale with evenly spaced hues for the specified aesthetics.
Examples
1from lets_plot import * 2LetsPlot.setup_html() 3x = list(range(50)) 4ggplot({'x': x}, aes(x='x')) + \ 5 geom_tile(aes(color='x', fill='x'), fill='white', size=3) + \ 6 scale_hue(aesthetic=['color', 'fill'], c=20, l=90) + \ 7 coord_cartesian() + \ 8 ggsize(600, 200)