biostats (version 1.1.1)

plot_box: Create Simple Professional Box Plots

Description

Generates publication-ready boxplots with optional jittered points and mean overlay.

Usage

plot_box(
  data,
  x,
  y,
  group = NULL,
  facet = NULL,
  colors = NULL,
  title = NULL,
  xlab = NULL,
  ylab = NULL,
  legend_title = NULL,
  points = FALSE,
  point_size = 2,
  y_limits = NULL,
  show_mean = TRUE
)

Value

A ggplot2 object

Arguments

data

A dataframe containing the variables to plot.

x

Character string specifying the x-axis variable.

y

Character string specifying the y-axis variable.

group

Character string specifying grouping variable for fill/color. Default: NULL.

facet

Character string specifying faceting variable. Default: NULL.

colors

Character vector of colors. If NULL, uses TealGrn palette. Default: NULL.

title

Character string for plot title. Default: NULL.

xlab

Character string for x-axis label. Default: NULL.

ylab

Character string for y-axis label. Default: NULL.

legend_title

Character string for legend title. Default: NULL.

points

Logical parameter indicating if jittered points. Default: FALSE.

point_size

Numeric value indicating the size of points. Default: 2.

y_limits

Numeric vector of length 2 for y-axis limits. Default: NULL.

show_mean

Logical parameter indicating if mean should be shown. Default: TRUE.

Examples

#Simulated clinical data
clinical_df <- clinical_data(visits = 10)

# Boxplot of biomarker by treatment
plot_box(clinical_df, x = "treatment", y = "biomarker", group = "treatment")

# Barplot of bimarker by study visit and treatment
plot_box(clinical_df, x = "visit", y = "biomarker", group = "treatment")