View source: R/plot_all_iso_switch.R
switchPlotTopSwitches | 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 switch size (as controlled 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,
onlySigIsoforms = FALSE,
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 FDR correct p-values must be smaller than for calling significant switches. Default 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%). |
onlySigIsoforms |
A logic indicating whether to only consider significant isoforms, meaning only analyzing genes where at least two isoforms which both have significant usage changes in opposite direction (quite strict). Naturally this only works if the isoform switch test used have isoform resolution (which the build in isoformSwitchTestDEXSeq has). If FALSE all isoforms with an absolute dIF value larger than |
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. Default 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 sub-folder for each comparison. If splitComparison is TRUE the sub-folders 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 sub-folder for those switches with predicted consequences and another sub-folder 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 switching 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 significant 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
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.