Skip to contents

This function generates grouped standardized beeswarm plots to visualize the results of interference correction across different QC types.

Usage

plot_qc_interferences(
  data,
  qc_types = c("SPL", "TQC", "PBLK", "BQC"),
  include_qualifier = FALSE,
  include_istd = TRUE,
  include_feature_filter = NA,
  exclude_feature_filter = NA,
  min_median_value = NA,
  y_lim = c(-NA, NA),
  point_size = 0.5,
  dodge_width = 0.6,
  point_alpha = 0.3,
  box_alpha = 0.3,
  box_linewidth = 0.5,
  font_base_size = 8,
  angle_x = 45
)

Arguments

data

A MRMhubExperiment object.

qc_types

A character vector specifying the QC types to plot. It must contain at least one element. The default NA plots any of the non-blank QC types ("SPL", "TQC", "BQC", "HQC", "MQC", "LQC", "NIST", "LTR") present in the dataset.

include_qualifier

A logical value indicating whether to include qualifier features. Default is TRUE.

include_istd

A logical value indicating whether to include internal standards (ISTD) features. Default is TRUE.

include_feature_filter

A regex pattern or a vector of feature names used to filter features by feature_id. If NA or an empty string ("") is provided, the filter is ignored. When a vector of length > 1 is supplied, only features with exactly these names are selected (applied individually as OR conditions).

exclude_feature_filter

A regex pattern or a vector of feature names used to exclude features by feature_id. If NA or an empty string ("") is provided, the filter is ignored. When a vector of length > 1 is supplied, only features with exactly these names are excluded (applied individually as OR conditions).

min_median_value

Minimum median feature value across the selected QC-type samples required for a feature to be included. NA (default) applies no filtering. This is a fast way to exclude noisy features; for principled QC-based filtering use filter_features_qc().

y_lim

A numeric vector of length 2 specifying the y-axis limits.

point_size

A numeric value indicating the size of points in millimeters. Default is 0.5.

dodge_width

Numeric. Width used to dodge overlapping points by qc_type. Default is 0.6.

point_alpha

Numeric. Transparency of the plotted points. Default is 0.3.

box_alpha

Numeric. Transparency of the boxplot. Default is 0.3.

box_linewidth

Numeric. Width of the boxplot lines. Default is 0.5.

font_base_size

Numeric. Base font size (in points) for plot text. Default is 8.

angle_x

Numeric. Angle of the x-axis text labels. Default is 45.

Value

A ggplot object showing the grouped standardized beeswarm plot.