Herve, The help is correct (though possibly a bit pedantic), there is no method for that signature.
?import("", "") works for me though ~G On Thu, Feb 20, 2014 at 4:51 PM, Hervé Pagès <hpa...@fhcrc.org> wrote: > On 02/20/2014 04:16 PM, Michael Lawrence wrote: > >> There's also "?coverage(ga)", so the user can see what happens >> specifically for their object, without worrying about typing out the >> class. >> > > I was never lucky with this: > > > library(rtracklayer) > > path_to_gff <- system.file("tests", "v1.gff", package = "rtracklayer") > > ?import(path_to_gff) > Error in .helpForCall(topicExpr, parent.frame()) : > no documentation for function 'import' and signature 'con = > "character", format = "ANY", text = "ANY"' > In addition: Warning message: > In .helpForCall(topicExpr, parent.frame()) : > no method defined for function 'import' and signature 'con = > "character", format = "ANY", text = "ANY"' > > H. > > >> At some point it would be neat to generate S4 documentation at run-time. >> Just popup a browser and see every method that might be dispatched with >> a given object. In theory, the R help server would support this. >> >> >> On Thu, Feb 20, 2014 at 3:13 PM, Hervé Pagès <hpa...@fhcrc.org >> <mailto:hpa...@fhcrc.org>> wrote: >> >> >> >> On 02/20/2014 02:55 PM, Martin Morgan wrote: >> >> On 02/20/2014 02:32 PM, Hervé Pagès wrote: >> >> Hi Jesper, >> >> On 02/20/2014 02:13 PM, Jesper Gådin wrote: >> >> Very true that it is quite difficult to find the >> documentation when one >> is not aware of its existence :P >> >> >> Yeah, this has been a source of frustration for many people. >> And >> always a source of embarrassment (for us) when teaching our >> software >> to beginners. >> >> I've started to change this. In the upcoming version of BioC >> (2.14, >> scheduled for mid-April), when you'll do ?coverage, you'll >> get to >> choose between the 3 man pages that document coverage >> methods (there >> is one in IRanges, one in GenomicRanges, and one in >> GenomicAlignments). >> >> I want to generalize this to other generics that have >> methods spread >> across several packages (e.g. findOverlaps, the intra- and >> inter-range >> methods, etc...). >> >> Having to choose between several man pages every time you do >> e.g. >> ?findOverlaps is a minor annoyance compared to not being able >> to >> find the man page at all. (Note that if you already know >> where is >> your favorite man page, you'll be able to direct access it >> with >> e.g. ?GenomicRanges::findOverlaps). Nobody will ever need to >> use >> the insane >> ?`findOverlaps,GenomicRanges,__GenomicRanges-method` to >> >> >> >> tab completion helps, so that you don't need to be totally >> insane, just >> insane enough to know to start with >> >> ?"cover<tab> >> >> >> and also insane enough to know which method you need to pick up >> amongst >> the 30+ methods listed by ?"findOverlaps<tab> >> Overwhelming! >> >> H. >> >> >> >> Martin >> >> open that man page again. Ever! (it will still work though...) >> >> Cheers, >> H. >> >> >> coverage() is fast and beautiful. Thanks! >> >> /Jesper >> >> >> On Wed, Feb 19, 2014 at 9:21 PM, Hervé Pagès >> <hpa...@fhcrc.org <mailto:hpa...@fhcrc.org> >> <mailto:hpa...@fhcrc.org <mailto:hpa...@fhcrc.org>>> >> wrote: >> >> Hi Jesper, >> >> >> On 02/19/2014 08:44 AM, Michael Lawrence wrote: >> >> On Wed, Feb 19, 2014 at 8:39 AM, Jesper Gådin >> <jesper.ga...@gmail.com >> <mailto:jesper.ga...@gmail.com> >> <mailto:jesper.ga...@gmail.com >> <mailto:jesper.ga...@gmail.com>__>>wrote: >> >> >> Hi Michael, >> >> Herves suggestion will probably work for my >> use case, but if >> there are any >> smoother ways it would be preferable. >> >> The use case is as follows: >> >> 1) calculate strand specific coverage over >> a region from >> GAlignments object (or file) >> >> At the moment I read a file using >> readGAlignmentsFromBam() >> with tag="XS", >> then filter it on "flag" and "mapq". Then I >> subset the >> resulting GAlignments in a minus and a plus >> -strand object. >> Then I calculate coverage by my own >> coverage function which >> uses the cigar >> information in the GAlignments object. This >> function is the >> one using >> cigarToRleList() at the moment. As I >> understand the >> coverage() function >> from the GenomicAlignments/IRanges package >> does not take >> into account >> cigars, or does it? >> >> >> It does take the coverage into account; >> specifically to exclude >> the introns >> from coverage. I think there's also an option >> to exclude >> deletions. >> >> >> Unfortunately the man page is not easy to access >> (you need to do >> ?`coverage,GAlignments-method`____), but it says: >> >> The methods for GAlignments and GAlignmentPairs >> objects do: >> >> coverage(grglist(x), ...) >> >> And if you do grglist() on a GAlignments or >> GAlignmentPairs >> objects, the >> ranges you get in the returned GRangesList object >> are calculated >> based >> on the CIGAR. >> >> Trust but verify. Here is how you can actually >> verify that >> coverage() >> does take the CIGAR into account: >> >> library(RNAseqData.HNRNPC.bam.____chr14) >> gal <- >> readGAlignments(RNAseqData.___ >> _HNRNPC.bam.chr14_BAMFILES[1]) >> >> cig_op_table <- cigarOpTable(cigar(gal)) >> >> First we pick up an alignment with an N in its >> CIGAR and do >> coverage() >> on it: >> >> > gal_with_N <- gal[which(cig_op_table[ , "N"] >> != 0)[1]] >> >> > gal_with_N >> GAlignments with 1 alignment and 0 metadata >> columns: >> seqnames strand cigar qwidth >> start end >> width >> <Rle> <Rle> <character> <integer> >> <integer> <integer> >> <integer> >> [1] chr14 + 55M2117N17M 72 >> 19650072 19652260 >> 2189 >> ngap >> <integer> >> [1] 1 >> --- >> seqlengths: >> chr1 chr10 ... >> chrY >> 249250621 135534747 ... >> 59373566 >> >> > coverage(gal_with_N)$chr14 >> integer-Rle of length 107349540 with 5 runs >> Lengths: 19650071 55 2117 17 >> 87697280 >> Values : 0 1 0 1 >> 0 >> >> Same thing with an alignment with an I in its CIGAR: >> >> > gal_with_I <- gal[which(cig_op_table[ , "I"] >> != 0)[1]] >> >> > gal_with_I >> GAlignments with 1 alignment and 0 metadata >> columns: >> seqnames strand cigar qwidth >> start end >> width >> <Rle> <Rle> <character> <integer> >> <integer> <integer> >> <integer> >> [1] chr14 - 64M1I7M 72 >> 19411677 19411747 >> 71 >> ngap >> <integer> >> [1] 0 >> --- >> seqlengths: >> chr1 chr10 ... >> chrY >> 249250621 135534747 ... >> 59373566 >> >> > coverage(gal_with_I)$chr14 >> integer-Rle of length 107349540 with 3 runs >> Lengths: 19411676 71 87937793 >> <tel:71%2087937793> >> Values : 0 1 0 >> >> Same thing with an alignment with a D in its CIGAR: >> >> > gal_with_D <- gal[which(cig_op_table[ , "D"] >> != 0)[1]] >> >> > gal_with_D >> GAlignments with 1 alignment and 0 metadata >> columns: >> seqnames strand cigar qwidth >> start end >> width >> <Rle> <Rle> <character> <integer> >> <integer> <integer> >> <integer> >> [1] chr14 + 38M1D34M 72 >> 19659063 19659135 >> 73 >> ngap >> <integer> >> [1] 0 >> --- >> seqlengths: >> chr1 chr10 ... >> chrY >> 249250621 135534747 ... >> 59373566 >> >> > coverage(gal_with_D)$chr14 >> integer-Rle of length 107349540 with 3 runs >> Lengths: 19659062 73 87690405 >> Values : 0 1 0 >> >> Seeing is believing, >> >> Cheers, >> H. >> >> >> >> I started to look at the applyPileups() in >> Rsamtools which I >> can get to >> calculate coverage using cigars, but not >> using the strand or >> flag >> information for filtering. That solution >> would start from a >> bam-file >> instead of a GAlignments object, and sure I >> can do the >> filtering outside R. >> But it would be very convenient to do it >> all from within R. >> >> If there are nice solutions starting from >> both a GAlignments >> and a >> bam-file it would be great! =) >> >> /Jesper >> >> >> >> On Tue, Feb 18, 2014 at 10:52 PM, Michael >> Lawrence < >> lawrence.mich...@gene.com <mailto:lawrence.michael@gene. >> com> >> <mailto:lawrence.michael@gene.__com >> >> <mailto:lawrence.mich...@gene.com>>> wrote: >> >> Hi Jesper, >> >> Would you be willing to volunteer your >> use case? As >> Herve hinted, >> cigarToRleList and friends are >> low-level helpers. There >> may be an easier >> way to achieve what you want, or an >> opportunity to >> improve things. >> >> Michael >> >> >> On Mon, Feb 17, 2014 at 1:10 AM, Jesper >> Gådin >> <jesper.ga...@gmail.com >> <mailto:jesper.ga...@gmail.com> >> <mailto:jesper.ga...@gmail.com >> <mailto:jesper.ga...@gmail.com>__>>wrote: >> >> >> Hi, >> >> Have come across a cigar-vector >> that is problematic >> to process. >> >> #load package >> >> library(GenomicAlignments) >> >> >> #load data (see attached file) >> >> >> load("2014-02-17-cigarExample.____rdata") >> >> >> >> #run function cigarToRleList >> >> cigarRle <- >> cigarToRleList(cigarExample) >> >> Error in .Call2("Rle_constructor", >> values, lengths, >> check, 0L, PACKAGE = >> "IRanges") : >> integer overflow while summing >> elements in >> 'lengths' >> >> sessionInfo() >> >> R Under development (unstable) >> (2013-11-13 r64209) >> Platform: x86_64-unknown-linux-gnu >> (64-bit) >> >> locale: >> [1] LC_CTYPE=en_US.UTF-8 >> LC_NUMERIC=C >> [3] LC_TIME=en_US.UTF-8 >> LC_COLLATE=en_US.UTF-8 >> [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 >> >> attached base packages: >> [1] parallel stats graphics >> grDevices utils >> datasets methods >> [8] base >> >> other attached packages: >> [1] GenomicAlignments_0.99.18 >> Rsamtools_1.15.26 >> [3] Biostrings_2.31.12 >> XVector_0.3.6 >> [5] GenomicRanges_1.15.26 >> IRanges_1.21.23 >> [7] BiocGenerics_0.9.3 >> >> loaded via a namespace (and not >> attached): >> [1] BatchJobs_1.1-1135 BBmisc_1.5 >> BiocParallel_0.5.8 >> bitops_1.0-6 >> >> [5] brew_1.0-6 >> codetools_0.2-8 >> DBI_0.2-7 >> digest_0.6.4 >> >> [9] fail_1.2 >> foreach_1.4.1 >> iterators_1.0.6 plyr_1.8 >> >> [13] RSQLite_0.11.4 >> sendmailR_1.1-2 >> stats4_3.1.0 tools_3.1.0 >> >> [17] zlibbioc_1.9.0 >> >> >> ___________________________________________________ >> Bioc-devel@r-project.org <mailto:Bioc-devel@r-project.org >> > >> <mailto:Bioc-devel@r-project.__org >> <mailto:Bioc-devel@r-project.org>> mailing list >> https://stat.ethz.ch/mailman/____listinfo/bioc-devel >> <https://stat.ethz.ch/mailman/__listinfo/bioc-devel> >> >> >> <https://stat.ethz.ch/mailman/__listinfo/bioc-devel >> <https://stat.ethz.ch/mailman/listinfo/bioc-devel>> >> >> >> >> >> >> [[alternative HTML version deleted]] >> >> >> >> >> ______________________________ >> _____________________ >> Bioc-devel@r-project.org >> <mailto:Bioc-devel@r-project.org> >> <mailto:Bioc-devel@r-project.__org >> <mailto:Bioc-devel@r-project.org>> >> mailing list >> https://stat.ethz.ch/mailman/____listinfo/bioc-devel >> <https://stat.ethz.ch/mailman/__listinfo/bioc-devel> >> >> >> <https://stat.ethz.ch/mailman/__listinfo/bioc-devel >> <https://stat.ethz.ch/mailman/listinfo/bioc-devel>> >> >> >> -- >> Hervé Pagès >> >> Program in Computational Biology >> Division of Public Health Sciences >> Fred Hutchinson Cancer Research Center >> 1100 Fairview Ave. N, M1-B514 >> P.O. Box 19024 >> Seattle, WA 98109-1024 >> >> E-mail: hpa...@fhcrc.org <mailto:hpa...@fhcrc.org> >> <mailto:hpa...@fhcrc.org <mailto:hpa...@fhcrc.org>> >> >> Phone: (206) 667-5791 <tel:%28206%29%20667-5791> >> <tel:%28206%29%20667-5791> >> Fax: (206) 667-1319 <tel:%28206%29%20667-1319> >> <tel:%28206%29%20667-1319> >> >> >> >> >> >> >> -- >> Hervé Pagès >> >> Program in Computational Biology >> Division of Public Health Sciences >> Fred Hutchinson Cancer Research Center >> 1100 Fairview Ave. N, M1-B514 >> P.O. Box 19024 >> Seattle, WA 98109-1024 >> >> E-mail: hpa...@fhcrc.org <mailto:hpa...@fhcrc.org> >> Phone: (206) 667-5791 <tel:%28206%29%20667-5791> >> Fax: (206) 667-1319 <tel:%28206%29%20667-1319> >> >> >> > -- > Hervé Pagès > > Program in Computational Biology > Division of Public Health Sciences > Fred Hutchinson Cancer Research Center > 1100 Fairview Ave. N, M1-B514 > P.O. Box 19024 > Seattle, WA 98109-1024 > > E-mail: hpa...@fhcrc.org > Phone: (206) 667-5791 > Fax: (206) 667-1319 > > _______________________________________________ > Bioc-devel@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/bioc-devel > -- Gabriel Becker Graduate Student Statistics Department University of California, Davis [[alternative HTML version deleted]]
_______________________________________________ Bioc-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/bioc-devel