switchPlotTopSwitches {IsoformSwitchAnalyzeR} | R Documentation |
This function outputs the top n (defined by n
) Isoform Switch Analysis Plot (see switchPlot) for genes with significant isoform switches (as defined by alpha
and dIFcutoff
) to a specific folder (controlled by pathToOutput
. The plots are automatically sorted by decreasing significance or switche size (as controled by sortByQvals
). The plots can furthermore be created in sub-folders based both which conditions are compared and whether any consequences of the switch have been predicted. In summary it facilitates an easy and prioritized, (but comprehensive), manual analysis of isoform switches.
switchPlotTopSwitches( switchAnalyzeRlist, alpha = 0.05, dIFcutoff = 0.1, n=10, sortByQvals=TRUE, filterForConsequences = FALSE, pathToOutput = getwd(), splitComparison=TRUE, splitFunctionalConsequences = TRUE, IFcutoff=0.05, fileType = "pdf", additionalArguments=list(), quiet=FALSE )
switchAnalyzeRlist |
A |
alpha |
The cutoff which the (callibrated) fdr correct p-values must be smaller than for calling significant switches. Defualit is 0.05. |
dIFcutoff |
The cutoff which the changes in (absolute) isoform usage must be larger than before an isoform is considered switching. This cutoff can remove cases where isoforms with (very) low dIF values are deemed significant and thereby included in the downstream analysis. This cutoff is analogous to having a cutoff on log2 fold change in a normal differential expression analysis of genes to ensure the genes have a certain effect size. Default is 0.1 (10%). |
n |
The number of top genes (after filtering and sorted according to |
sortByQvals |
A logic indicating whether to the top |
filterForConsequences |
A logic indicating whether to only plot gene with predicted consequences of the isoform switch. Requires that predicted consequences have been annotated (via analyzeSwitchConsequences. Defalut is FALSE. |
pathToOutput |
A path to the folder in which the plots should be made. Default is working directory ( getwd() ). |
splitComparison |
A logic indicating whether to create a subfolder for each comparison. If splitComparison is TRUE the subfolders will be created else all isoform switch analyzer plots will saved in the same folder. Default is TRUE. |
splitFunctionalConsequences |
A logic indicating whether to create a subfolder for those switches with predicted consequences and another subfolder for those without. Requires that analyzeSwitchConsequences have been run. If |
IFcutoff |
The cutoff used for the minimum contribution to gene expression (in at least one condition) an isoforms must have to be plotted (measured as Isoform Fraction (IF) values). Default is 0 (which removes isoforms not contributing in any of the conditions). |
fileType |
A string indicating which file type is generated. Available are options are \'pdf\' and \'png\'. Default is pdf. |
additionalArguments |
A named list arguments passed to the |
quiet |
A logic indicating whether to avoid printing progress messages. Default is FALSE |
Changes in isoform usage are measure as the difference in isoform fraction (dIF) values, where isoform fraction (IF) values are calculated as <isoform_exp> / <gene_exp>.
For a list of the top swiching genes see ?extractTopSwitches.
An Isoform Switch Analysis Plot (as produce by switchPlot
) for each of the top n switches in each comparison where a gene have a signicant isoform switch is generated in the folder supplied by pathToOutput
Kristoffer Vitting-Seerup
Vitting-Seerup et al. The Landscape of Isoform Switches in Human Cancers. Mol. Cancer Res. (2017).
switchPlot
analyzeSwitchConsequences