| update_geom_defaults {ggplot2} | R Documentation |
Modify geom/stat aesthetic defaults for future plots
Description
Functions to update or reset the default aesthetics of geoms and stats.
Usage
update_geom_defaults(geom, new)
update_stat_defaults(stat, new)
reset_geom_defaults()
reset_stat_defaults()
Arguments
new |
One of the following:
|
stat, geom |
Name of geom/stat to modify (like |
Note
Please note that geom defaults can be set en masse via the theme(geom)
argument. The guidelines for when to use which function are as follows:
If you want to change defaults for all geoms in all plots, use
theme_update(geom = element_geom(...)).If you want to change defaults for all geoms in a single plot, use
+ theme(geom = element_geom(...)).If you want to change defaults for one geom in all plots, use
update_geom_defaults().If you want to change settings for one geom in a single plot, use fixed aesthetic parameters in a layer, like so:
geom_point(colour = "red").
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 single default
update_geom_defaults("point", NULL)
# reset all defaults
reset_geom_defaults()
# 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 single default
update_stat_defaults("bin", NULL)
# reset all defaults
reset_stat_defaults()