RNAmodR.ML: detecting patterns of post-transcriptional modifications using machine learning
2024-10-29
Package
RNAmodR.ML 1.20.0
1 Introduction
Post-transcriptional modifications can be found abundantly in rRNA and tRNA and can be detected classically via several strategies. However, difficulties arise if the identity and the position of the modified nucleotides is to be determined at the same time. Classically, a primer extension, a form of reverse transcription (RT), would allow certain modifications to be accessed by blocks during the RT changes or changes in the cDNA sequences. Other modification would need to be selectively treated by chemical reactions to influence the outcome of the reverse transcription.
With the increased availability of high throughput sequencing, these classical methods were adapted to high throughput methods allowing more RNA molecules to be accessed at the same time. However, patterns of some modification cannot be detected by accessing small number of parameters. For these cases machine learning models can be trained on data from positions known to be modified in order to detect additional modified positions.
To extend the functionality of the RNAmodR package and classical detection
strategies used for RiboMethSeq or AlkAnilineSeq (see RNAmodR.RiboMethSeq and
RNAmodR.AlkAnilineSeq packages) towards detection through machine learning
models, RNAmodR.ML provides classes and an example workflow.
2 Using RNAmodR.ML
## Warning: replacing previous import 'utils::findMatches' by
## 'S4Vectors::findMatches' when loading 'ExperimentHubData'library(rtracklayer)
library(GenomicRanges)
library(RNAmodR.ML)
library(RNAmodR.Data)The ModifierML class extends the Modifier class from the RNAmodR package
and adds one slot, mlModel, a getter/setter getMLModel/setMLModel, an
additional useMLModel function to be called from the aggregate function.
The slot mlModel can either be an empty character or contain a name of a
ModifierMLModel class, which is loaded upon creation of a ModifierML object,
and serves as a wrapper around a machine learning model. For different types of
machine learning models ModifierMLModel derived classes are available, which
currently are:
ModifierMLrangerfor models generated with therangerpackage (Wright and Ziegler 2017)ModifierMLkerasfor models generated with thekeraspackage (Allaire and Chollet 2018)
To illustrate how to develop a machine learning model with help from the
RNAmodR.ML package, an example is given below.
3 Development of new Modifier class
As an example for this vignette, we will try to detect D positions in
AlkAnilineSeq data. First define a specific ModifierML class loading pileup
and coverage data. In this example, the RNA specific RNAModifierML class is
used.
setClass("ModMLExample",
contains = c("RNAModifierML"),
prototype = list(mod = c("D"),
score = "score",
dataType = c("PileupSequenceData",
"CoverageSequenceData"),
mlModel = character(0)))
# constructor function for ModMLExample
ModMLExample <- function(x, annotation = NA, sequences = NA, seqinfo = NA,
...){
RNAmodR:::Modifier("ModMLExample", x = x, annotation = annotation,
sequences = sequences, seqinfo = seqinfo, ...)
}
setClass("ModSetMLExample",
contains = "ModifierSet",
prototype = list(elementType = "ModMLExample"))
# constructor function for ModSetMLExample
ModSetMLExample <- function(x, annotation = NA, sequences = NA, seqinfo = NA,
...){
RNAmodR:::ModifierSet("ModMLExample", x, annotation = annotation,
sequences = sequences, seqinfo = seqinfo, ...)
}Since the mlModel slot contains an empty character, the creation of the object
will not automatically trigger a search for modifications. However, it will
aggregate the data in the format we want to use. The aggregate_example
function is just an example and the aggregation of the data is part of the
model building. (See (#Summary))
setMethod(
f = "aggregateData",
signature = signature(x = "ModMLExample"),
definition =
function(x){
aggregate_example(x)
}
)4 Getting training data
To gather training data, we just create a ModMLExample object and let it do
its job.
me <- ModMLExample(files[[1]], annotation, sequences)## Import genomic features from the file as a GRanges object ... OK
## Prepare the 'metadata' data frame ... OK
## Make the TxDb object ... OK
## Loading Pileup data from BAM files ... OK
## Loading Coverage data from BAM files ... OK
## Aggregating data and calculating scores ... Starting to search for 'Dihydrouridine' ...## Warning: ML model not set. Skipped search for modifications ...## done.Afterwards we need to load/create coordinates for positions known to be modified as well as positions known to be unmodified.
data("dmod",package = "RNAmodR.ML")
# we just select the next U position from known positions
nextUPos <- function(gr){
nextU <- lapply(seq.int(1L,2L),
function(i){
subseq <- subseq(sequences(me)[dmod$Parent], start(dmod)+3L)
pos <- start(dmod) + 2L +
vapply(strsplit(as.character(subseq),""),
function(y){which(y == "U")[i]},integer(1))
ans <- dmod
ranges(ans) <- IRanges(start = pos, width = 1L)
ans
})
nextU <- do.call(c,nextU)
nextU$mod <- NULL
unique(nextU)
}
nondmod <- nextUPos(dmod)
nondmod <- nondmod[!(nondmod %in% dmod)]
coord <- unique(c(dmod,nondmod))
coord <- coord[order(as.integer(coord$Parent))]With these coordinates the aggregated data of the ModMLExample can be subset
to a training data set using the function trainingData.
trainingData <- trainingData(me,coord)
trainingData <- unlist(trainingData, use.names = FALSE)
# converting logical labels to integer
trainingData$labels <- as.integer(trainingData$labels)5 Training a model
How a specific model can be trained or what kind of strategies can be employed
to successfully train a model, is out of scope for the vignette. For this
example a random forest is trained using the functionality provided by the
ranger package.
library(ranger)
model <- ranger(labels ~ ., data.frame(trainingData))6 Constructing a ‘ModifierMLModel’
Now, the trained model can be used to create a new ModifierMLModel class and
object.
setClass("ModifierMLexample",
contains = c("ModifierMLranger"),
prototype = list(model = model))
ModifierMLexample <- function(...){
new("ModifierMLexample")
}
mlmodel <- ModifierMLexample()To be able to use the model via the ModifierMLModel class, we also need to
define an accessor to the predictions made by the model. This function is called
useModel and is already prefined for the ModifierMLModel classes mentioned
above in secion Using RNAmodR.ML.
getMethod("useModel", c("ModifierMLranger","ModifierML"))## Method Definition:
##
## function (x, y)
## {
## data <- getAggregateData(y)
## model <- x@model
## if (!is(model, "ranger")) {
## stop("model is not a ranger model")
## }
## unlisted_data <- unlist(data, use.names = FALSE)
## p <- predict(x@model, data.frame(unlisted_data))
## relist(p$predictions, data)
## }
## <bytecode: 0x630447e0bd50>
## <environment: namespace:RNAmodR.ML>
##
## Signatures:
## x y
## target "ModifierMLranger" "ModifierML"
## defined "ModifierMLranger" "ModifierML"If the results of these function is not usable for a specific model, it can
redefined for your needs. As defined by RNAmodR.ML the function returns a
NumericList along the aggregated data of the ModifierML object.
7 Setting and using the model
The generated ModifierMLexample wrapper can now be set for the ModifierML
object using the setMLModel function. (If a model is saved as part of a
package, this step ist not necessary, because it can be part of the class
definition)
setMLModel(me) <- mlmodelIn order for the prediction data to be usable, another function has to be
implemented to save the predictions in the aggregated data. The function is
called useMLModel.
setMethod(f = "useMLModel",
signature = signature(x = "ModMLExample"),
definition =
function(x){
predictions <- useModel(getMLModel(x), x)
data <- getAggregateData(x)
unlisted_data <- unlist(data, use.names = FALSE)
unlisted_data$score <- unlist(predictions)
x@aggregate <- relist(unlisted_data,data)
x
}
)By re-running the aggregate function and force an update of the data, the
predictions are made and used to populate the score column as outlined above.
me <- aggregate(me, force = TRUE)8 Performance
During the model building phase some form of a performance measurement usually
is included. In addition to these model specific measurements, RNAmodR.ML
includes the functionality from the ROCR package inherited from the RNAmodR
package. With this the performance of a model can evaluted over the training set
or any coordinates.
plotROC(me, dmod)
Figure 1: Performance of the maching learning model to distinguish unmodified from modified nucleotides
9 Using a ModifierML class
Since we want to use the ModifierML object to detect modifications, we also
need to define the findMod function. Based on the information on the
performance, we set a threshold of 0.8 for the prediction score for detecting
D modifications. In the example below this threshold is hardcoded in the
find_mod_example function, but can also be implemented using the settings
function.
setMethod(
f = "findMod",
signature = signature(x = "ModMLExample"),
definition =
function(x){
find_mod_example(x, 25L)
}
)Now we can redfine the ModMLExample class with the slot mlModel already set
to the ModifierMLexample class. The ModMLExample is now complete.
rm(me)
setClass("ModMLExample",
contains = c("RNAModifierML"),
prototype = list(mod = c("D"),
score = "score",
dataType = c("PileupSequenceData",
"CoverageSequenceData"),
mlModel = "ModifierMLexample"))
me <- ModMLExample(files[[1]], annotation, sequences)## Import genomic features from the file as a GRanges object ... OK
## Prepare the 'metadata' data frame ... OK
## Make the TxDb object ... OK
## Loading Pileup data from BAM files ... OK
## Loading Coverage data from BAM files ... OK
## Aggregating data and calculating scores ... Starting to search for 'Dihydrouridine' ... done.The detected modifications can be access using the modifications function.
mod <- modifications(me)
mod <- split(mod, factor(mod$Parent,levels = unique(mod$Parent)))
mod## GRangesList object of length 36:
## $`1`
## GRanges object with 2 ranges and 5 metadata columns:
## seqnames ranges strand | mod source type
## <Rle> <IRanges> <Rle> | <character> <character> <character>
## [1] Q0020_15S_RRNA 48 + | D RNAmodR.ML RNAMOD
## [2] Q0020_15S_RRNA 323 + | D RNAmodR.ML RNAMOD
## score Parent
## <numeric> <character>
## [1] 0.901673 1
## [2] 0.833000 1
## -------
## seqinfo: 60 sequences from an unspecified genome; no seqlengths
##
## $`3`
## GRanges object with 2 ranges and 5 metadata columns:
## seqnames ranges strand | mod source type score
## <Rle> <IRanges> <Rle> | <character> <character> <character> <numeric>
## [1] RDN18-1 229 + | D RNAmodR.ML RNAMOD 0.834800
## [2] RDN18-1 1669 + | D RNAmodR.ML RNAMOD 0.806333
## Parent
## <character>
## [1] 3
## [2] 3
## -------
## seqinfo: 60 sequences from an unspecified genome; no seqlengths
##
## $`4`
## GRanges object with 2 ranges and 5 metadata columns:
## seqnames ranges strand | mod source type score
## <Rle> <IRanges> <Rle> | <character> <character> <character> <numeric>
## [1] RDN25-1 2 + | D RNAmodR.ML RNAMOD 0.893667
## [2] RDN25-1 2571 + | D RNAmodR.ML RNAMOD 0.803300
## Parent
## <character>
## [1] 4
## [2] 4
## -------
## seqinfo: 60 sequences from an unspecified genome; no seqlengths
##
## ...
## <33 more elements>10 Refining a model
Some of the modification found look reasonable. However, some of the positions seem to be noise.
options(ucscChromosomeNames=FALSE)plotDataByCoord(sequenceData(me),mod[["4"]][1])
Figure 2: Visualization of sequence data
Several options exist to improve the model: Either the threshold applied to the
prediction score can be raised to a higher value, like 0.9 or the model can
maybe retrained by including these position in another training data set. In
addition, the training data might be improved in general by higher sequencing
depth.
nonValidMod <- mod[c("1","4")]
nonValidMod[["18"]] <- nonValidMod[["18"]][2]
nonValidMod[["26"]] <- nonValidMod[["26"]][2]
nonValidMod <- unlist(nonValidMod)
nonValidMod <- nonValidMod[,"Parent"]
coord <- unique(c(dmod,nondmod,nonValidMod))
coord <- coord[order(as.integer(coord$Parent))]As an example, a new model is trained including the wrongly identified positions from the previous model as unmodified positions.
trainingData <- trainingData(me,coord)
trainingData <- unlist(trainingData, use.names = FALSE)
trainingData$labels <- as.integer(trainingData$labels)model2 <- ranger(labels ~ ., data.frame(trainingData), num.trees = 2000)
setClass("ModifierMLexample2",
contains = c("ModifierMLranger"),
prototype = list(model = model2))
ModifierMLexample2 <- function(...){
new("ModifierMLexample2")
}
mlmodel2 <- ModifierMLexample2()
me2 <- me
setMLModel(me2) <- mlmodel2
me2 <- aggregate(me2, force = TRUE)After updating the ModifierMLexample class and aggregating the data again
the performance looks a bit better…
plotROC(me2, dmod, score="score")
Figure 3: Performance aggregation of multiple samples and strategies
… and leads to a better result for detecting D modifications. Some positions are not detected anymore, which suggest that this model is still not an optimal solution and other factors could and should be improved upon as suggested above.
setMethod(
f = "findMod",
signature = signature(x = "ModMLExample"),
definition =
function(x){
find_mod_example(x, 25L)
}
)
me2 <- modify(me2, force = TRUE)
modifications(me2)## GRanges object with 45 ranges and 5 metadata columns:
## seqnames ranges strand | mod source type
## <Rle> <IRanges> <Rle> | <character> <character> <character>
## [1] tA-AGC-D 47 + | D RNAmodR.ML RNAMOD
## [2] tA-TGC-A 47 + | D RNAmodR.ML RNAMOD
## [3] tC-GCA-B 19 + | D RNAmodR.ML RNAMOD
## [4] tC-GCA-B 46 + | D RNAmodR.ML RNAMOD
## [5] tE-CTC-D 20 + | D RNAmodR.ML RNAMOD
## ... ... ... ... . ... ... ...
## [41] tV-CAC-D 47 + | D RNAmodR.ML RNAMOD
## [42] tW-CCA-G1 16 + | D RNAmodR.ML RNAMOD
## [43] tW-CCA-G1 46 + | D RNAmodR.ML RNAMOD
## [44] tY-GTA-D 21 + | D RNAmodR.ML RNAMOD
## [45] tY-GTA-D 22 + | D RNAmodR.ML RNAMOD
## score Parent
## <numeric> <character>
## [1] 0.968708 6
## [2] 0.981208 7
## [3] 0.913195 8
## [4] 0.951950 8
## [5] 0.838708 11
## ... ... ...
## [41] 0.943933 57
## [42] 0.884058 59
## [43] 0.823933 59
## [44] 0.913904 60
## [45] 0.829933 60
## -------
## seqinfo: 60 sequences from an unspecified genome; no seqlengthsIn addition to training a single model, several models can be trained and
combined to a ModifierSet.
mse <- ModSetMLExample(list(one = me, two = me2))An overall performance over several models can be analyzed or the individual performance compaired.
plotROC(mse, dmod, score= "score",
plot.args = list(avg = "threshold", spread.estimate = "stderror"))
Figure 4: Performance average across models
If several models are trained and each provides useful information, these can be
package into a single ModifierMLModel class to combine the output of several
models. Some of the functions outlined above need, e.g. useMLModel and/or
useModel, to be modified to provide one or more scores for detecting a
modification.
11 Packaging
If the created models can be saved to file, they can also be included in a package. This would allow others to use the models and the models can potentially be improved upon with increasing version numbers.
12 Summary
RNAmodR.ML provides the interface for machine learning models to be used
with RNAmodR to detect modified nucleotides in high throughput sequencing
data. For your own work defining a working model might take some time. We hope
that by using RNAmodR.ML the steps surrounding this crucial step might become
a bit easier.
However, if some steps or design choices made for RNAmodR.ML do not suit your
need, let us know. Contributions are always welcome as well.
13 Hints
We also want to provide some additional hints and suggestions for developing machine learning models.
- the aggregate function is used in the example above as a feature engineering
tool. You might want to skip this step, if you want to use a deep learning
model for example with
keras. - If you don’t want to engage in a feature enginering step and just want to
aggregate the sequence data as is, just do a custom
cbindon the data from theSequenceDataobjects (cbindworks onSequenceDataobjects, if they are of the same type. Convert each of them to aCompressedSplitDataFrameListusingas(x,"CompressedSplitDataFrameList")). - in a deep learning context, if a coordinate is selected without a flanking
value, e.g. when using
trainingData, a 2D tensor is returned (sample, values). This can be converted into a 3D tensor by providing a flanking value.
14 Sessioninfo
sessionInfo()## R version 4.4.1 (2024-06-14)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 24.04.1 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.20-bioc/R/lib/libRblas.so
## LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.12.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] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] ranger_0.16.0 Rsamtools_2.22.0 RNAmodR.Data_1.19.0
## [4] ExperimentHubData_1.32.0 AnnotationHubData_1.36.0 futile.logger_1.4.3
## [7] ExperimentHub_2.14.0 AnnotationHub_3.14.0 BiocFileCache_2.14.0
## [10] dbplyr_2.5.0 RNAmodR.ML_1.20.0 RNAmodR_1.20.0
## [13] Modstrings_1.22.0 Biostrings_2.74.0 XVector_0.46.0
## [16] rtracklayer_1.66.0 GenomicRanges_1.58.0 GenomeInfoDb_1.42.0
## [19] IRanges_2.40.0 S4Vectors_0.44.0 BiocGenerics_0.52.0
## [22] BiocStyle_2.34.0
##
## loaded via a namespace (and not attached):
## [1] BiocIO_1.16.0 bitops_1.0-9
## [3] filelock_1.0.3 tibble_3.2.1
## [5] graph_1.84.0 XML_3.99-0.17
## [7] rpart_4.1.23 lifecycle_1.0.4
## [9] httr2_1.0.5 lattice_0.22-6
## [11] ensembldb_2.30.0 OrganismDbi_1.48.0
## [13] backports_1.5.0 magrittr_2.0.3
## [15] Hmisc_5.2-0 sass_0.4.9
## [17] rmarkdown_2.28 jquerylib_0.1.4
## [19] yaml_2.3.10 RUnit_0.4.33
## [21] Gviz_1.50.0 DBI_1.2.3
## [23] RColorBrewer_1.1-3 abind_1.4-8
## [25] zlibbioc_1.52.0 purrr_1.0.2
## [27] AnnotationFilter_1.30.0 biovizBase_1.54.0
## [29] RCurl_1.98-1.16 nnet_7.3-19
## [31] VariantAnnotation_1.52.0 rappdirs_0.3.3
## [33] GenomeInfoDbData_1.2.13 AnnotationForge_1.48.0
## [35] codetools_0.2-20 DelayedArray_0.32.0
## [37] xml2_1.3.6 tidyselect_1.2.1
## [39] UCSC.utils_1.2.0 matrixStats_1.4.1
## [41] base64enc_0.1-3 GenomicAlignments_1.42.0
## [43] jsonlite_1.8.9 Formula_1.2-5
## [45] tools_4.4.1 progress_1.2.3
## [47] stringdist_0.9.12 Rcpp_1.0.13
## [49] glue_1.8.0 gridExtra_2.3
## [51] SparseArray_1.6.0 BiocBaseUtils_1.8.0
## [53] xfun_0.48 MatrixGenerics_1.18.0
## [55] dplyr_1.1.4 withr_3.0.2
## [57] formatR_1.14 BiocManager_1.30.25
## [59] fastmap_1.2.0 latticeExtra_0.6-30
## [61] fansi_1.0.6 caTools_1.18.3
## [63] digest_0.6.37 mime_0.12
## [65] R6_2.5.1 colorspace_2.1-1
## [67] gtools_3.9.5 jpeg_0.1-10
## [69] dichromat_2.0-0.1 biomaRt_2.62.0
## [71] RSQLite_2.3.7 utf8_1.2.4
## [73] generics_0.1.3 data.table_1.16.2
## [75] prettyunits_1.2.0 httr_1.4.7
## [77] htmlwidgets_1.6.4 S4Arrays_1.6.0
## [79] pkgconfig_2.0.3 gtable_0.3.6
## [81] blob_1.2.4 htmltools_0.5.8.1
## [83] bookdown_0.41 RBGL_1.82.0
## [85] ProtGenerics_1.38.0 scales_1.3.0
## [87] Biobase_2.66.0 png_0.1-8
## [89] colorRamps_2.3.4 knitr_1.48
## [91] lambda.r_1.2.4 rstudioapi_0.17.1
## [93] reshape2_1.4.4 rjson_0.2.23
## [95] checkmate_2.3.2 curl_5.2.3
## [97] biocViews_1.74.0 cachem_1.1.0
## [99] stringr_1.5.1 KernSmooth_2.23-24
## [101] BiocVersion_3.20.0 parallel_4.4.1
## [103] foreign_0.8-87 AnnotationDbi_1.68.0
## [105] restfulr_0.0.15 pillar_1.9.0
## [107] grid_4.4.1 vctrs_0.6.5
## [109] gplots_3.2.0 cluster_2.1.6
## [111] htmlTable_2.4.3 evaluate_1.0.1
## [113] magick_2.8.5 tinytex_0.53
## [115] GenomicFeatures_1.58.0 cli_3.6.3
## [117] compiler_4.4.1 futile.options_1.0.1
## [119] rlang_1.1.4 crayon_1.5.3
## [121] interp_1.1-6 plyr_1.8.9
## [123] stringi_1.8.4 deldir_2.0-4
## [125] BiocParallel_1.40.0 BiocCheck_1.42.0
## [127] txdbmaker_1.2.0 munsell_0.5.1
## [129] lazyeval_0.2.2 Matrix_1.7-1
## [131] BSgenome_1.74.0 hms_1.1.3
## [133] bit64_4.5.2 ggplot2_3.5.1
## [135] KEGGREST_1.46.0 highr_0.11
## [137] SummarizedExperiment_1.36.0 ROCR_1.0-11
## [139] memoise_2.0.1 bslib_0.8.0
## [141] bit_4.5.0References
Allaire, JJ, and François Chollet. 2018. Keras: R Interface to ’Keras’. https://CRAN.R-project.org/package=keras.
Wright, Marvin N., and Andreas Ziegler. 2017. “ranger: A Fast Implementation of Random Forests for High Dimensional Data in C++ and R.” Journal of Statistical Software 77 (1): 1–17. https://doi.org/10.18637/jss.v077.i01.