Last data update: 2014.03.03

R: Generate GTF files for transcript visualization in genome...
generateGTFR Documentation

Generate GTF files for transcript visualization in genome browsers

Description

Generate GTF files for transcript visualization in genome browsers.

Usage

generateGTF(transcriptData, filters=NULL, expressionCutoff=0,scoreMethod="local", filePrefix="spliceR_transcripts", shortDescription="SpliceR Transcripts", longDescription="Transcripts generated by SpliceR", useProgressBar=T)

Arguments

transcriptData

A SpliceRList object, created manually from transcript and exon information, or procuced by prepareCuff from CuffLinks data, and optionally processed by spliceR and/or annotatePTC.

filters

Vector, giving the filters that should be applied - any combinations of 'geneOK', 'expressedGenes', 'sigGenes', 'isoOK', 'expressedIso', 'isoClass' and/or 'sigIso'. Works only for data from cufflinks.

expressionCutoff

Numeric, giving the expression threshold (often in FPKM) used for the 'expressedGenes' and 'expressedIso' filter. Default value is 0.

scoreMethod

Character, either of 'local" of 'global', indicating whether to score isoform expression values for GTF color coding based on expression of the isoform in relation to the sample (global) or the gene (local).

filePrefix

Output file name prefix, including path.

shortDescription

A short description for the GTF track.

longDescription

A long description for the GTF track.

useProgressBar

Boolean, indicating whether to use progressbars. For compatibility. Default = TRUE.

Details

generateGTF generates GTF files, one for each sample/condition type, and writes these to disk in the current working directory. If the data was generated using cufflinks and the "source_id" slot of the transcriptData is set to "cufflinks", a number of filters can be applied (see spliceR for a full description of filters). Transcripts will be colored on a grayscale according to the scoreMethod parameter; for "local", the isoform most expressed for a given gene symbol will be darkest; for "global", the color coding will be relative to each transcripts expression across the sample.

Author(s)

Kristoffer Vitting-Seerup, Johannes Waage

References

Vitting-Seerup K, Porse BT, Sandelin A, Waage JE. (2013) spliceR: An R package for classification of alternative splicing and prediction of coding potential from RNA-seq data. PeerJ PrePrints 1:e80v1

Examples

#Load cufflinks example data
cuffDB <- prepareCuffExample()

#Generate SpliceRList from cufflinks data
cuffDB_spliceR <- prepareCuff(cuffDB)

#Reduce dataset size for fast example runtime
cuffDB_spliceR[[1]] <- cuffDB_spliceR[[1]][1:500]

#Run spliceR
mySpliceRList <- spliceR(cuffDB_spliceR, compareTo='preTranscript', filters=c('expressedGenes','geneOK', 'isoOK', 'expressedIso', 'isoClass'))

#Export to GTF
generateGTF(mySpliceRList, filters=c("geneOK", "isoOK", "expressedGenes", "expressedIso"), scoreMethod="local")

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(spliceR)
Loading required package: cummeRbund
Loading required package: BiocGenerics
Loading required package: parallel

Attaching package: 'BiocGenerics'

The following objects are masked from 'package:parallel':

    clusterApply, clusterApplyLB, clusterCall, clusterEvalQ,
    clusterExport, clusterMap, parApply, parCapply, parLapply,
    parLapplyLB, parRapply, parSapply, parSapplyLB

The following objects are masked from 'package:stats':

    IQR, mad, xtabs

The following objects are masked from 'package:base':

    Filter, Find, Map, Position, Reduce, anyDuplicated, append,
    as.data.frame, cbind, colnames, do.call, duplicated, eval, evalq,
    get, grep, grepl, intersect, is.unsorted, lapply, lengths, mapply,
    match, mget, order, paste, pmax, pmax.int, pmin, pmin.int, rank,
    rbind, rownames, sapply, setdiff, sort, table, tapply, union,
    unique, unsplit

Loading required package: RSQLite
Loading required package: DBI
Loading required package: ggplot2
Loading required package: reshape2
Loading required package: fastcluster

