biostats (version 1.1.1)

plot_hist: Create Simple Professional Histogram Plots

Description

Generates publication-ready histogram plots with minimal code using ggplot2.

Usage

plot_hist(
  data,
  x,
  group = NULL,
  facet = NULL,
  bins = 30,
  binwidth = NULL,
  alpha = 0.7,
  colors = NULL,
  title = NULL,
  xlab = NULL,
  ylab = NULL,
  legend_title = NULL,
  y_limits = NULL,
  x_limits = NULL,
  stat = NULL
)

Value

A ggplot2 object

Arguments

data

A dataframe containing the variables to plot.

x

Character string specifying the variable for the histogram.

group

Character string specifying the grouping variable for multiple histograms. Default: NULL.

facet

Character string specifying the faceting variable. Default: NULL.

bins

Numeric value indicating the number of bins for the histogram. Default: 30.

binwidth

Numeric value indicating the width of the bins (overrides bins if specified). Default: NULL.

alpha

Numeric value indicating the transparency level for the bars. Default: 0.7.

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.

y_limits

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

x_limits

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

stat

Character string that adds line for "mean" or "median". Default: NULL.

Examples

# Simulated clinical data
clinical_df <- clinical_data()

# Basic histogram
plot_hist(clinical_df, x = "biomarker")

# Grouped histogram
plot_hist(clinical_df, x = "biomarker", group = "treatment")

# Faceted histogram
plot_hist(clinical_df, x = "biomarker", facet = "treatment")