plot_forest: Create forest plots
In metrumresearchgroup/pmforest: Create forest plots

View source: R/plot-forest.R

plot_forest

R Documentation

Create forest plots

Description

Creates a forest plot with or without confidence intervals. See the "Getting Started" vignette for usage and examples.

Usage

plot_forest(
  data,
  summary_label = NULL,
  vline_intercept = 0,
  annotate_CI = TRUE,
  shaded_interval = NULL,
  digits = 3,
  maxex = NULL,
  x_lab = "Effect",
  y_lab = NULL,
  CI_label = NULL,
  CI_bracket_open = c("[", "("),
  CI_bracket_close = c("]", ")"),
  caption = NULL,
  text_size = 3.5,
  plot_width = 8,
  x_breaks = NULL,
  x_limit = NULL,
  jitter_reps = FALSE,
  shapes = c("diamond", "square", "circle", "triangle"),
  shape_size = 3.5,
  ggplot_theme = ggplot2::theme_bw(),
  ...
)

Arguments

`data`	a dataframe or tibble that contains the summarized data you want to plot. This must be in the same format as the tibble that is output by `summarize_data()`. See "Output Data" in Details section of `summarize_data()` documentation.
`summary_label`	(optional) labeler function created using `ggplot2::as_labeller`. Labels for group and metagroup.
`vline_intercept`	(optional) numeric. Default 0.
`annotate_CI`	logical. Default `TRUE`. Show a table next to the graph with the numeric values for the confidence interval.
`shaded_interval`	numeric vector. Specified as c(lo, hi) for the interval you want to shade over. Default is NULL.
`digits`	numeric. Number of significant digits to round the table values to. Passed through to `pmtables::sig()`
`maxex`	numeric. Maximum number of significant digits before moving to scientific notation. Passed through to `pmtables::sig()`.
`x_lab`	string. x-axis label.
`y_lab`	string. Default is not to label y axis.
`CI_label`	string. Label above the CI table. Ignored if `annotate_CI` is `FALSE`.
`CI_bracket_open`	string. Denotes whether to use brackets (`[`) or parentheses (`(`) for the opening interval. Ignored if `annotate_CI` is `FALSE`.
`CI_bracket_close`	string. Denotes whether to use brackets (`⁠]⁠`) or parentheses (`⁠)⁠`) for the closing interval. Ignored if `annotate_CI` is `FALSE`.
`caption`	string. A patchwork styled caption for the overall plot.
`text_size`	numeric. Text size for labels. Must be at least 3.5
`plot_width`	numeric. Value between 1 and 12 to denote the ratio of plot : CI table
`x_breaks`	numeric vector of breaks to be used for the x-axis. See scale_x_continuous() for details.
`x_limit`	numeric vector (c(lo, hi)) specifying the minimum and maximum values to show on the x-axis. See coord_cartesian() for details
`jitter_reps`	logical. Whether or not to vertically "jitter" the additional confidence intervals when using multiple replicates (i.e. when input data has 9 numeric columns instead of 3).
`shapes`	string. Denotes the shape of the mean/median value, passed to `ggplot2::geom_point()`. Can be one of the following: "square", "diamond", "circle", or "triangle".
`shape_size`	numeric. Value between 1 and 4 that denotes the relative size of the `shape` argument. Defaults to 3.5.
`ggplot_theme`	a ggplot theme. Note that some legend options, text size, and grid elements may be overwritten. See `ggplot2::theme()` for details.
`...`	additional args passed to `patchwork::wrap_plots()` for metagrouped plots.