ballgown (version 2.4.2)

plotMeans: visualize transcript abundance by group

Description

visualize transcript abundance by group

Usage

plotMeans(gene, gown, overall = FALSE, groupvar, groupname = "all", meas = c("cov", "FPKM", "rcount", "ucount", "mrcount", "mcov"), colorby = c("transcript", "exon"), legend = TRUE, labelTranscripts = FALSE)

Arguments

gene

name of gene whose transcripts will be plotted. When using Cufflinks/Tablemaker output, usually of the form "XLOC_######"

gown

ballgown object containing experimental and phenotype data

overall

if TRUE, color features by the overall (experiment-wide) mean rather than a group-specific mean

groupvar

string representing the name of the variable denoting which sample belongs to which group. Can be "none" (if you want the study-wide mean), or must correspond to the name of a column of pData(gown). Usually a categorical variable.

groupname

string representing which group's expression means you want to plot. Can be "none" (if you want the study-wide mean), "all" (if you want a multipanel plot of each group's mean expression), or any of the levels of groupvar.

meas

type of expression measurement to plot. One of "cov", "FPKM", "rcount", "ucount", "mrcount", or "mcov". Not all types are valid for all features. (See description of tablemaker output for more information).

colorby

one of "transcript" or "exon", indicating which feature's abundances should dictate plot coloring.

legend

if TRUE (as it is by default), a color legend is drawn on top of the plot indicating the scale for feature abundances.

labelTranscripts

if TRUE, transcript ids are labeled on the left side of the plot. Default FALSE.

Value

produces a plot of the transcript structure for the specified gene in the current graphics device, colored by study-wide or group-specific mean expression level.

See Also

plotTranscripts

Examples

data(bg)
plotMeans('XLOC_000454', bg, groupvar='group', meas='FPKM', 
  colorby='transcript')