annotate README.txt @ 7:77114c36b8ab draft default tip

planemo upload
author marpiech
date Mon, 29 Aug 2016 07:28:10 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
1 Convert a BAM file into a BigWig coverage file. This can be used directly from
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
2 Galaxy for display at UCSC. The advantage over standard Wiggle format is that
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
3 the data is stored in a compressed format and can be retrieved by genome
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
4 region. This allows you to view regions of arbitrarily large Wiggle file data
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
5 at UCSC while avoiding the upload costs.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
6
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
7 History
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
8 -------
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
9
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
10 v0.2.0 add a sort step after genomeCoverageBed which is required in some
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
11 instances otherwise bedGraphToBigWig will complain. This version also uses
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
12 Galaxy's dependency mechanism, added some tests, and updated some formatting.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
13 By Lance Parsons.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
14
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
15 v0.1.1 passes the forgotten split argument and moves to using the new
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
16 sub-command enabled bedtools. Thanks to David Leader.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
17
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
18 As of v0.1.0, the Galaxy tools uses a revised bam_to_bigwig.py script using
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
19 genomeCoverageBed and bedGraphToBigWig - this approach allows gaps/skpis to
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
20 be excluded from the coverage calculation, which is important for RNA-Seq.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
21
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
22 Until v0.0.2, this Galaxy tool used the bam_to_wiggle.py script from
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
23 https://github.com/chapmanb/bcbb/blob/master/nextgen/scripts/bam_to_wiggle.py
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
24 which internally used pysam (and thus samtools) and wigToBigWig from UCSC.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
25
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
26 Requirements
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
27 ------------
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
28
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
29 If you are installing this tool manually, place the Python script in the
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
30 same directory as the XML configuration file, or provide a soft link to it.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
31 Ensure the following command line tools are on the system path:
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
32
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
33 pysam - Python interface to samtools (http://code.google.com/p/pysam/)
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
34 genomeCoverageBed - part of BedTools (http://code.google.com/p/bedtools/)
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
35 bedGraphToBigWig - from UCSC (http://hgdownload.cse.ucsc.edu/admin/exe/)
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
36
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
37 Credits
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
38 -------
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
39
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
40 Original script by Brad Chapman, revisions from Peter Cock including the
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
41 switch to using genomeCoverageBed and bedGraphToBigWig based on the work
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
42 of Lance Parsons.
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
43
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
44 License
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
45 ------
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
46
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
47 The code is freely available under the MIT license:
77114c36b8ab planemo upload
marpiech
parents:
diff changeset
48 http://www.opensource.org/licenses/mit-license.html