Pass a data frame and mapping aesthetics to ggloop() in order to create a list of 'ggplot2' plots. The way x-y and dots are paired together is controlled by the remapping arguments. Geoms, themes, facets, and other features can be added with the special %L+% (L-plus) operator.
ggloop allows the user to use both dplyr-like and ggplot2-like syntax to either create multiple ggplot2 plots or create the list of aesthetics used to make such plots. This has the potential to save the users on the amount of code within their projects or sessions.
devtools::install_github("seasmith/ggloop") to install the package.
You can try the Intro vignette (
vignette("intro", "ggloop")). You can also read the very brief overview of the functions and example below.
ggloop has three exported functions:
ggloop(data, mappings = aes_loop(), remap_xy = TRUE, remap_dots = FALSE, ..., environment = parent.frame() )= Meant to mimick
ggplot()'s arguments with additional remap arguments to control the remapping behavior of the mappings. There are three possible returned values:
...arguments of length one or less.
...argument is supplied.
...names sit on the top-level of the nested list (they divide the list into however many parts based on the number of such arguments and the remapping behavior).
ysit at the bottom-level of the nested list
aes_loop()= meant to mimick
aes(); can accept one or more arguments (a vector of arguments) with dplyr-like and ggplot2-like syntax; both syntax styles can be combined for one argument using the
c()as a wrapper and only
gear + cyl, etc
%L+%= magrittr-like (rip-off)
+operator to accomodate the addition of geoms, stats, etc to any of the returned values of
A simple example:
g <- ggplot(data = mtcars,mappings = aes_loop(x = c(mpg:hp, mpg/cyl),y = c(hp:mpg, disp/hp),color = gear),remap_xy = FALSE)g <- g %L+% geom_point() ## add a simple point geom to every ggplot objectg$gear$`x.mpg/cyl_y.disp/hp` ## view one of the plots