Attaching package: 'fastcluster'

The following object is masked from 'package:stats':

    hclust

Loading required package: rtracklayer
Loading required package: GenomicRanges
Loading required package: S4Vectors
Loading required package: stats4

Attaching package: 'S4Vectors'

The following objects are masked from 'package:base':

    colMeans, colSums, expand.grid, rowMeans, rowSums

Loading required package: IRanges
Loading required package: GenomeInfoDb
Loading required package: Gviz
Loading required package: grid

Attaching package: 'cummeRbund'

The following object is masked from 'package:GenomicRanges':

    promoters

The following object is masked from 'package:IRanges':

    promoters

The following object is masked from 'package:BiocGenerics':

    conditions

Loading required package: VennDiagram
Loading required package: futile.logger
Loading required package: RColorBrewer
Loading required package: plyr

Attaching package: 'plyr'

The following object is masked from 'package:cummeRbund':

    count

The following object is masked from 'package:IRanges':

    desc

The following object is masked from 'package:S4Vectors':

    rename


Attaching package: 'spliceR'

The following object is masked from 'package:cummeRbund':

    conditions

The following object is masked from 'package:BiocGenerics':

    conditions

> png(filename="/home/ddbj/snapshot/RGM3/R_BC/result/spliceR/generateGTF.Rd_%03d_medium.png", width=480, height=480)
> ### Name: generateGTF
> ### Title: Generate GTF files for transcript visualization in genome
> ###   browsers
> ### Aliases: generateGTF
> 
> ### ** Examples
> 
> #Load cufflinks example data
> cuffDB <- prepareCuffExample()
Creating database /tmp/RtmpKnDwAT/cuffData.db
Reading Run Info File /tmp/RtmpKnDwAT/run.info
Writing runInfo Table
Reading Read Group Info  /tmp/RtmpKnDwAT/read_groups.info
Writing replicates Table
Reading GTF file
Writing GTF features to 'features' table...
Reading /tmp/RtmpKnDwAT/genes.fpkm_tracking
Checking samples table...
Populating samples table...
Writing genes table
Reshaping geneData table
Recasting
Writing geneData table
Reading /tmp/RtmpKnDwAT/gene_exp.diff
Writing geneExpDiffData table
Reading /tmp/RtmpKnDwAT/promoters.diff
Writing promoterDiffData table
Reading /tmp/RtmpKnDwAT/genes.count_tracking
Reshaping geneCount table
Recasting
Writing geneCount table
Reading read group info in /tmp/RtmpKnDwAT/genes.read_group_tracking
Writing geneReplicateData table
Reading /tmp/RtmpKnDwAT/isoforms.fpkm_tracking
Checking samples table...
OK!
Writing isoforms table
Reshaping isoformData table
Recasting
Writing isoformData table
Reading /tmp/RtmpKnDwAT/isoform_exp.diff
Writing isoformExpDiffData table
Reading /tmp/RtmpKnDwAT/isoforms.count_tracking
Reshaping isoformCount table
Recasting
Writing isoformCount table
Reading read group info in /tmp/RtmpKnDwAT/isoforms.read_group_tracking
Writing isoformReplicateData table
Reading /tmp/RtmpKnDwAT/tss_groups.fpkm_tracking
Checking samples table...
OK!
Writing TSS table
Reshaping TSSData table
Recasting
Writing TSSData table
Reading /tmp/RtmpKnDwAT/tss_group_exp.diff
Writing TSSExpDiffData table
Reading /tmp/RtmpKnDwAT/splicing.diff
Writing splicingDiffData table
Reading /tmp/RtmpKnDwAT/tss_groups.count_tracking
Reshaping TSSCount table
Recasting
Writing TSSCount table
Reading read group info in /tmp/RtmpKnDwAT/tss_groups.read_group_tracking
Writing TSSReplicateData table
Reading /tmp/RtmpKnDwAT/cds.fpkm_tracking
Checking samples table...
OK!
Writing CDS table
Reshaping CDSData table
Recasting
Writing CDSData table
Reading /tmp/RtmpKnDwAT/cds_exp.diff
Writing CDSExpDiffData table
Reading /tmp/RtmpKnDwAT/cds.diff
Writing CDSDiffData table
Reading /tmp/RtmpKnDwAT/cds.count_tracking
Reshaping CDSCount table
Recasting
Writing CDSCount table
Reading read group info in /tmp/RtmpKnDwAT/cds.read_group_tracking
Writing CDSReplicateData table
Indexing Tables...
Warning messages:
1: attributes are not identical across measure variables; they will be dropped 
2: attributes are not identical across measure variables; they will be dropped 
3: attributes are not identical across measure variables; they will be dropped 
4: attributes are not identical across measure variables; they will be dropped 
5: attributes are not identical across measure variables; they will be dropped 
6: attributes are not identical across measure variables; they will be dropped 
7: attributes are not identical across measure variables; they will be dropped 
8: attributes are not identical across measure variables; they will be dropped 
> 
> #Generate SpliceRList from cufflinks data
> cuffDB_spliceR <- prepareCuff(cuffDB)
Reading cuffDB, isoforms...
Reading cuffDB, exons...
Analyzing cufflinks annotation problem...
Fixing cufflinks annotation problem...
Cufflinks annotation problem was fixed for 65 Cuff_genes
Creating spliceRList...
> 
> #Reduce dataset size for fast example runtime
> cuffDB_spliceR[[1]] <- cuffDB_spliceR[[1]][1:500]
> 
> #Run spliceR
> mySpliceRList <- spliceR(cuffDB_spliceR, compareTo='preTranscript', filters=c('expressedGenes','geneOK', 'isoOK', 'expressedIso', 'isoClass'))
Preparing transcript data...
Converting to internal objects...
167 isoforms pre-filtering...
Filtering...
78 isoforms post-filtering...
Preparing exons...
Analyzing transcripts...
   |                                                                               |                                                                      |   0%   |                                                                               |===                                                                   |   4%   |                                                                               |======                                                                |   9%   |                                                                               |=========                                                             |  13%   |                                                                               |============                                                          |  17%   |                                                                               |===============                                                       |  22%   |                                                                               |==================                                                    |  26%   |                                                                               |=====================                                                 |  30%   |                                                                               |========================                                              |  35%   |                                                                               |===========================                                           |  39%   |                                                                               |==============================                                        |  43%   |                                                                               |=================================                                     |  48%   |                                                                               |=====================================                                 |  52%   |                                                                               |========================================                              |  57%   |                                                                               |===========================================                           |  61%   |                                                                               |==============================================                        |  65%   |                                                                               |=================================================                     |  70%   |                                                                               |====================================================                  |  74%   |                                                                               |=======================================================               |  78%   |                                                                               |==========================================================            |  83%   |                                                                               |=============================================================         |  87%   |                                                                               |================================================================      |  91%   |                                                                               |===================================================================   |  96%   |                                                                               |======================================================================| 100%
