facet_wrap {ggplot2}R Documentation

facet_wrap

Description

Wrap a 1d ribbon of panels into 2d.

Usage

facet_wrap(facets, nrow=NULL, ncol=NULL, scales="fixed", as.table=TRUE, ...)

Arguments

facets NULL
nrow number of rows
ncol number of colums
scales should scales be fixed, free, or free in one dimension (free_x, free_y)
as.table NULL
... other arguments

Details

This page describes facet_wrap, see layer and qplot for how to create a complete plot from individual components.

Value

A layer

Author(s)

Hadley Wickham, http://had.co.nz/

See Also

Examples

## Not run: 
d <- ggplot(diamonds, aes(carat, price, fill = ..density..)) + 
  xlim(0, 2) + stat_binhex(na.rm = TRUE) + opts(aspect.ratio = 1)
d + facet_wrap(~ color)
d + facet_wrap(~ color, ncol = 4)
d + facet_wrap(~ color, nrow = 3)

# Using multiple variables continues to wrap the long ribbon of 
# plots into 2d - the ribbon just gets longer
# d + facet_wrap(~ color + cut)

# You can choose to keep the scales constant across all panels
# or vary the x scale, the y scale or both:
p <- qplot(price, data = diamonds, geom = "histogram", binwidth = 1000)
p + facet_wrap(~ color)
p + facet_wrap(~ color, scales = "free_y")

p <- qplot(displ, hwy, data = mpg)
p + facet_wrap(~ cyl)
p + facet_wrap(~ cyl, scales = "free") 

# Add data that does not contain all levels of the faceting variables
cyl6 <- subset(mpg, cyl == 6)
p + geom_point(data = cyl6, colour = "red", size = 1) + 
  facet_wrap(~ cyl)
p + geom_point(data = transform(cyl6, cyl = 7), colour = "red") + 
  facet_wrap(~ cyl)

## End(Not run)

[Package ggplot2 version 0.8.2 Index]