plot_expression_fraction: Plot feature set expression fraction

In bryancquach/omixjutsu: Utilities for omics analysis tasks

Plot feature set expression fraction

Description

Create a feature set fraction histogram and boxplot.

Usage

plot_expression_fraction(
  data,
  group = NULL,
  feature_ids = NULL,
  sample_ids = NULL,
  invert_rows = F,
  invert_cols = F,
  return_data = F,
  binsize = NULL,
  colors = NULL,
  hist_alpha = 0.75,
  box_fill = "goldenrod",
  box_alpha = 0.5,
  box_lwd = 1,
  jitter_alpha = 0.75,
  jitter_size = 1.75,
  x_title = "% of total expression",
  y_title = "Sample count"
)

Arguments

data	A feature (row) by sample (column) data frame or matrix with expression count values.
group	A single column data frame denoting categorical variable values to use to partition the data points into separate distributions/boxplots. Row names should match rownames in data.
feature_ids	A vector of row names for subsetting data for plotting.
sample_ids	A vector of column names for subsetting data for plotting.
invert_rows	A logical. Should feature_ids be used for excluding rows from plotting instead?
invert_cols	A logical. Should sample_ids be used for excluding columns from plotting instead?
return_data	A logical. Should plot data be returned instead of a ggplot object?
binsize	A numeric value for the histogram bin widths.
colors	A string vector. The histogram bar colors and jitter colors for each categorical variable value.
hist_alpha	A numeric value for the alpha level for histogram bars.
box_fill	A string. The fill color for the boxplot.
box_alpha	A numeric value for the alpha level for the boxplot.
box_lwd	A numeric value for the boxplot line width.
jitter_alpha	A numeric for the alpha level for jittered data points.
jitter_size	A numeric for the point size for jittered data points.
x_title	A string denoting the x-axis title. Only added to the boxplot.
y_title	A string denoting the y-axis title. Only added to the histogram.

Details

Calculates the fraction of feature (e.g., gene) expression represented by a user-specified set of features and plots this as a histogram and boxplot. The two plots are intended to be used as a single column, two row figure panel.

Value

A list with two ggplot objects hist and boxplot corresponding to a histogram and jittered boxplot respectively. If return_data is TRUE, then a data frame with the plot data values and grouping variable.

See Also

load_paired_end_qc_data hist_boxplot2

bryancquach/omixjutsu documentation built on Jan. 29, 2023, 3:47 p.m.