update_defaults: Modify geom/stat aesthetic defaults for future plots

In tidyverse/ggplot2: Create Elegant Data Visualisations Using the Grammar of Graphics

Modify geom/stat aesthetic defaults for future plots

Description

Modify geom/stat aesthetic defaults for future plots

Usage

update_geom_defaults(geom, new)

update_stat_defaults(stat, new)

Arguments

new	One of the following: A named list of aesthetics to serve as new defaults. NULL to reset the defaults.
stat, geom	Name of geom/stat to modify (like "point" or "bin"), or a Geom/Stat object (like GeomPoint or StatBin).

Examples

# updating a geom's default aesthetic settings
# example: change geom_point()'s default color
GeomPoint$default_aes
update_geom_defaults("point", aes(color = "red"))
GeomPoint$default_aes
ggplot(mtcars, aes(mpg, wt)) + geom_point()

# reset default
update_geom_defaults("point", NULL)


# updating a stat's default aesthetic settings
# example: change stat_bin()'s default y-axis to the density scale
StatBin$default_aes
update_stat_defaults("bin", aes(y = after_stat(density)))
StatBin$default_aes
ggplot(data.frame(x = rnorm(1e3)), aes(x)) +
  geom_histogram() +
  geom_function(fun = dnorm, color = "red")

# reset default
update_stat_defaults("bin", NULL)

tidyverse/ggplot2 documentation built on April 5, 2024, 8:37 a.m.