makePlot.splice.junction.event.rates {QoRTs}R Documentation

Plot Splice Junction Event Rates

Description

Plots the rates at which splice junctions occur.

Usage

   makePlot.splice.junction.event.counts(plotter,
                                    high.low.cutoff = 4, 
                                    debugMode, singleEndMode, 
                                    plot = TRUE,
                                    ...)
   makePlot.splice.junction.event.ratesPerRead(plotter,
                                    high.low.cutoff = 4, 
                                    debugMode, singleEndMode,
                                    plot = TRUE,
                                    ...)   
   makePlot.splice.junction.event.proportions(plotter,
                                    high.low.cutoff = 4, 
                                    debugMode, singleEndMode,
                                    plot = TRUE,
                                    ...) 
   makePlot.splice.junction.event.proportionsByType(plotter, 
                                    high.low.cutoff = 4, 
                                    debugMode, singleEndMode,
                                    plot = TRUE,
                                    ...)

Arguments

plotter

A QoRT_Plotter reference object. See build.plotter.

high.low.cutoff

For Advanced users only! The cutoff between high and low expression splice junctions. Note that in order to function, this same cutoff MUST be used by the QoRTs jar utility that generates these counts.

debugMode

Activates debug mode, which causes more verbose reporting.

singleEndMode

Logical. Determines whether the dataset consists of single-ended reads. By default this is determined from the data. Thus, this parameter should never need to be set by the user.

plot

Logical. If FALSE, suppress plotting and return TRUE if and only if the data is present in the dataset to allow plotting. Useful to automatically filter out missing data plots.

...

Arguments to be passed to methods, such as graphical parameters (see par).

Details

These functions plot various metrics for the rate at which splice junction "events" occur. A splice junction "event" is an occurrance of a mapped read-pair bridging a splice junction. Some read-pairs may contain multiple splice junction events, and some read-pairs may contain none.

Splice junctions are characterized into six categories:

makePlot.splice.junction.event.counts plots the number (y-axis) of all splice junction events falling into each of six categories. Note that because different samples/runs may have different total read counts and/or library sizes, this function is generally not the best for comparing between samples. For most purposes, makePlot.splice.junction.event.ratesPerRead will be preferable.

makePlot.splice.junction.event.ratesPerRead plots the rate (y-axis) at which each type of splice junction events appear, per read-pair.

makePlot.splice.junction.event.proportions plots the proportion (y-axis) of all splice junction events falling into the six categories.

makePlot.splice.junction.event.proportionsByType plots the proportion (y-axis) at which splice junction events appear on known vs novel splice junction loci, the proportion of known splice junction events that occur on low-coverage junctions (1-3 read-pairs) vs high-coverage junctions (4 or more read-pairs), and the proportion of novel splice junction events that occur on low vs high coverage junctions.

All of these plots are generally used to detect whether sample-specific or batch effects have a substantial or biased effect on splice junction appearance, either due to differences in the original RNA, or due to artifacts that alter the rate at which the aligner maps across splice junctions.

See Also

build.plotter, makePlot.splice.junction.loci.counts

Examples

data(res,package="QoRTsExampleData");
plotter <- build.plotter.colorByGroup(res);
makePlot.splice.junction.event.counts(plotter);  
## Starting: Splice Junction Event Rates plot.
## Finished: Splice Junction Event Rates plot.[time: 2018-09-25 13:13:18],[elapsed: 0.08 secs]

plot of chunk unnamed-chunk-1

makePlot.splice.junction.event.ratesPerRead(plotter);
## Starting: Splice Junction Event Rates plot.
## Finished: Splice Junction Event Rates plot.[time: 2018-09-25 13:13:19],[elapsed: 0.13 secs]

plot of chunk unnamed-chunk-1

makePlot.splice.junction.event.proportions(plotter);
## Starting: Splice Junction Event Rates plot.
## Finished: Splice Junction Event Rates plot.[time: 2018-09-25 13:13:19],[elapsed: 0.19 secs]

plot of chunk unnamed-chunk-1

makePlot.splice.junction.event.proportionsByType(plotter);
## Starting: Splice Junction Event Rates plot.
## Finished: Splice Junction Event Rates plot.[time: 2018-09-25 13:13:19],[elapsed: 0.22 secs]

plot of chunk unnamed-chunk-1

#Legend:
makePlot.legend.box(plotter);

plot of chunk unnamed-chunk-1


[Package QoRTs version 1.3.6 Index]