Quick plot


qplot(x, y = NULL, ..., data, facets = NULL, margins = FALSE, geom = "auto", stat = list(NULL),
  position = list(NULL), xlim = c(NA, NA), ylim = c(NA, NA), log = "", main = NULL,
      xlab = deparse(substitute(x)), ylab = deparse(substitute(y)), asp = NA)


x values
y values
other aesthetics passed for each layer
data frame to use (optional). If not specified, will create one, extracting vectors from the current environment.
faceting formula to use. Picks facet_wrap or facet_grid depending on whether the formula is one sided or two-sided
whether or not margins will be displayed
character vector specifying geom to use. Defaults to "point" if x and y are specified, and "histogram" is on x is specified.
character vector specifying statistics to use
character vector giving position adjustment to use
limits for x axis
limits for y axis
which variables to log transform ("x", "y", or "xy")
character vector or expression for plot title
character vector or expression for x axis label
character vector or expression for y axis label
the y/x aspect ratio


qplot is the basic plotting function in the ggplot2 package, designed to be familiar if you're used to plot from the base package. It is a convenient wrapper for creating a number of different types of plots using a consistent calling scheme. See http://had.co.nz/ggplot2/book/qplot.pdf for the chapter in the ggplot2 book which describes the usage of qplot in detail.


# Use data from data.frame qplot(mpg, wt, data=mtcars)

qplot(mpg, wt, data=mtcars, colour=cyl)

qplot(mpg, wt, data=mtcars, size=cyl)

qplot(mpg, wt, data=mtcars, facets=vs ~ am)

# It will use data from local environment hp <- mtcars$hp wt <- mtcars$wt cyl <- mtcars$cyl vs <- mtcars$vs am <- mtcars$am qplot(hp, wt)

qplot(hp, wt, colour=cyl)

qplot(hp, wt, size=cyl)

qplot(hp, wt, facets=vs ~ am)
Error in FUN(structure(c("vs", "am"), .Names = c("vs", "am"))[[1L]], ...): object 'vs' not found
qplot(1:10, rnorm(10), colour = runif(10))

qplot(1:10, letters[1:10])

mod <- lm(mpg ~ wt, data=mtcars) qplot(resid(mod), fitted(mod))

qplot(resid(mod), fitted(mod), facets = . ~ vs)
Error in FUN(structure("vs", .Names = "vs")[[1L]], ...): object 'vs' not found
f <- function() { a <- 1:10 b <- a ^ 2 qplot(a, b) } f()

# qplot will attempt to guess what geom you want depending on the input # both x and y supplied = scatterplot qplot(mpg, wt, data = mtcars)

# just x supplied = histogram qplot(mpg, data = mtcars)
stat_bin: binwidth defaulted to range/30. Use 'binwidth = x' to adjust this.

# just y supplied = scatterplot, with x = seq_along(y) qplot(y = mpg, data = mtcars)

# Use different geoms qplot(mpg, wt, data = mtcars, geom="path")

qplot(factor(cyl), wt, data = mtcars, geom=c("boxplot", "jitter"))