annotate bamtools-split.xml @ 3:10dcc8027778 draft

planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
author devteam
date Mon, 09 Nov 2015 12:04:47 -0500
parents fc222996ce9b
children 64ed37303c15
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
1 <tool id="bamSplit" name="Split" version="0.0.2" force_history_refresh="True">
0
56a189070900 Uploaded
devteam
parents:
diff changeset
2 <description>BAM datasets on variety of attributes</description>
56a189070900 Uploaded
devteam
parents:
diff changeset
3 <requirements>
56a189070900 Uploaded
devteam
parents:
diff changeset
4 <requirement type="package" version="2.3.0_2d7685d2ae">bamtools</requirement>
56a189070900 Uploaded
devteam
parents:
diff changeset
5 </requirements>
56a189070900 Uploaded
devteam
parents:
diff changeset
6 <command>
56a189070900 Uploaded
devteam
parents:
diff changeset
7
56a189070900 Uploaded
devteam
parents:
diff changeset
8 echo "BAM" > $report &amp;&amp;
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
9
0
56a189070900 Uploaded
devteam
parents:
diff changeset
10 #for $bam_count, $input_bam in enumerate( $input_bams ):
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
11 ln -s "${input_bam}" "localbam_${bam_count}.bam" &amp;&amp;
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
12 ln -s "${input_bam.metadata.bam_index}" "localbam_${bam_count}.bam.bai" &amp;&amp;
0
56a189070900 Uploaded
devteam
parents:
diff changeset
13 #end for
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
14
0
56a189070900 Uploaded
devteam
parents:
diff changeset
15 bamtools
56a189070900 Uploaded
devteam
parents:
diff changeset
16 split
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
17
0
56a189070900 Uploaded
devteam
parents:
diff changeset
18 #if str ( $analysis_type.analysis_type_selector ) == "-tag" :
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
19
0
56a189070900 Uploaded
devteam
parents:
diff changeset
20 ${analysis_type.analysis_type_selector} "${analysis_type.tag_name}"
56a189070900 Uploaded
devteam
parents:
diff changeset
21
56a189070900 Uploaded
devteam
parents:
diff changeset
22 #else
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
23
0
56a189070900 Uploaded
devteam
parents:
diff changeset
24 ${analysis_type.analysis_type_selector}
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
25
0
56a189070900 Uploaded
devteam
parents:
diff changeset
26 #end if
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
27
0
56a189070900 Uploaded
devteam
parents:
diff changeset
28 -stub split_bam
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
29
0
56a189070900 Uploaded
devteam
parents:
diff changeset
30 #for $bam_count, $input_bam in enumerate( $input_bams ):
56a189070900 Uploaded
devteam
parents:
diff changeset
31 -in "localbam_${bam_count}.bam"
56a189070900 Uploaded
devteam
parents:
diff changeset
32 #end for
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
33
0
56a189070900 Uploaded
devteam
parents:
diff changeset
34 </command>
56a189070900 Uploaded
devteam
parents:
diff changeset
35
56a189070900 Uploaded
devteam
parents:
diff changeset
36 <inputs>
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
37 <param name="input_bams" type="data" format="bam" label="BAM dataset(s) to filter" min="1" multiple="True"/>
0
56a189070900 Uploaded
devteam
parents:
diff changeset
38 <conditional name="analysis_type">
56a189070900 Uploaded
devteam
parents:
diff changeset
39 <param name="analysis_type_selector" type="select" label="Split BAM dataset(s) by" help="See help below for explanation of each option">
56a189070900 Uploaded
devteam
parents:
diff changeset
40 <option value="-mapped">Mapping status (-mapped)</option>
56a189070900 Uploaded
devteam
parents:
diff changeset
41 <option value="-paired">Pairing status (-paired)</option>
56a189070900 Uploaded
devteam
parents:
diff changeset
42 <option value="-reference">Reference name (-reference)</option>
56a189070900 Uploaded
devteam
parents:
diff changeset
43 <option value="-tag">Specific tag (-tag)</option>
56a189070900 Uploaded
devteam
parents:
diff changeset
44 </param>
2
fc222996ce9b planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
45 <when value="-mapped" />
fc222996ce9b planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
46 <when value="-paired" />
fc222996ce9b planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 0
diff changeset
47 <when value="-reference" />
0
56a189070900 Uploaded
devteam
parents:
diff changeset
48 <when value="-tag">
56a189070900 Uploaded
devteam
parents:
diff changeset
49 <param name="tag_name" type="text" value="NM" label="Enter tag name here" help="For example, to split on NM tag enter &quot;NM&quot;"/>
56a189070900 Uploaded
devteam
parents:
diff changeset
50 </when>
56a189070900 Uploaded
devteam
parents:
diff changeset
51 </conditional>
56a189070900 Uploaded
devteam
parents:
diff changeset
52 </inputs>
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
53
0
56a189070900 Uploaded
devteam
parents:
diff changeset
54 <outputs>
56a189070900 Uploaded
devteam
parents:
diff changeset
55 <data format="txt" name="report" label="BAMSplitter Run" hidden="true">
56a189070900 Uploaded
devteam
parents:
diff changeset
56 <discover_datasets pattern="split_bam\.(?P&lt;designation&gt;.+)\.bam" ext="bam" visible="true"/>
56a189070900 Uploaded
devteam
parents:
diff changeset
57 </data>
56a189070900 Uploaded
devteam
parents:
diff changeset
58 </outputs>
56a189070900 Uploaded
devteam
parents:
diff changeset
59 <tests>
56a189070900 Uploaded
devteam
parents:
diff changeset
60 <test>
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
61 <param name="input_bams" ftype="bam" value="bamtools-input1.bam"/>
0
56a189070900 Uploaded
devteam
parents:
diff changeset
62 <param name="analysis_type_selector" value="-mapped"/>
56a189070900 Uploaded
devteam
parents:
diff changeset
63 <output name="report">
56a189070900 Uploaded
devteam
parents:
diff changeset
64 <assert_contents>
56a189070900 Uploaded
devteam
parents:
diff changeset
65 <has_line line="BAM" />
56a189070900 Uploaded
devteam
parents:
diff changeset
66 </assert_contents>
56a189070900 Uploaded
devteam
parents:
diff changeset
67 <discovered_dataset designation="MAPPED" file="bamtools-split-test1.bam" ftype="bam"/>
56a189070900 Uploaded
devteam
parents:
diff changeset
68 </output>
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
69
0
56a189070900 Uploaded
devteam
parents:
diff changeset
70 </test>
56a189070900 Uploaded
devteam
parents:
diff changeset
71 </tests>
56a189070900 Uploaded
devteam
parents:
diff changeset
72 <help>
56a189070900 Uploaded
devteam
parents:
diff changeset
73 **What is does**
56a189070900 Uploaded
devteam
parents:
diff changeset
74
56a189070900 Uploaded
devteam
parents:
diff changeset
75 BAMTools split is a utility for splitting BAM files. It is based on BAMtools suite of tools by Derek Barnett (https://github.com/pezmaster31/bamtools).
56a189070900 Uploaded
devteam
parents:
diff changeset
76
56a189070900 Uploaded
devteam
parents:
diff changeset
77 -----
56a189070900 Uploaded
devteam
parents:
diff changeset
78
56a189070900 Uploaded
devteam
parents:
diff changeset
79 .. class:: warningmark
56a189070900 Uploaded
devteam
parents:
diff changeset
80
56a189070900 Uploaded
devteam
parents:
diff changeset
81 **DANGER: Multiple Outputs**
56a189070900 Uploaded
devteam
parents:
diff changeset
82
56a189070900 Uploaded
devteam
parents:
diff changeset
83 As described below, splitting a BAM dataset(s) on reference name or a tag value can produce very large numbers of outputs. Read below and know what you are doing.
56a189070900 Uploaded
devteam
parents:
diff changeset
84
56a189070900 Uploaded
devteam
parents:
diff changeset
85 -----
56a189070900 Uploaded
devteam
parents:
diff changeset
86
56a189070900 Uploaded
devteam
parents:
diff changeset
87 **How it works**
56a189070900 Uploaded
devteam
parents:
diff changeset
88
56a189070900 Uploaded
devteam
parents:
diff changeset
89 The following options can be specified via "**Split BAM dataset(s) by**" dropdown::
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
90
0
56a189070900 Uploaded
devteam
parents:
diff changeset
91 Mapping status (-mapped) split mapped/unmapped and generate two output files
56a189070900 Uploaded
devteam
parents:
diff changeset
92 named (MAPPED) and (UNMAPPED) containing mapped and unmapped
56a189070900 Uploaded
devteam
parents:
diff changeset
93 reads, respectively.
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
94
0
56a189070900 Uploaded
devteam
parents:
diff changeset
95 Pairing status (-paired) split single-end/paired-end alignments and generate two output files
56a189070900 Uploaded
devteam
parents:
diff changeset
96 named (SINGLE_END) and (PAIRED_END) containing paired and unpaired
56a189070900 Uploaded
devteam
parents:
diff changeset
97 reads, respectively.
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
98
0
56a189070900 Uploaded
devteam
parents:
diff changeset
99 Reference name (-reference) split alignments by reference name. In cases of unfinished genomes with
56a189070900 Uploaded
devteam
parents:
diff changeset
100 very large number of reference sequences (scaffolds) it can generate
56a189070900 Uploaded
devteam
parents:
diff changeset
101 thousands (if not millions) of output datasets.
3
10dcc8027778 planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tool_collections/bamtools/bamtools_split commit 5a4e0ca9992af3a6e5ed2b533f04bb82ce761e0b
devteam
parents: 2
diff changeset
102
0
56a189070900 Uploaded
devteam
parents:
diff changeset
103 Specific tag (-tag) split alignments based on all values of TAG encountered. Choosing this
56a189070900 Uploaded
devteam
parents:
diff changeset
104 option from the menu will allow you to enter the tag name. As was the
56a189070900 Uploaded
devteam
parents:
diff changeset
105 case with the reference splitting above, this option can produce very
56a189070900 Uploaded
devteam
parents:
diff changeset
106 large number of outputs if a tag has a large number of unique values.
56a189070900 Uploaded
devteam
parents:
diff changeset
107
56a189070900 Uploaded
devteam
parents:
diff changeset
108 -----
56a189070900 Uploaded
devteam
parents:
diff changeset
109
56a189070900 Uploaded
devteam
parents:
diff changeset
110 .. class:: infomark
56a189070900 Uploaded
devteam
parents:
diff changeset
111
56a189070900 Uploaded
devteam
parents:
diff changeset
112 **More information**
56a189070900 Uploaded
devteam
parents:
diff changeset
113
56a189070900 Uploaded
devteam
parents:
diff changeset
114 Additional information about BAMtools can be found at https://github.com/pezmaster31/bamtools/wiki
56a189070900 Uploaded
devteam
parents:
diff changeset
115
56a189070900 Uploaded
devteam
parents:
diff changeset
116 </help>
56a189070900 Uploaded
devteam
parents:
diff changeset
117 <citations>
56a189070900 Uploaded
devteam
parents:
diff changeset
118 <citation type="doi">10.1093/bioinformatics/btr174</citation>
56a189070900 Uploaded
devteam
parents:
diff changeset
119 </citations>
56a189070900 Uploaded
devteam
parents:
diff changeset
120 </tool>