scale_x_discrete#

scale_x_discrete(name=None, *, breaks=None, labels=None, lablim=None, limits=None, expand=None, na_value=None, reverse=None, format=None, position=None)#

Discrete position scale x.

Parameters:
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

A vector specifying the data range for the scale and the default order of their display in guides.

expandlist

A numeric vector of length two giving multiplicative and additive expansion constants. The vector size == 1 => only multiplicative expand (and additive expand by default). Defaults: multiplicative = 0, additive = 0.2.

na_value

Missing values will be replaced with this value.

reversebool

When True the scale is reversed.

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 Formatting.

positionstr

The position of the axis:

  • ‘left’, ‘right’ or ‘both’ for y-axis;

  • ‘top’, ‘bottom’ or ‘both’ for x-axis.

Returns:
FeatureSpec

Scale specification.

Examples

1import numpy as np
2from lets_plot import *
3LetsPlot.setup_html()
4np.random.seed(43)
5scores = {'rating': np.random.randint(3, 6, size=10)}
6ggplot(scores, aes(x='rating')) + geom_bar() + \
7    scale_x_discrete(name='rating', format='.1f')
On this page