ggsave

0th

Percentile

Save a ggplot with sensible defaults

ggsave is a convenient function for saving a plot. It defaults to saving the last plot that you displayed, and for a default size uses the size of the current graphics device. It also guesses the type of graphics device from the extension. This means the only argument you need to supply is the filename.

Usage
ggsave(filename = default_name(plot), plot = last_plot(),
    device = default_device(filename), path = NULL,
    scale = 1, width = par("din")[1],
    height = par("din")[2], units = c("in", "cm", "mm"),
    dpi = 300, ...)
Arguments
filename
file name/filename of plot
plot
plot to save, defaults to last plot displayed
device
device to use, automatically extract from file name extension
path
path to save plot to (if you just want to set path and not filename)
scale
scaling factor
width
width (defaults to the width of current plotting window)
height
height (defaults to the height of current plotting window)
units
units for width and height when either one is explicitly specified (in, cm, or mm)
dpi
dpi to use for raster graphics
...
other arguments passed to graphics device
Details

ggsave currently recognises the extensions eps/ps, tex (pictex), pdf, jpeg, tiff, png, bmp, svg and wmf (windows only).

Aliases
  • ggsave
Examples
ratings <- qplot(rating, data=movies, geom="histogram")
qplot(length, data=movies, geom="histogram")
ggsave(file="length-hist.pdf")
ggsave(file="length-hist.png")
ggsave(ratings, file="ratings.pdf")
ggsave(ratings, file="ratings.pdf", width=4, height=4)
# make twice as big as on screen
ggsave(ratings, file="ratings.pdf", scale=2)
Documentation reproduced from package ggplot2, version 0.9.0, License: GPL-2

Community examples

Looks like there are no examples yet.