We introduce PAIRADISE (PAIred Replicate analysis of Allelic DIfferential Splicing Events), a method for detecting allele-specific alternative splicing (ASAS) from RNA-seq data. PAIRADISE uses a statistical model that aggregates ASAS signals across multiple individuals in a population. It formulates ASAS detection as a statistical problem for identifying differential alternative splicing from RNA-seq data with paired replicates. The PAIRADISE statistical model is applicable to many forms of allele-specific isoform variation (e.g. RNA editing), and can be used as a generic statistical model for RNA-seq studies involving paired replicates. More details can be found: https://github.com/Xinglab/PAIRADISE
if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("PAIRADISE")The development version is also available to download from Github.
BiocManager::install("hubentu/PAIRADISE")library(PAIRADISE)A PDseDataSet class is defined to store the splicing count data, and contains inclusion and skipping counts for each sample. A design dataframe is required to describe the paired sample information. An integer dataframe of inclusion and skipping lengths are also required. The PDseDataSet extends the SummarizedExperiment class. All functions from SummarizedExperiment are inherited.
Here is an example to construct a PDseDataSet with 2 pairs of samples.
library(abind)
icount <- matrix(1:4, 1)
scount <- matrix(5:8, 1)
acount <- abind(icount, scount, along = 3)
acount
#> , , 1
#>
#> [,1] [,2] [,3] [,4]
#> [1,] 1 2 3 4
#>
#> , , 2
#>
#> [,1] [,2] [,3] [,4]
#> [1,] 5 6 7 8
design <- data.frame(sample = rep(c("s1", "s2"), 2),
group = rep(c("T", "N"), each = 2))
lens <- data.frame(sLen=1L, iLen=2L)
PDseDataSet(acount, design, lens)
#> class: PDseDataSet
#> dim: 1 4
#> metadata(0):
#> assays(1): counts
#> rownames: NULL
#> rowData names(2): sLen iLen
#> colnames: NULL
#> colData names(2): sample groupA count matrix can be imported as a PDseDataSet directly.
data("sample_dataset")
sample_dataset
#> ExonID I1 S1 I2 S2 I_len S_len
#> 1 Exon 1 624,661,209 564,450,167 549,468,103 1261,767,325 180 90
#> 2 Exon 2 963,1139,388 1104,1100,330 1196,938,439 317,374,93 180 90
#> 3 Exon 3 15,17000,20,100 2,12,1,1 1,6,7,10 274,NA,320,5650 3 1
#> 4 Exon 4 3,5,9 13,27,4 5,9,9 11,29,3 3 1PAIRADISE also includes two small sample datasets from Geuvadis and TCGA:
data("sample_dataset_CEU")
data("sample_dataset_LUSC")The “sample_dataset_CEU” dataset was generated by analyzing the allele-specific alternative splicing events in the GEUVADIS CEU data. Allele-specific reads were mapped onto alternative splicing events using rPGA (version 2.0.0). Then the allele-specific bam files mapped onto the two haplotypes are merged together to detect alternative splicing events using rMATS (version 3.2.5). The second LUSC dataset was generated by analyzing the tumor versus adjacent control samples from TCGA LUSC RNA-seq data.
Each row of the data corresponds to a different alternative splicing event. The data should have 7 columns. The order of the 7 columns in the input data frame to PAIRADISE follows the convention of the output of the rMATS software, arranged as follows:
To import the data to a PDseDataSet object.
pdat <- PDseDataSetFromMat(sample_dataset)
#> Loading data...
pdat
#> class: PDseDataSet
#> dim: 4 8
#> metadata(0):
#> assays(1): counts
#> rownames(4): Exon 1 Exon 2 Exon 3 Exon 4
#> rowData names(2): iLen sLen
#> colnames(8): S1.T S2.T ... S3.N S4.N
#> colData names(2): sample grouppairadise methodThe pairadise function implements the PAIRADISE statistical model for the PDseDataSet object. Multiple processors can be used via the BiocParallel package. The function returns a PDseDataSet object with statistical estimates in its rowData. Here is how to run the model with 2 threads.
pairadise_output <- pairadise(pdat, numCluster = 2)A function results can be used to calculate p values and filter the significant results. For example, results significant at an FDR of 0.01 can be obtained as follows.
res <- results(pairadise_output, p.adj = "BH", sig.level = 0.01)
res
#> DataFrame with 3 rows and 3 columns
#> testStats p.value p.adj
#> <numeric> <numeric> <numeric>
#> Exon 1 9.54941 0.002000136 0.00274910
#> Exon 2 9.49366 0.002061827 0.00274910
#> Exon 3 12.29846 0.000453331 0.00181333With details=TRUE, more detailed statistical estimates can be returned.
res <- results(pairadise_output, details = TRUE)
colnames(res)
#> [1] "testStats" "p.value" "mu.u" "s1.u" "s2.u" "s.u"
#> [7] "delta" "mu.c" "s1.c" "s2.c" "s.c" "totalIter"
#> [13] "latent" "p.adj"
res$latent[3,]
#> $latent
#> [,1] [,2] [,3]
#> psi1.u 0.857840921 0.899015595 0.9405878997
#> psi2.u 0.001442136 0.006073380 0.0006441722
#> alpha.u 2.281881387 2.292264054 2.2888561292
#> psi1.c 0.824598001 0.878199864 0.9348674453
#> psi2.c 0.001352191 0.007339606 0.0005979513
#> alpha.c 1.552849901 1.975950491 2.6566262109sessionInfo()
#> R version 4.3.1 (2023-06-16)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 22.04.3 LTS
#>
#> Matrix products: default
#> BLAS: /home/biocbuild/bbs-3.18-bioc/R/lib/libRblas.so
#> LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_GB LC_COLLATE=C
#> [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
#> [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
#> [9] LC_ADDRESS=C LC_TELEPHONE=C
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
#>
#> time zone: America/New_York
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats graphics grDevices utils datasets methods base
#>
#> other attached packages:
#> [1] S4Vectors_0.40.0 abind_1.4-5 PAIRADISE_1.18.0 nloptr_2.0.3
#> [5] BiocStyle_2.30.0
#>
#> loaded via a namespace (and not attached):
#> [1] Matrix_1.6-1.1 jsonlite_1.8.7
#> [3] compiler_4.3.1 BiocManager_1.30.22
#> [5] crayon_1.5.2 SummarizedExperiment_1.32.0
#> [7] Biobase_2.62.0 GenomicRanges_1.54.0
#> [9] bitops_1.0-7 parallel_4.3.1
#> [11] jquerylib_0.1.4 IRanges_2.36.0
#> [13] BiocParallel_1.36.0 yaml_2.3.7
#> [15] fastmap_1.1.1 lattice_0.22-5
#> [17] R6_2.5.1 XVector_0.42.0
#> [19] S4Arrays_1.2.0 GenomeInfoDb_1.38.0
#> [21] knitr_1.44 BiocGenerics_0.48.0
#> [23] DelayedArray_0.28.0 bookdown_0.36
#> [25] MatrixGenerics_1.14.0 GenomeInfoDbData_1.2.11
#> [27] bslib_0.5.1 rlang_1.1.1
#> [29] cachem_1.0.8 xfun_0.40
#> [31] sass_0.4.7 SparseArray_1.2.0
#> [33] cli_3.6.1 zlibbioc_1.48.0
#> [35] grid_4.3.1 digest_0.6.33
#> [37] evaluate_0.22 codetools_0.2-19
#> [39] stats4_4.3.1 RCurl_1.98-1.12
#> [41] rmarkdown_2.25 matrixStats_1.0.0
#> [43] tools_4.3.1 htmltools_0.5.6.1