scale_identity ¶
scale_identity(
aesthetic: str | Sequence[str],
*,
name: str | None = None,
breaks: Breaks | None = None,
labels: Labels | None = None,
lablim: int | None = None,
limits: Limits | None = None,
na_value: Color | Number | None = None,
guide: Guide = "none",
format: str | None = None,
) -> FeatureSpec
Use the data as the aesthetic values (colors, sizes, shapes, ...); no legend by default.
Parameters:
-
aesthetic(str or list of str) –The aesthetic(s), e.g.
"fill"or["color", "fill"]. -
name(str, default:None) –Title of the scale, shown on the legend.
-
breaks(list or dict, default:None) –Values that get a legend key (a dict maps labels to breaks).
-
labels(list of str or dict, default:None) –One label per break (a dict maps breaks to labels).
-
lablim(int, default:None) –Maximum label length in characters; longer labels are cut.
-
limits(list, default:None) –The values (and their order) the scale keeps.
-
na_value(str or float, default:None) –Value drawn for missing data.
-
guide(str or FeatureSpec, default:"none") –"legend"to show a legend (givebreaksandlabelstoo). -
format(str, default:None) –Label format, e.g.
".1f".labelstake precedence.
Returns:
-
FeatureSpec–The scale, or a
FeatureSpecArrayof one scale per aesthetic for a list.
Raises:
-
UnsupportedValueError–If
aestheticis not a string or a list of strings. -
SpecError–If
aestheticis an empty list.
Examples:
>>> from ggrust import *
>>> data = {"x": [1, 2, 3], "y": [3, 1, 2], "paint": ["tomato", "gold", "teal"]}
>>> plot = ggplot(data, aes("x", "y", color="paint", fill="paint"))
>>> plot = plot + geom_point(shape=21, size=10, alpha=0.5)
>>> plot = plot + scale_identity(["color", "fill"])