Skip to content

scale_size_ordinal

scale_size_ordinal(
    range: Sequence[Number] = (2, 6),
    name: str | None = None,
    breaks: Breaks | None = None,
    labels: Labels | None = None,
    lablim: int | None = None,
    limits: Limits | None = None,
    na_value: Number | None = None,
    guide: Guide | None = None,
    format: str | None = None,
) -> FeatureSpec

Map ordered categories of size to evenly spaced sizes.

Parameters:

  • range (list of float, default: (2, 6) ) –

    [smallest, largest] size (ggplot2 and plotnine default). The sizes step evenly in diameter, as every ggrust size scale (ggplot2 steps evenly in area).

  • name (str, default: None ) –

    Legend title.

  • breaks (list, default: None ) –

    Levels that get a legend key.

  • labels (list of str or dict, default: None ) –

    One label per break.

  • lablim (int, default: None ) –

    Maximum label length in characters; longer labels are cut.

  • limits (list, default: None ) –

    The levels and their order.

  • na_value (float, default: None ) –

    Size of missing data.

  • guide (str or FeatureSpec, default: None ) –

    "legend", "none", or a guide spec.

  • format (str, default: None ) –

    Label format.

Returns:

  • FeatureSpec –

    The scale.

Examples:

>>> from ggrust import *
>>> data = {"x": [1, 2, 3], "y": [1, 2, 3], "shirt": ["S", "M", "L"]}
>>> plot = ggplot(data, aes("x", "y", size="shirt")) + geom_point()
>>> plot = plot + scale_size_ordinal(limits=["S", "M", "L"])