as_discrete ¶

as_discrete(
    variable: str | Sequence[Any],
    label: str | None = None,
    order_by: str | None = None,
    order: int | None = None,
    levels: Sequence[Any] | None = None,
) -> MappingMeta | Sequence[Any]

Use a discrete scale for a mapped column, optionally ordering its values.

Parameters:

variable (str) –

Column name.
label (str, default: None ) –

Scale name (axis or legend title).
order_by (str, default: None ) –

Column to order the categories by.
order (int, default: None ) –

1 for ascending, -1 for descending.
levels (list, default: None ) –

Explicit category order.

Returns:

MappingMeta –

Variable annotation, to be used inside aes(). Non-string variable values (e.g. a list of values) are returned unchanged, as in lets_plot.