save_figure
Save a figure to the outputs directory
Saves a ggplot2 plot or base R graphics to the configured figures directory. The directory is created lazily on first use.
Usage
save_figure(
plot = NULL,
name,
format = "png",
width = 8,
height = 6,
dpi = 300,
public = FALSE,
overwrite = TRUE,
...
)Arguments
| Argument | Description |
|---|---|
plot
|
A ggplot2 object, or NULL to save the current plot |
name
|
The name for the output file (without extension) |
format
|
Output format: "png" (default), "pdf", "svg", or "jpg" |
width
|
Width in inches (default: 8) |
height
|
Height in inches (default: 6) |
dpi
|
Resolution in dots per inch (default: 300) |
public
|
If TRUE, saves to public outputs directory (for project_sensitive type) |
overwrite
|
If TRUE, overwrites existing files (default: TRUE) |
...
|
Additional arguments passed to ggsave or the graphics device |
Returns
The path to the saved file (invisibly)
Examples
# Save a ggplot
p <- ggplot(mtcars, aes(mpg, hp)) + geom_point()
save_figure(p, "mpg_vs_hp")
# Save as PDF for publication
save_figure(p, "mpg_vs_hp", format = "pdf", width = 10, height = 8)
# Save to public directory
save_figure(p, "summary_plot", public = TRUE)Source: R/outputs.R