analyzeORF {IsoformSwitchAnalyzeR} | R Documentation |
Predicts the most likely Open Reading Frame (ORF) and the NMD sensitivity of the isoforms stored in a switchAnalyzeRlist
object. This functionality is made to help annotate isoforms if you have performed (guided) de-novo isoform reconstruction (isoform deconvolution). Else you should use the annotated CDS (CoDing Sequence) typically obtained though one of the implemented import methods (see vignette for details).
analyzeORF( switchAnalyzeRlist, genomeObject, minORFlength=100, orfMethod = "longest", cds = NULL, PTCDistance = 50, startCodons="ATG", stopCodons=c("TAA", "TAG", "TGA"), showProgress=TRUE, quiet=FALSE )
switchAnalyzeRlist |
A |
genomeObject |
A |
minORFlength |
The minimum size (in nucleotides) an ORF must be to be considered (and reported). Please note that we recommend using CPAT to predict coding potential instead of this cutoff - it is simply implemented as a pre-filter, see analyzeCPAT. Default is 100 nucleotides, which >97.5% of Gencode coding isoforms in both human and mouse have. |
orfMethod |
A string indicating which of the 4 available ORF identification methods should be used. The methods are:
Default is |
cds |
A CDSSet object containing annotated coding regions, see ?CDSSet and ?getCDS for more information. Only necessary if |
PTCDistance |
A numeric giving the maximal allowed premature termination codon-distance: The minimum distance (number of nucleotides) from the STOP codon to the final exon-exon junction. If the distance from the STOP to the final exon-exon junction is larger than this the isoform to be marked as NMD-sensitive. Default is 50. |
startCodons |
A vector of strings indicating the start codons identified in the DNA sequence. Default is 'ATG' (corresponding to the RNA-sequence AUG). |
stopCodons |
A vector of strings indicating the stop codons identified in the DNA sequence. Default is c("TAA", "TAG", "TGA"). |
showProgress |
A logic indicating whether to make a progress bar (if TRUE) or not (if FALSE). Defaults is TRUE. |
quiet |
A logic indicating whether to avoid printing progress messages (incl. progress bar). Default is FALSE |
The function uses the genomic coordinats of the transcript model to extract the nucleotide sequence of the transcript from the supplied BSgenome object (refrence genome). The nucloetide sequence is then used to predict the most likely ORF (the method is controled by the orfMethod
argument, see above)). If the distance from the stop position (ORF end) to the final exon-exon junction is larger than the threshold given in PTCDistance
(and the stop position does not fall in the last exon), the stop position is considered premature and the transcript is marked as NMD (nonsense mediated decay) sensitive in accordence with litterature consensus (Weischenfeldt et al (see refrences)).
The gencode refrence annoation used here are GencodeV19, GencodeV24, GencodeM1 and GencodeM9. For more info see Vitting-Seerup et al 2017.
A switchAnalyzeRlist
where:
1
: A collumns called PTC
indicating the NMD sensitivity have been added to the isoformFeatures
entry of the switchAnalyzeRlist.
2
: A data.frame
containing the details of the ORF analysis have been added to the switchAnalyzeRlist under the name 'orfAnalysis'.
The data.frame added have one row pr isoform and contains 11 columns:
isoform_id
: The name of the isoform analyzed. Mathces the 'isoform_id' entry in the 'isoformFeatures' entry of the switchAnalyzeRlist
orfTransciptStart
: The start position of the ORF in transcript cooridnats, here defined as the position of the 'A' in the 'AUG' start motif.
orfTransciptEnd
: The end position of the ORF in transcript coordinats, here defined as the last nucleotide before the STOP codon (meaning the stop codon is not included in these coordinates).
orfTransciptLength
: The length of the ORF
orfStarExon
: The exon in which the start codon is
orfEndExon
: The exon in which the stop codon is
orfStartGenomic
: The start position of the ORF in genomic cooridnats, here defined as the the position of the 'A' in the 'AUG' start motif.
orfEndGenomic
: The end position of the ORF in genomic coordinats, here defined as the last nucleotide before the STOP codon (meaning the stop codon is not included in these coordinates).
stopDistanceToLastJunction
: Distance from stop codon to the last exon-exon junction
stopIndex
: The index, counting from the last exon (which is 0), of which exon is the stop codon is in.
PTC
: A logic indicating whether the isoform is classified as having a Premature Termination Codon. This is defined as having a stop codon more than PTCDistance
(default is 50) nt upstream of the last exon exon junciton.
NA means no information was advailable aka no ORF (passing the minORFlength
filter) was found.
Kristoffer Vitting-Seerup
This function
: Vitting-Seerup et al. The Landscape of Isoform Switches in Human Cancers. Mol. Cancer Res. (2017).
Information about NMD
: Weischenfeldt J, et al: Mammalian tissues defective in nonsense-mediated mRNA decay display highly aberrant splicing patterns. Genome Biol. 2012, 13:R35.
createSwitchAnalyzeRlist
preFilter
isoformSwitchTestDEXSeq
isoformSwitchTestDRIMSeq
extractSequence
analyzeCPAT
### Prepare for orf analysis # Load example data and prefilter data("exampleSwitchList") exampleSwitchList <- preFilter(exampleSwitchList) # Perfom test exampleSwitchListAnalyzed <- isoformSwitchTestDEXSeq(exampleSwitchList, dIFcutoff = 0.3) # high dIF cutoff for fast runtime ### analyzeORF library(BSgenome.Hsapiens.UCSC.hg19) exampleSwitchListAnalyzed <- analyzeORF(exampleSwitchListAnalyzed, genomeObject = Hsapiens) ### Explore result head(exampleSwitchListAnalyzed$orfAnalysis) head(exampleSwitchListAnalyzed$isoformFeatures) # PTC collumn added