biostats (version 1.1.1)

plot_line: Create Simple Professional Line Plots

Description

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

Usage

plot_line(
  data,
  x,
  y,
  group = NULL,
  facet = NULL,
  stat = NULL,
  error = "se",
  error_width = 0.2,
  colors = NULL,
  title = NULL,
  xlab = NULL,
  ylab = NULL,
  legend_title = NULL,
  points = TRUE,
  line_size = 1,
  point_size = 3,
  y_limits = NULL,
  x_limits = NULL
)

Value

A ggplot2 object

Arguments

data

A data frame 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 the grouping variable for multiple lines. Default: NULL.

facet

Character string specifying the faceting variable. Default: NULL.

stat

Character string for statistical aggregation: "mean" or "median".

error

Character string for error bars: "se", "sd", "ci", or "none". Default: "se".

error_width

Numeric value indicating the width of error bar caps. Default: 0.2.

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 whether to add points to lines. Default: TRUE.

line_size

Numeric value indicating thickness of lines. Default: 1.

point_size

Numeric value indicating size of points if shown. Default: 3.

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.

Examples

# Simulated clinical data
clinical_df <- clinical_data(arms = c("A","B","C"), visits = 10)

# Line plot with mean and standard error by treatment
plot_line(clinical_df, x = "visit", y = "biomarker",
          group = "treatment", stat = "mean", error = "se")

# Faceted line plots with median and 95% CI
plot_line(clinical_df, x = "visit", y = "biomarker", group = "treatment", 
          facet = "sex", stat = "median", error = "ci", points = FALSE)