EVOLUTION-MANAGER
Edit File: facet_wrap.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Wrap a 1d ribbon of panels into 2d</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for facet_wrap {ggplot2}"><tr><td>facet_wrap {ggplot2}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Wrap a 1d ribbon of panels into 2d</h2> <h3>Description</h3> <p><code>facet_wrap()</code> wraps a 1d sequence of panels into 2d. This is generally a better use of screen space than <code><a href="facet_grid.html">facet_grid()</a></code> because most displays are roughly rectangular. </p> <h3>Usage</h3> <pre> facet_wrap( facets, nrow = NULL, ncol = NULL, scales = "fixed", shrink = TRUE, labeller = "label_value", as.table = TRUE, switch = NULL, drop = TRUE, dir = "h", strip.position = "top" ) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>facets</code></td> <td> <p>A set of variables or expressions quoted by <code><a href="vars.html">vars()</a></code> and defining faceting groups on the rows or columns dimension. The variables can be named (the names are passed to <code>labeller</code>). </p> <p>For compatibility with the classic interface, can also be a formula or character vector. Use either a one sided formula, <code>~a + b</code>, or a character vector, <code>c("a", "b")</code>.</p> </td></tr> <tr valign="top"><td><code>nrow, ncol</code></td> <td> <p>Number of rows and columns.</p> </td></tr> <tr valign="top"><td><code>scales</code></td> <td> <p>Should scales be fixed (<code>"fixed"</code>, the default), free (<code>"free"</code>), or free in one dimension (<code>"free_x"</code>, <code>"free_y"</code>)?</p> </td></tr> <tr valign="top"><td><code>shrink</code></td> <td> <p>If <code>TRUE</code>, will shrink scales to fit output of statistics, not raw data. If <code>FALSE</code>, will be range of raw data before statistical summary.</p> </td></tr> <tr valign="top"><td><code>labeller</code></td> <td> <p>A function that takes one data frame of labels and returns a list or data frame of character vectors. Each input column corresponds to one factor. Thus there will be more than one with <code>vars(cyl, am)</code>. Each output column gets displayed as one separate line in the strip label. This function should inherit from the "labeller" S3 class for compatibility with <code><a href="labeller.html">labeller()</a></code>. You can use different labeling functions for different kind of labels, for example use <code><a href="labellers.html">label_parsed()</a></code> for formatting facet labels. <code><a href="labellers.html">label_value()</a></code> is used by default, check it for more details and pointers to other options.</p> </td></tr> <tr valign="top"><td><code>as.table</code></td> <td> <p>If <code>TRUE</code>, the default, the facets are laid out like a table with highest values at the bottom-right. If <code>FALSE</code>, the facets are laid out like a plot with the highest value at the top-right.</p> </td></tr> <tr valign="top"><td><code>switch</code></td> <td> <p>By default, the labels are displayed on the top and right of the plot. If <code>"x"</code>, the top labels will be displayed to the bottom. If <code>"y"</code>, the right-hand side labels will be displayed to the left. Can also be set to <code>"both"</code>.</p> </td></tr> <tr valign="top"><td><code>drop</code></td> <td> <p>If <code>TRUE</code>, the default, all factor levels not used in the data will automatically be dropped. If <code>FALSE</code>, all factor levels will be shown, regardless of whether or not they appear in the data.</p> </td></tr> <tr valign="top"><td><code>dir</code></td> <td> <p>Direction: either <code>"h"</code> for horizontal, the default, or <code>"v"</code>, for vertical.</p> </td></tr> <tr valign="top"><td><code>strip.position</code></td> <td> <p>By default, the labels are displayed on the top of the plot. Using <code>strip.position</code> it is possible to place the labels on either of the four sides by setting <code>strip.position = c("top", "bottom", "left", "right")</code></p> </td></tr> </table> <h3>Examples</h3> <pre> p <- ggplot(mpg, aes(displ, hwy)) + geom_point() # Use vars() to supply faceting variables: p + facet_wrap(vars(class)) # Control the number of rows and columns with nrow and ncol p + facet_wrap(vars(class), nrow = 4) # You can facet by multiple variables ggplot(mpg, aes(displ, hwy)) + geom_point() + facet_wrap(vars(cyl, drv)) # Use the `labeller` option to control how labels are printed: ggplot(mpg, aes(displ, hwy)) + geom_point() + facet_wrap(vars(cyl, drv), labeller = "label_both") # To change the order in which the panels appear, change the levels # of the underlying factor. mpg$class2 <- reorder(mpg$class, mpg$displ) ggplot(mpg, aes(displ, hwy)) + geom_point() + facet_wrap(vars(class2)) # By default, the same scales are used for all panels. You can allow # scales to vary across the panels with the `scales` argument. # Free scales make it easier to see patterns within each panel, but # harder to compare across panels. ggplot(mpg, aes(displ, hwy)) + geom_point() + facet_wrap(vars(class), scales = "free") # To repeat the same data in every panel, simply construct a data frame # that does not contain the faceting variable. ggplot(mpg, aes(displ, hwy)) + geom_point(data = transform(mpg, class = NULL), colour = "grey85") + geom_point() + facet_wrap(vars(class)) # Use `strip.position` to display the facet labels at the side of your # choice. Setting it to `bottom` makes it act as a subtitle for the axis. # This is typically used with free scales and a theme without boxes around # strip labels. ggplot(economics_long, aes(date, value)) + geom_line() + facet_wrap(vars(variable), scales = "free_y", nrow = 2, strip.position = "top") + theme(strip.background = element_blank(), strip.placement = "outside") </pre> <hr /><div style="text-align: center;">[Package <em>ggplot2</em> version 3.3.2 <a href="00Index.html">Index</a>]</div> </body></html>