xpose.xtras (version 0.2.2)

ggsave_xp: Save a plot with xpose.xtras default output resolution

Description

A ggplot2::ggsave()-compatible wrapper (defaulting to ggplot2::ggsave() itself, but swappable via save_fun -- e.g. for reportifyr::ggsave_with_metadata() or any other function sharing ggsave()'s plot/filename/path/width/height signature). Before saving: resolved labels are applied via apply_default_labs() and a configured watermark (if any) via add_watermark() -- see apply_labs/apply_watermark, both of which default to the xpose.xtras.auto_apply option (TRUE unless changed), the same switch print.xpose_plot() uses, so a plot looks the same whether it's viewed interactively or saved with ggsave_xp(). filename/path have any @keyword placeholders expanded via xpose::parse_title(), the same way xpose::xpose_save() does (independent of which save_fun is used, since most save functions don't do this themselves); and path/width/height/save_fun fall back to the xpose.xtras.save_dir, xpose.xtras.save_width, xpose.xtras.save_height, and xpose.xtras.save_fun R options when not supplied explicitly, so a project can set output defaults once (see set_xtras_options()).

Usage

ggsave_xp(
  plot = ggplot2::last_plot(),
  filename,
  path = getOption("xpose.xtras.save_dir"),
  width = getOption("xpose.xtras.save_width", 7),
  height = getOption("xpose.xtras.save_height", 6),
  xpdb = NULL,
  apply_labs = getOption("xpose.xtras.auto_apply", TRUE),
  apply_watermark = getOption("xpose.xtras.auto_apply", TRUE),
  save_fun = getOption("xpose.xtras.save_fun", ggplot2::ggsave),
  ...
)

Value

the result of save_fun (for the default ggplot2::ggsave(), the saved file path, invisibly)

Arguments

plot

<ggplot> or <xpose_plot> object

filename

<character> File name, optionally with @keyword placeholders (e.g. "@[e-mail]", see xpose::parse_title()). @plotfun (the name of the function that built plot, e.g. "dv_vs_ipred") only resolves when plot is an xpose_plot, since it isn't something a bare xpdb knows about

path

<character> Directory to save in; falls back to the xpose.xtras.save_dir R option

width, height

<numeric> Plot size (in inches by default, see save_fun's own units argument if it has one); fall back to the xpose.xtras.save_width/xpose.xtras.save_height R options

xpdb

<xpose_data> or <xp_xtras> object plot was built from, forwarded to apply_default_labs()/ add_watermark() (see their xpdb argument) and used to resolve @keyword placeholders

apply_labs

<logical> Apply apply_default_labs() to plot before saving; defaults to the xpose.xtras.auto_apply option (TRUE unless changed)

apply_watermark

<logical> Apply add_watermark() to plot before saving, if a default_watermark is configured at some tier (see add_watermark()) -- otherwise a no-op regardless; defaults to the xpose.xtras.auto_apply option (TRUE unless changed)

save_fun

<function> The actual save function to call, e.g. ggplot2::ggsave() (the default) or a drop-in alternative such as reportifyr::ggsave_with_metadata(); falls back to the xpose.xtras.save_fun R option, then ggplot2::ggsave()

...

Passed on to save_fun (e.g. device, dpi, units, bg)

See Also

set_xtras_options() for the full list of xpose.xtras.* session options.

Examples

if (FALSE) {
options(xpose.xtras.save_dir = "figures", xpose.xtras.save_width = 8)
p <- xpose::dv_vs_ipred(xpose::xpdb_ex_pk)
ggsave_xp(p, filename = "dv_vs_ipred.png")
}