Scales

Manual Position Scales

scale_x_manual

plotnine_extra.scale_x_manual(values, breaks=None, labels=None, name=None, **kwargs)

Discrete x-axis scale with explicit values ordering.

Parameters:

• values (sequence) – Ordered list of category values that should appear on the axis. Acts as both limits and the axis order.

• breaks (sequence, optional) – Subset of values to label.

• labels (sequence, optional) – Display labels matching breaks.

• name (str, optional) – Axis title.

scale_y_manual

plotnine_extra.scale_y_manual(values, breaks=None, labels=None, name=None, **kwargs)

Discrete y-axis scale with explicit values ordering. See scale_x_manual() for parameter descriptions.

Parameters:

• values (Sequence)

• breaks (Sequence | None)

• labels (Sequence | None)

• name (str | None)

Multiple Aesthetic Scales

scale_colour_multi

plotnine_extra.scale_colour_multi(palettes, discrete=True)

Build several colour scales for different aesthetics.

Parameters:

• palettes (mapping) – Maps aesthetic names (e.g. "colour", "colour_alt") to palette names or sequences of colours.

• discrete (bool, default True) – If True use discrete (manual) scales; otherwise continuous gradient scales.

Returns:

A list of plotnine scale objects ready to be added to a ggplot via the + operator. Adding the list adds each scale in turn.

Return type:

list

scale_color_multi

plotnine_extra.scale_color_multi(palettes, discrete=True)

Build several colour scales for different aesthetics.

Parameters:

• palettes (mapping) – Maps aesthetic names (e.g. "colour", "colour_alt") to palette names or sequences of colours.

• discrete (bool, default True) – If True use discrete (manual) scales; otherwise continuous gradient scales.

Returns:

A list of plotnine scale objects ready to be added to a ggplot via the + operator. Adding the list adds each scale in turn.

Return type:

list

scale_fill_multi

plotnine_extra.scale_fill_multi(palettes, discrete=True)

Build several fill scales for different aesthetics. See scale_colour_multi() for parameter docs.

Parameters:

• palettes (Mapping[str, str | Sequence[str]])

• discrete (bool)

scale_listed

plotnine_extra.scale_listed(scales, replaces=None)

Combine several already-constructed scales into one list.

Parameters:

• scales (sequence) – Already-constructed plotnine scale objects.

• replaces (sequence of str, optional) – Aesthetic names that the listed scales should replace. Currently informational; the function returns the list as-is so it can be added to a ggplot in one go.