Preparing output...
Done in 1.5 secs
> 
> #Export to GTF
> generateGTF(mySpliceRList, filters=c("geneOK", "isoOK", "expressedGenes", "expressedIso"), scoreMethod="local")
Preparing transcript data...
167 isoforms pre-filtering...
Converting to internal objects...
Filtering...
105 isoforms post-filtering...
Generating GTFs...
   |                                                                               |                                                                      |   0%   |                                                                               |=                                                                     |   1%   |                                                                               |=                                                                     |   2%   |                                                                               |==                                                                    |   3%   |                                                                               |===                                                                   |   4%   |                                                                               |===                                                                   |   5%   |                                                                               |====                                                                  |   6%   |                                                                               |=====                                                                 |   7%   |                                                                               |=====                                                                 |   8%   |                                                                               |======                                                                |   9%   |                                                                               |=======                                                               |  10%   |                                                                               |=======                                                               |  11%   |                                                                               |========                                                              |  12%   |                                                                               |=========                                                             |  12%   |                                                                               |=========                                                             |  13%   |                                                                               |==========                                                            |  14%   |                                                                               |===========                                                           |  15%   |                                                                               |===========                                                           |  16%   |                                                                               |============                                                          |  17%   |                                                                               |=============                                                         |  18%   |                                                                               |=============                                                         |  19%   |                                                                               |==============                                                        |  20%   |                                                                               |===============                                                       |  21%   |                                                                               |===============                                                       |  22%   |                                                                               |================                                                      |  23%   |                                                                               |=================                                                     |  24%   |                                                                               |==================                                                    |  25%   |                                                                               |==================                                                    |  26%   |                                                                               |===================                                                   |  27%   |                                                                               |====================                                                  |  28%   |                                                                               |====================                                                  |  29%   |                                                                               |=====================                                                 |  30%   |                                                                               |======================                                                |  31%   |                                                                               |======================                                                |  32%   |                                                                               |=======================                                               |  33%   |                                                                               |========================                                              |  34%   |                                                                               |========================                                              |  35%   |                                                                               |=========================                                             |  36%   |                                                                               |==========================                                            |  37%   |                                                                               |==========================                                            |  38%   |                                                                               |===========================                                           |  38%   |                                                                               |============================                                          |  39%   |                                                                               |============================                                          |  40%   |                                                                               |=============================                                         |  41%   |                                                                               |==============================                                        |  42%   |                                                                               |==============================                                        |  43%   |                                                                               |===============================                                       |  44%   |                                                                               |================================                                      |  45%   |                                                                               |================================                                      |  46%   |                                                                               |=================================                                     |  47%   |                                                                               |==================================                                    |  48%   |                                                                               |==================================                                    |  49%   |                                                                               |===================================                                   |  50%   |                                                                               |====================================                                  |  51%   |                                                                               |====================================                                  |  52%   |                                                                               |=====================================                                 |  53%   |                                                                               |======================================                                |  54%   |                                                                               |======================================                                |  55%   |                                                                               |=======================================                               |  56%   |                                                                               |========================================                              |  57%   |                                                                               |========================================                              |  58%   |                                                                               |=========================================                             |  59%   |                                                                               |==========================================                            |  60%   |                                                                               |==========================================                            |  61%   |                                                                               |===========================================                           |  62%   |                                                                               |============================================                          |  62%   |                                                                               |============================================                          |  63%   |                                                                               |=============================================                         |  64%   |                                                                               |==============================================                        |  65%   |                                                                               |==============================================                        |  66%   |                                                                               |===============================================                       |  67%   |                                                                               |================================================                      |  68%   |                                                                               |================================================                      |  69%   |                                                                               |=================================================                     |  70%   |                                                                               |==================================================                    |  71%   |                                                                               |==================================================                    |  72%   |                                                                               |===================================================                   |  73%   |                                                                               |====================================================                  |  74%   |                                                                               |====================================================                  |  75%   |                                                                               |=====================================================                 |  76%   |                                                                               |======================================================                |  77%   |                                                                               |=======================================================               |  78%   |                                                                               |=======================================================               |  79%   |                                                                               |========================================================              |  80%   |                                                                               |=========================================================             |  81%   |                                                                               |=========================================================             |  82%   |                                                                               |==========================================================            |  83%   |                                                                               |===========================================================           |  84%   |                                                                               |===========================================================           |  85%   |                                                                               |============================================================          |  86%   |                                                                               |=============================================================         |  87%   |                                                                               |=============================================================         |  88%   |                                                                               |==============================================================        |  88%   |                                                                               |===============================================================       |  89%   |                                                                               |===============================================================       |  90%   |                                                                               |================================================================      |  91%   |                                                                               |=================================================================     |  92%   |                                                                               |=================================================================     |  93%   |                                                                               |==================================================================    |  94%   |                                                                               |===================================================================   |  95%   |                                                                               |===================================================================   |  96%   |                                                                               |====================================================================  |  97%   |                                                                               |===================================================================== |  98%   |                                                                               |===================================================================== |  99%   |                                                                               |======================================================================| 100%
Writing GTFs...
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>