Mercurial > repos > devteam > bamtools_split

annotate bamtools-split.xml @ 2:e2c1b62e1db1 draft

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