In seasmith/ggloop: Create 'ggplot2' Plots in a Loop

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "README-"
)

ggloop

Create ggplot2 plots in a loop.

Overview

ggloop allows the user to use create multiple 'ggplot2' plots. Plots are created by passing multiple aesthetics via a vector of aesthetics to ggloop(). Users can use both dplyr-like syntax (i.e. x = mpg:hp, y = 1, color = 4:8, etc) and ggplot2-like syntax (i.e x = mpg/cyl, y = wt + hp, color = factor(cyl), etc).

Installation

## CRAN
install.packages("ggloop")

## GitHub
devtools::install_github("seasmith/ggloop")

Where can I learn how to use ggloop?

You can see ggloop in action with the intro vignette (vignette("intro", "ggloop")). You can also see the example and the very brief overview available below.

A simple example

library(ggloop)
library(ggplot2)
g <- ggloop(data = mtcars, 
            mappings = aes_loop(x = c(mpg:hp, mpg/cyl), 
                                y = c(hp:mpg, disp/hp),
                                color = gear), 
            remap_xy = FALSE)
g <- g + geom_point()
g$color.gear$x.mpg_y.hp

The functions

ggloop has three exported functions:

ggloop(data, mappings = aes_loop(), remap_xy = TRUE, remap_dots = FALSE, ..., environment = parent.frame() )
- Mimicks ggplot2::ggplot() and its arguments.
- Returned values:
  - A single ggplot object = Created by x, y, and ... arguments of length one or less.
  - A list of ggplot objects = Created when there is no ... argument in aes_loop().
  - A nest list (a list of a list) of ggplot objects = Created when a ... 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). x and y sit at the bottom-level of the nested list
aes_loop()
- Mimicks aes()
- Accepts vectors of values for each argument.
- Arguments with more than one value must be wrapped by c() and NOT have any nested c().
- Syntax:
  - dplyr-like = mpg:hp, 1, 5:9, cyl, etc.
  - ggplot2-like = factor(cyl), gear + cyl, etc.
  - Both syntax styles can be combined for one argument using the c() as a wrapper and only c().
%L+%
- Is a + operator for a nested list, list, or single 'ggplot' object.