multi_plot: Flexible Static or Interactive Plotting of Variables

Generate a variety of plots—histogram, density, boxplot, barplot, violin, scatter, heatmap, or spider (radar)—either as static ggplot2 objects or interactive Plotly widgets.

Usage

multi_plot(
  data,
  x_var = NULL,
  y_var = NULL,
  plot_type = NULL,
  interactive = FALSE,
  fill_color = "steelblue",
  color = "black",
  bin_width = NULL,
  group = NULL,
  facet_var = NULL,
  z_var = NULL,
  radar_color = "steelblue",
  radar_vlabels = NULL,
  radar_vlcex = 1,
  radar_ref_lev = "Yes",
  title = NULL,
  x_lab = NULL,
  y_lab = NULL,
  legend_position = "right",
  axis_text_angle = 0,
  axis_text_size = 12,
  title_size = 14,
  theme_custom = ggplot2::theme_minimal()
)

Arguments

data: A data frame or tibble containing your data.
x_var: Character; name of the variable for x‑axis (required for all plot types except spider).
y_var: Character; name of the variable for y‑axis (required for boxplot, violin, scatter, and heatmap).
plot_type: Character; one of "histogram", "density", "boxplot", "barplot", "violin", "scatter", "heatmap", or "spider".
interactive: Logical; if TRUE, returns a Plotly interactive plot (not available for spider/radar charts). Default: FALSE.
fill_color: Character; fill color for non‑grouped geoms (default "steelblue").
color: Character; outline/line color (default "black").
bin_width: Numeric; bin width for histograms. If NULL, computed automatically.
group: Character; name of grouping variable (optional).
facet_var: Character; name of variable to facet by (optional).
z_var: Character vector; names of numeric variables for spider plot (only for "spider").
radar_color: Character or vector; border/fill color for spider chart (only for "spider").
radar_vlabels: Character or vector; names of the variables for spider chart (only for "spider").
radar_vlcex: Numeric; font size for variable labels in the spider chart (only for "spider").
radar_ref_lev: Character; reference level for factors included in the spider chart (only for "spider").
title: Character; plot title (optional).
x_lab: Character; x‑axis label (defaults to x_var).
y_lab: Character; y‑axis label (defaults to y_var or "Count").
legend_position: Character; one of "right","left","top","bottom","none" (default "right").
axis_text_angle: Numeric; rotation angle (degrees) for x‑axis tick labels (default 0).
axis_text_size: Numeric; size of axis text in pts (default 12).
title_size: Numeric; size of plot title text in pts (default 14).
theme_custom: A ggplot2 theme object (default theme_minimal()).

Value

A ggplot object (if interactive = FALSE or plot_type = "spider") or a plotly object (if interactive = TRUE).

Details

Histogram: requires x_var; uses geom_histogram(). Use for continuous numeric variables only.
Density: requires x_var; uses geom_density(). It should be numeric.
Boxplot/Violin: require both x_var and y_var; automatically groups by x_var or by group if provided, with dynamic dodge width.
Barplot: requires x_var; counts occurrences. Use for categorical variables only.
Scatter: requires both x_var and y_var; uses geom_point(). Both variables must be numeric.
Heatmap: requires both x_var and y_var. Both variables must be categorical.
Spider: requires z_var (vector of variables); uses fmsb::radarchart(), static only.

Examples


multi_plot(icu,
  x_var = "icu_enter_days",
  y_var = "vent_mec_start_days",
  plot_type = "scatter",
  color = "darkred",
  title = "ICU exit vs MV days"
)
#> Warning: Removed 5330 rows containing missing values or values outside the scale range
#> (`geom_point()`).


multi_plot(
  comorbidities,
  x_var = "hypertension",
  y_var = "dyslipidemia",
  plot_type = "spider",
  z_var = c(
    "depression", "mild_kidney_disease", "ceiling_dico"
  ),
  radar_vlabels = stringr::str_to_sentence(
    c("hypertension", "dyslipidemia", "depression", "mild_kidney_disease", "ceiling_dico")
  ),
  radar_color = "steelblue",
  radar_ref_lev = "Yes"
)