annotate bamFingerprint.xml @ 0:09b65c12a75a draft

Uploaded
author bgruening
date Sat, 03 Aug 2013 13:42:12 -0400
parents
children 21d563d5f2b2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
1 <tool id="bamFingerprint" name="bamFingerprint" version="1.0">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
2 <description>plots profiles of bam files</description>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
3 <requirements>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
4 <requirement type="package" version="1.5.1_98e5d8a61431ea8605c0643d991a1a5d8999b4dc">deepTools</requirement>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
5 </requirements>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
6 <command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
7 #set files=[]
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
8 #set labels=[]
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
9 #for $i in $inputs
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
10 #set $files += [str($i.bamfile)]
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
11 #if str($i.label.value) != "":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
12 #set $labels += ["\"%s\"" % ($i.label.value)]
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
13 #else
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
14 #set $labels += ["\"%s\"" % ($i.bamfile.name)]
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
15 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
16 #end for
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
17 bamFingerprint
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
18 --bamfiles #echo " ".join($files)
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
19 --labels #echo " ".join($labels)
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
20
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
21 --fragmentLength $fragmentLength
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
22
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
23 #set newoutFileName=str($outFileName)+".png"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
24 --plotFile $newoutFileName
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
25
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
26 #if $outputOpt.showOutputOpt == "yes"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
27 #if $outputOpt.saveRawCounts:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
28 --outRawCounts '$outFileRawCounts'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
29 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
30 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
31
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
32 #if $advancedOpt.showAdvancedOpt == "yes":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
33 #if $advancedOpt.smoothLength:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
34 --smoothLength '$advancedOpt.smoothLength'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
35 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
37 #if str($advancedOpt.region.value) != '':
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
38 --region '$advancedOpt.region'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
39 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
40
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
41 --binSize '$advancedOpt.binSize'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
42 --numberOfSamples '$advancedOpt.numberOfSamples'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
43
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
44 $advancedOpt.doNotExtendPairedEnds
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
45 $advancedOpt.ignoreDuplicates
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
46 $advancedOpt.skipZeros
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
47
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
48 #if $advancedOpt.minMappingQuality:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
49 --minMappingQuality '$advancedOpt.minMappingQuality'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
50 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
51 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
52
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
53 --numberOfProcessors 4; mv $newoutFileName $outFileName
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
54 </command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
55
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
56 <inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
57
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
58 <repeat name="inputs" title="Input files" min="2">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
59 <param name="bamfile" type="data" format="bam"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
60 label="Bam file"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
61 help="The BAM file must be sorted and indexed."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
62 <param name="label" type="text" size="30" optional="true" value=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
63 label="Label"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
64 help="Label to use in the output. If not given the dataset name will be used instead."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
65 </repeat>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
66
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
67 <param name="fragmentLength" type="integer" value="200" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
68 label="Length of the average fragment size"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
69
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
70 <conditional name="advancedOpt">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
71 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
72 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
73 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
74 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
75 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
76 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
77 <param name="smoothLength" type="integer" value="1" optional="true" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
78 label="Smooth values using the following length (in bp)"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
79 help ="The smooth length defines a window, larger than the bin size, to average the number of reads. For example, if the bin size is set to 20 bp and the smooth length is set to 60 bp, then, for each bin size the average of it and its left and right neighbors is considered. Any value smaller than the bin size will be ignored and no smoothing will be applied."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
80
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
81 <param name="region" type="text" value=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82 label="Region of the genome to limit the operation to"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
83 help="This is useful when testing parameters to reduce the computing time. The format is chr:start:end, for example &quot;chr10&quot; or &quot;chr10:456700:891000&quot;" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85 <param name="binSize" type="integer" value="10000" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 label="Bin size in bp"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87 help="Length in base pairs for a window used to sample the genome."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
88
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89 <param name="numberOfSamples" type="integer" value="100000" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
90 label="Number of samples"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
91 help="Number of samples taken from the genome to compute the scaling factors"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
92
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
93 <param name="doNotExtendPairedEnds" type="boolean" truevalue="--doNotExtendPairedEnds" falsevalue=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
94 label="Do not extend paired ends"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
95 help="If set, reads are not extended to match the fragment length reported in the BAM file, instead they will be extended to match the fragment length. Default is to extend the reads if paired end information is available."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
96
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
97 <param name="ignoreDuplicates" type="boolean" truevalue="--ignoreDuplicates" falsevalue=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
98 label="Ignore duplicates"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
99 help="If set, reads that have the same orientation and start position will be considered only once. If reads are paired, the mate position also has to coincide to ignore a read." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
100
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
101 <param name="minMappingQuality" type="integer" optional="true" value="1" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
102 label="Minimum mapping quality"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
103 help= "If set, only reads that have a mapping quality score higher than the given value are considered"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
104
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
105 <param name="skipZeros" type="boolean" truevalue="--skipZeros" falsevalue=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
106 label ="Include zeros"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
107 help ="If set, then zero counts that happen for *all* bam files given are ignored. This will result in a reduced number of read counts than the specified in number of samples" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
108 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
109 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
110
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
111 <conditional name="outputOpt">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
112 <param name="showOutputOpt" type="select" label="Show additional output options" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
113 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
114 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
115 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
116 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
117 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
118 <param name="saveRawCounts" type="boolean" label="Save the bin counts"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
119 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
120 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
121 </inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
122 <outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
123 <data format="png" name="outFileName" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
124 <data format="tabular" name="outFileRawCounts" label="${tool.name} on ${on_string}: bin counts">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
125 <filter>(outputOpt['showOutputOpt'] == 'yes' and outputOpt['saveRawCounts'] == True)</filter>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
126 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
127 </outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
128 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
129
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
130 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
131
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
132 Samples indexed bam files and plots a profile for each bam file. At each
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
133 sample position all reads overlaping a window (bin) of specified length are
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
134 counted. This counts are then sorted and the cumulative sum plotted
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
135
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
136 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
137
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
138 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
139
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
140 Please acknowledge that this tool **is still in development** and we will be very happy to receive feedback from the users. If you run into any trouble please sent an email to `Fidel Ramirez`_.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
141
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
142 This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
143
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
144
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
145 .. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
146 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
147 .. _Fidel Ramirez: ramirez@ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
148
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
149 </help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
150
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
151 </tool>