annotate fasta_clipping_histogram.xml @ 3:d0969fa24eb1 draft

planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
author devteam
date Tue, 13 Oct 2015 12:38:50 -0400
parents de44f4045b05
children 40ec4170291e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
de44f4045b05 Uploaded valid tool xml
devteam
parents: 0
diff changeset
1 <tool id="cshl_fasta_clipping_histogram" name="Length Distribution" version="1.0.0">
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
2 <description>chart</description>
0
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
3 <requirements>
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
4 <requirement type="package" version="0.0.13">fastx_toolkit</requirement>
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
5 </requirements>
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
6 <command>fasta_clipping_histogram.pl $input $outfile</command>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
7
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
8 <inputs>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
9 <param format="fasta" name="input" type="data" label="Library to analyze" />
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
10 </inputs>
0
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
11
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
12 <outputs>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
13 <data format="png" name="outfile" metadata_source="input" />
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
14 </outputs>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
15 <tests>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
16 </tests>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
17 <help>
0
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
18 **What it does**
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
19
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
20 This tool creates a histogram image of sequence lengths distribution in a given fasta dataset file.
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
21
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
22 **TIP:** Use this tool after clipping your library (with **FASTX Clipper tool**), to visualize the clipping results.
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
23
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
24 -----
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
25
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
26 **Output Examples**
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
27
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
28 In the following library, most sequences are 24-mers to 27-mers.
0
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
29 This could indicate an abundance of endo-siRNAs (depending of course of what you've tried to sequence in the first place).
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
30
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
31 .. image:: ${static_path}/fastx_icons/fasta_clipping_histogram_1.png
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
32
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
33 In the following library, most sequences are 19,22 or 23-mers.
0
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
34 This could indicate an abundance of miRNAs (depending of course of what you've tried to sequence in the first place).
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
35
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
36 .. image:: ${static_path}/fastx_icons/fasta_clipping_histogram_2.png
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
37
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
38 -----
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
39
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
40 **Input Formats**
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
41
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
42 This tool accepts short-reads FASTA files. The reads don't have to be short, but they do have to be on a single line, like so::
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
43
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
44 >sequence1
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
45 AGTAGTAGGTGATGTAGAGAGAGAGAGAGTAG
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
46 >sequence2
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
47 GTGTGTGTGGGAAGTTGACACAGTA
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
48 >sequence3
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
49 CCTTGAGATTAACGCTAATCAAGTAAAC
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
50
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
51 If the sequences span over multiple lines::
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
52
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
53 >sequence1
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
54 CAGCATCTACATAATATGATCGCTATTAAACTTAAATCTCCTTGACGGAG
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
55 TCTTCGGTCATAACACAAACCCAGACCTACGTATATGACAAAGCTAATAG
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
56 aactggtctttacctTTAAGTTG
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
57
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
58 Use the **FASTA Width Formatter** tool to re-format the FASTA into a single-lined sequences::
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
59
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
60 >sequence1
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
61 CAGCATCTACATAATATGATCGCTATTAAACTTAAATCTCCTTGACGGAGTCTTCGGTCATAACACAAACCCAGACCTACGTATATGACAAAGCTAATAGaactggtctttacctTTAAGTTG
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
62
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
63 -----
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
64
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
65 **Multiplicity counts (a.k.a reads-count)**
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
66
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
67 If the sequence identifier (the text after the '>') contains a dash and a number, it is treated as a multiplicity count value (i.e. how many times that individual sequence repeated in the original FASTA file, before collapsing).
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
68
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
69 Example 1 - The following FASTA file *does not* have multiplicity counts::
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
70
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
71 >seq1
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
72 GGATCC
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
73 >seq2
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
74 GGTCATGGGTTTAAA
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
75 >seq3
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
76 GGGATATATCCCCACACACACACAC
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
77
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
78 Each sequence is counts as one, to produce the following chart:
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
79
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
80 .. image:: ${static_path}/fastx_icons/fasta_clipping_histogram_3.png
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
81
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
82 Example 2 - The following FASTA file have multiplicity counts::
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
83
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
84 >seq1-2
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
85 GGATCC
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
86 >seq2-10
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
87 GGTCATGGGTTTAAA
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
88 >seq3-3
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
89 GGGATATATCCCCACACACACACAC
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
90
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
91 The first sequence counts as 2, the second as 10, the third as 3, to produce the following chart:
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
92
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
93 .. image:: ${static_path}/fastx_icons/fasta_clipping_histogram_4.png
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
94
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
95 Use the **FASTA Collapser** tool to create FASTA files with multiplicity counts.
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
96
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
97 ------
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
98
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
99 This tool is based on `FASTX-toolkit`__ by Assaf Gordon.
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
100
82e8c467e2ec Uploaded
devteam
parents:
diff changeset
101 .. __: http://hannonlab.cshl.edu/fastx_toolkit/
3
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
102 </help>
d0969fa24eb1 planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
103 </tool>