annotate bamFingerprint.xml @ 66:1dbd76a58d8b draft

planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit f720d773e34ad90d14d7cae77c1a0bb5d126102c-dirty
author galaxyp
date Sat, 30 May 2015 13:55:46 -0400
parents 9bee2c86eeb1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
1 <tool id="deeptools_bamFingerprint" name="bamFingerprint" version="@WRAPPER_VERSION@.0">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
2 <description>plots profiles of BAM files; useful for assesing ChIP signal strength</description>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
3 <macros>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
4 <token name="@BINARY@">bamFingerprint</token>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
5 <import>deepTools_macros.xml</import>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
6 </macros>
65
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
7 <expand macro="requirements" />
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
8 <command>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
9 <![CDATA[
f3140d17939e Uploaded
bgruening
parents:
diff changeset
10 @multiple_input_bams@
f3140d17939e Uploaded
bgruening
parents:
diff changeset
11
f3140d17939e Uploaded
bgruening
parents:
diff changeset
12 bamFingerprint
f3140d17939e Uploaded
bgruening
parents:
diff changeset
13
f3140d17939e Uploaded
bgruening
parents:
diff changeset
14 @THREADS@
f3140d17939e Uploaded
bgruening
parents:
diff changeset
15
f3140d17939e Uploaded
bgruening
parents:
diff changeset
16 --bamfiles #echo " ".join($files)
f3140d17939e Uploaded
bgruening
parents:
diff changeset
17 --labels #echo " ".join($labels)
f3140d17939e Uploaded
bgruening
parents:
diff changeset
18
f3140d17939e Uploaded
bgruening
parents:
diff changeset
19 --fragmentLength $fragmentLength
f3140d17939e Uploaded
bgruening
parents:
diff changeset
20
65
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
21 --plotFile $outFileName
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
22
f3140d17939e Uploaded
bgruening
parents:
diff changeset
23 #if $output.showOutputSettings == "yes"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
24 --plotFileFormat $output.outFileFormat
f3140d17939e Uploaded
bgruening
parents:
diff changeset
25 #if $output.saveRawCounts:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
26 --outRawCounts '$outFileRawCounts'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
27 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
28 #else
f3140d17939e Uploaded
bgruening
parents:
diff changeset
29 --plotFileFormat 'png'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
30 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
31
f3140d17939e Uploaded
bgruening
parents:
diff changeset
32 #if str($region).strip() != '':
f3140d17939e Uploaded
bgruening
parents:
diff changeset
33 --region '$region'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
34 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
35
f3140d17939e Uploaded
bgruening
parents:
diff changeset
36 #if $advancedOpt.showAdvancedOpt == "yes":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
37 --binSize '$advancedOpt.binSize'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
38 --numberOfSamples '$advancedOpt.numberOfSamples'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
39
f3140d17939e Uploaded
bgruening
parents:
diff changeset
40 $advancedOpt.doNotExtendPairedEnds
f3140d17939e Uploaded
bgruening
parents:
diff changeset
41 $advancedOpt.ignoreDuplicates
f3140d17939e Uploaded
bgruening
parents:
diff changeset
42 $advancedOpt.skipZeros
f3140d17939e Uploaded
bgruening
parents:
diff changeset
43
f3140d17939e Uploaded
bgruening
parents:
diff changeset
44 #if $advancedOpt.minMappingQuality:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
45 --minMappingQuality '$advancedOpt.minMappingQuality'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
46 #end if
65
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
47
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
48 #if $advancedOpt.plotTitle and str($advancedOpt.plotTitle.value) != "":
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
49 --plotTitle '$advancedOpt.plotTitle'
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
50 #end if
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
51
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
52 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
53 ]]>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
54 </command>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
55
f3140d17939e Uploaded
bgruening
parents:
diff changeset
56 <inputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
57 <expand macro="multiple_input_bams" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
58 <expand macro="fragmentLength" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
59 <expand macro="region_limit_operation" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
60
f3140d17939e Uploaded
bgruening
parents:
diff changeset
61 <conditional name="advancedOpt">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
62 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
f3140d17939e Uploaded
bgruening
parents:
diff changeset
63 <option value="no" selected="true">no</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
64 <option value="yes">yes</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
65 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
66 <when value="no" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
67 <when value="yes">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
68 <param name="binSize" type="integer" value="500" min="1"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
69 label="Bin size in bp"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
70 help="Length in base pairs for a window used to sample the genome."/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
71 <param name="numberOfSamples" type="integer" value="100000" min="1"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
72 label="Number of samples"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
73 help="Number of samples taken from the genome to compute the scaling factors. (--numberOfSamples)"/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
74 <expand macro="doNotExtendPairedEnds" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
75 <expand macro="ignoreDuplicates" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
76 <expand macro="minMappingQuality" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
77 <expand macro="skipZeros" />
65
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
78 <expand macro="plotTitle" />
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
79 </when>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
80 </conditional>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
81 <conditional name="output">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
82 <param name="showOutputSettings" type="select" label="Show advanced output settings">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
83 <option value="no" selected="true">no</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
84 <option value="yes">yes</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
85 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
86 <when value="no" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
87 <when value="yes">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
88 <expand macro="input_image_file_format" />
65
9bee2c86eeb1 planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit ab1ab06323702186cf0c883d5774720cbb822cb5-dirty
iuc
parents: 61
diff changeset
89 <param name="saveRawCounts" type="boolean" label="Save the bin counts" help="(--outRawCounts)"/>
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
90 </when>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
91 </conditional>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
92 </inputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
93 <outputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
94 <expand macro="output_image_file_format" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
95 <data format="tabular" name="outFileRawCounts" label="${tool.name} on ${on_string}: bin counts">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
96 <filter>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
97 ((
f3140d17939e Uploaded
bgruening
parents:
diff changeset
98 output['showOutputSettings'] == 'yes' and
f3140d17939e Uploaded
bgruening
parents:
diff changeset
99 output['saveRawCounts'] is True
f3140d17939e Uploaded
bgruening
parents:
diff changeset
100 ))
f3140d17939e Uploaded
bgruening
parents:
diff changeset
101 </filter>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
102 </data>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
103 </outputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
104 <tests>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
105 <test>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
106 <repeat name="input_files">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
107 <param name="bamfile" value="bowtie2-test1.bam" ftype="bam" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
108 </repeat>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
109 <repeat name="input_files">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
110 <param name="bamfile" value="bowtie2-test1.bam" ftype="bam" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
111 </repeat>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
112 <param name="fragmentLength" value="200" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
113 <param name="showAdvancedOpt" value="no" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
114 <param name="showOutputSettings" value="no" />
66
1dbd76a58d8b planemo upload for repository https://github.com/fidelram/deepTools/tree/master/galaxy/wrapper/ commit f720d773e34ad90d14d7cae77c1a0bb5d126102c-dirty
galaxyp
parents: 65
diff changeset
115 <output name="outFileName" file="bamFingerprint_result1.png" ftype="png" compare="sim_size" />
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
116 </test>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
117 </tests>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
118 <help>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
119 <![CDATA[
f3140d17939e Uploaded
bgruening
parents:
diff changeset
120 **What it does**
f3140d17939e Uploaded
bgruening
parents:
diff changeset
121
f3140d17939e Uploaded
bgruening
parents:
diff changeset
122 This tool is useful to assess the strength of a ChIP (i.e. how clearly the enrichment signal can be separated from the background signal)
f3140d17939e Uploaded
bgruening
parents:
diff changeset
123 and it is based on a method developed by Diaz et al. (2012) Stat Appl Genet Mol Biol 11(3).
f3140d17939e Uploaded
bgruening
parents:
diff changeset
124
f3140d17939e Uploaded
bgruening
parents:
diff changeset
125 The tool first samples indexed BAM files and counts all reads overlapping a window (bin) of specified length.
f3140d17939e Uploaded
bgruening
parents:
diff changeset
126 These counts are then sorted according to their rank (the bin with the highest number of reads has the highest rank)
f3140d17939e Uploaded
bgruening
parents:
diff changeset
127 and the cumulative sum of read counts are plotted. An ideal input (control sample) with perfect uniform distribution of reads
f3140d17939e Uploaded
bgruening
parents:
diff changeset
128 along the genome (i.e. without enrichments in open chromatin etc.) should
f3140d17939e Uploaded
bgruening
parents:
diff changeset
129 generate a straight diagonal line. A very specific and strong ChIP enrichment will be indicated by a prominent and steep
f3140d17939e Uploaded
bgruening
parents:
diff changeset
130 rise of the cumulative sum towards the highest rank. This means that a big chunk of reads from the ChIP sample is located in
f3140d17939e Uploaded
bgruening
parents:
diff changeset
131 few bins which corresponds to high, narrow enrichments seen for transcription factors.
f3140d17939e Uploaded
bgruening
parents:
diff changeset
132
f3140d17939e Uploaded
bgruening
parents:
diff changeset
133
f3140d17939e Uploaded
bgruening
parents:
diff changeset
134 .. image:: $PATH_TO_IMAGES/QC_fingerprint.png
f3140d17939e Uploaded
bgruening
parents:
diff changeset
135
f3140d17939e Uploaded
bgruening
parents:
diff changeset
136
f3140d17939e Uploaded
bgruening
parents:
diff changeset
137 You can find more details on the bamFingerprint wiki page: https://github.com/fidelram/deepTools/wiki/QC#wiki-bamFingerprint
f3140d17939e Uploaded
bgruening
parents:
diff changeset
138
f3140d17939e Uploaded
bgruening
parents:
diff changeset
139
f3140d17939e Uploaded
bgruening
parents:
diff changeset
140 **Output files**:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
141
f3140d17939e Uploaded
bgruening
parents:
diff changeset
142 - Diagnostic plot
f3140d17939e Uploaded
bgruening
parents:
diff changeset
143 - Data matrix of raw counts
f3140d17939e Uploaded
bgruening
parents:
diff changeset
144
f3140d17939e Uploaded
bgruening
parents:
diff changeset
145 -----
f3140d17939e Uploaded
bgruening
parents:
diff changeset
146
f3140d17939e Uploaded
bgruening
parents:
diff changeset
147 @REFERENCES@
f3140d17939e Uploaded
bgruening
parents:
diff changeset
148 ]]>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
149 </help>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
150 <expand macro="citations" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
151 </tool>