Maintainer: Ji-Ping Wang, <[email protected]>
Reference: Xiong, B., Yang, Y., Fineis, F. Wang, J.-P., DegNorm: normalization of generalized transcript degradation improves accuracy in RNA-seq analysis, Genome Biology, 2019,20:75
DegNorm, short for Degradation Normalization, is a bioinformatics pipeline designed to correct for bias due to the heterogeneous patterns of transcript degradation in RNA-seq data. DegNorm helps improve the accuracy of the differential expression analysis by accounting for this degradation.
In practice, RNA samples are often more-or-less degraded, and the degradation severity is not only sample-specific, but gene-specific as well. It is known that longer genes tend to degrade faster than shorter ones. As such, commonplace global degradation normalization approaches that impose a single normalization factor on all genes within a sample can be ineffective in correcting for RNA degradation bias.
We’ve developed an R package and an indepedent Python package (download), both of which allow to run the entire pipeline from the RNA-seq alignment (.bam) files. For most-updated version, we recommend to use R package from bioconductor.
In version 1.3.1, we made following updates: 1. In
plot_coverage
funciton, an samples
options is
provided to allow user to select which samples to plot for coverage
curves. 2. We fixed a bug in DegNorm
funciton. In earlier
version, we used genes with maximum rho<0.1
from initial
SVD to determine the scaling factor before running core algorithm. For
some data with many samples and large degradation, it may return
NA
to cause issues.
DegNorm R package contains two major functions: (1) processing the RNA-seq alignment file (.bam) to calculate the coverage; and (2) using a core algorithm written in RcppArmadillo to perform rank-one over-approximation on converage matrices for each gene to estimate the degramation index (DI) score for each gene within each sample.
DegNorm outputs DI scores together with degradation-normalized read counts (based on DI scores). It also provides supplementary functions for visualization of degradation at both gene and sample level. The following diagram illustrates the flow of DegNorm pipeline.
The following vignette is intended to provide example codes for running DegNorm R package. It presumes that you have successfully installed DegNorm package. We illustrate below how to: 1) calculate the read coverage curves for all genes within all samples, and 2) perform degradation normalization on coverage curves. Either step is computing intensive. Dependent upon the number of samples and the sequencing depth, the total computing time may last a few hours. DegNorm utilizes the parallel computing functionality of R and automatically detects the number of cores on your computer to run jobs in parallel. Due to the large size of bam file and limited computing power of personal computer, we recommend users to run it in servers or computing clusters.
## specify bam_files from RNA-seq, you should replace it by your own bam files
bam_file_list=list.files(path=system.file("extdata",package="DegNorm"),
pattern=".bam$",full.names=TRUE)
The three bam files were subsetted from a specific region of chorosome 21 from the origianl bam for package size limitation. Original files can be found from the included reference above.
## calculate the read coverage score for all genes of all samples
coverage_res_chr21_sub=read_coverage_batch(bam_file_list, gtf_file,cores=2)
#> Parse gtf file...done
#> Index SRR873822_chr21_9900000-10000000.bam
#> Computing coverage for SRR873822_chr21_9900000-10000000.bam ...
#> SRR873822_chr21_9900000-10000000.bam is a paired-end bam file
#> SRR873822_chr21_9900000-10000000.bam is done!
#>
#> Index SRR873834_chr21_9900000-10000000.bam
#> Computing coverage for SRR873834_chr21_9900000-10000000.bam ...
#> SRR873834_chr21_9900000-10000000.bam is a paired-end bam file
#> SRR873834_chr21_9900000-10000000.bam is done!
#>
#> Index SRR873838_chr21_9900000-10000000.bam
#> Computing coverage for SRR873838_chr21_9900000-10000000.bam ...
#> SRR873838_chr21_9900000-10000000.bam is a paired-end bam file
#> SRR873838_chr21_9900000-10000000.bam is done!
cores
argument specifies the number of cores to use.
Users should try to use as many as possible cores to maximize the
computing efficiency.
Function read_coverage_batch
returns the coverage
matrices as a list, one per gene, and a dataframe for read counts, each
row for one gene and each column for one sample.
data("coverage_res_chr21")
## summarize the coverage results
summary_CoverageClass(coverage_res_chr21)
#> CoverageClass from read_coverage_batch function
#> $coverage : list of length 339
#> $counts : data.frame of dimension 339 by 3
#>
#> Samples: SRR873822_chr21.bam SRR873834_chr21.bam SRR873838_chr21.bam
#> Total number genes: 339
Run degnorm core algorithm for degradation normalization. DegNorm
purpose is for differential expression analysis. Thus genes with
extremely low read counts from all samples are filtered out. The current
filtering criterion is that if more than half of the samples have less
than 5 read count, that gene will not be considered in the degnorm
algorithm. In the following example, I am using downsamling to save time
below (default). Alternatively you can set down_sampling = 0, which
takes longer time. If down_samplin= 1
, read coverage scores
are binned with size by grid_size
for baseline selection to
achieve better efficiency. The default grid_size
is 10 bp.
We recommend to use a grid_size
less than 50 bp.
iteration
specifies the big loop in DegNorm algorithm and 5
is usually sufficient. loop
specifies the iteration number
in the matrix factorization over-approximation.
res_DegNorm_chr21 = degnorm(read_coverage = coverage_res_chr21[[1]],
counts = coverage_res_chr21[[2]],
iteration = 5,
down_sampling = 1,
grid_size=10,
loop = 100,
cores=2)
#> Filtering out genes with low read counts (x<5)..
#> Initial estimation of count normalization factors...
#> Initial degradation normalization without base-line selection...
#> DegNorm core algorithm starts...
#> DegNorm iteration 1
#> DegNorm iteration 2
#> DegNorm iteration 3
#> DegNorm iteration 4
#> DegNorm iteration 5
#> DegNorm core algorithm done!
If down_sampling= 0
, then the argument
grid_size
is ignored.
Function degnorm
returns a list of multiple objects.
counts_normed is the one with degradation normalized read counts for you
to input DeSeq or EdgeR for DE analysis.
## summary of the DegNorm output
summary_DegNormClass(res_DegNorm_chr21)
#> DegNormClass from DegNorm function:
#> $counts : data.frame of dimension 132 by 3
#> $counts_normed : data.frame of dimension 132 by 3
#> $DI : matrix array of dimension 132 by 3
#> $K : matrix array of dimension 132 by 3
#> $convergence : integer of length 132
#> $envelop : list of length 132
#>
#> Samples: SRR873822_chr21.bam SRR873834_chr21.bam SRR873838_chr21.bam
#> Total number genes: 132
The difference of number of genes between res_DegNorm
and coverage_res
is 207 (339-132). The 207 genes were
filtered out from degnorm
degradation normalization because
less than half of the samples (3) have more than 5 read count.
DegNorm provides four plot functions for visualization of degradation and sample quality diagnosis.
##gene named "SOD1"
plot_coverage(gene_name="SOD1", coverage_output=coverage_res_chr21,
degnorm_output=res_DegNorm_chr21,group=c(0,1,1))
In version 1.3.1, a new argument samples was added so the user can specifiy which samples to plot.
##gene named "SOD1"
plot_coverage(gene_name="SOD1", coverage_output=coverage_res_chr21,
degnorm_output=res_DegNorm_chr21,group=c(0,1),
samples=c("SRR873822_chr21.bam", "SRR873834_chr21.bam"))
sessionInfo()
#> R version 4.4.2 (2024-10-31)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.1 LTS
#>
#> Matrix products: default
#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so; LAPACK version 3.12.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_US.UTF-8 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: Etc/UTC
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats graphics grDevices utils datasets methods base
#>
#> other attached packages:
#> [1] knitr_1.49 DegNorm_1.17.0 rmarkdown_2.29
#>
#> loaded via a namespace (and not attached):
#> [1] DBI_1.2.3 bitops_1.0-9
#> [3] gridExtra_2.3 httr2_1.0.7
#> [5] biomaRt_2.63.0 rlang_1.1.4
#> [7] magrittr_2.0.3 matrixStats_1.4.1
#> [9] compiler_4.4.2 RSQLite_2.3.8
#> [11] GenomicFeatures_1.59.1 reshape2_1.4.4
#> [13] png_0.1-8 vctrs_0.6.5
#> [15] txdbmaker_1.3.1 stringr_1.5.1
#> [17] pkgconfig_2.0.3 crayon_1.5.3
#> [19] fastmap_1.2.0 dbplyr_2.5.0
#> [21] XVector_0.47.0 labeling_0.4.3
#> [23] ca_0.71.1 utf8_1.2.4
#> [25] Rsamtools_2.23.1 UCSC.utils_1.3.0
#> [27] purrr_1.0.2 bit_4.5.0
#> [29] xfun_0.49 zlibbioc_1.52.0
#> [31] cachem_1.1.0 GenomeInfoDb_1.43.2
#> [33] jsonlite_1.8.9 progress_1.2.3
#> [35] blob_1.2.4 DelayedArray_0.33.2
#> [37] BiocParallel_1.41.0 parallel_4.4.2
#> [39] prettyunits_1.2.0 R6_2.5.1
#> [41] bslib_0.8.0 stringi_1.8.4
#> [43] RColorBrewer_1.1-3 rtracklayer_1.67.0
#> [45] GenomicRanges_1.59.1 jquerylib_0.1.4
#> [47] iterators_1.0.14 Rcpp_1.0.13-1
#> [49] assertthat_0.2.1 SummarizedExperiment_1.37.0
#> [51] IRanges_2.41.1 Matrix_1.7-1
#> [53] tidyselect_1.2.1 abind_1.4-8
#> [55] yaml_2.3.10 viridis_0.6.5
#> [57] TSP_1.2-4 doParallel_1.0.17
#> [59] codetools_0.2-20 curl_6.0.1
#> [61] plyr_1.8.9 lattice_0.22-6
#> [63] tibble_3.2.1 withr_3.0.2
#> [65] Biobase_2.67.0 KEGGREST_1.47.0
#> [67] evaluate_1.0.1 heatmaply_1.5.0
#> [69] BiocFileCache_2.15.0 xml2_1.3.6
#> [71] Biostrings_2.75.1 pillar_1.9.0
#> [73] filelock_1.0.3 MatrixGenerics_1.19.0
#> [75] foreach_1.5.2 stats4_4.4.2
#> [77] plotly_4.10.4 generics_0.1.3
#> [79] RCurl_1.98-1.16 S4Vectors_0.45.2
#> [81] hms_1.1.3 ggplot2_3.5.1
#> [83] munsell_0.5.1 scales_1.3.0
#> [85] glue_1.8.0 lazyeval_0.2.2
#> [87] maketools_1.3.1 tools_4.4.2
#> [89] dendextend_1.19.0 BiocIO_1.17.1
#> [91] data.table_1.16.2 sys_3.4.3
#> [93] webshot_0.5.5 GenomicAlignments_1.43.0
#> [95] registry_0.5-1 buildtools_1.0.0
#> [97] XML_3.99-0.17 grid_4.4.2
#> [99] tidyr_1.3.1 crosstalk_1.2.1
#> [101] seriation_1.5.6 AnnotationDbi_1.69.0
#> [103] colorspace_2.1-1 GenomeInfoDbData_1.2.13
#> [105] restfulr_0.0.15 cli_3.6.3
#> [107] rappdirs_0.3.3 fansi_1.0.6
#> [109] S4Arrays_1.7.1 viridisLite_0.4.2
#> [111] dplyr_1.1.4 gtable_0.3.6
#> [113] sass_0.4.9 digest_0.6.37
#> [115] BiocGenerics_0.53.3 SparseArray_1.7.2
#> [117] farver_2.1.2 rjson_0.2.23
#> [119] htmlwidgets_1.6.4 memoise_2.0.1
#> [121] htmltools_0.5.8.1 lifecycle_1.0.4
#> [123] httr_1.4.7 bit64_4.5.2