annotate bamCorrelate.xml @ 46:b716d69ac94b

Uploaded
author bgruening
date Fri, 02 Aug 2013 12:48:54 -0400
parents c6f1a059bc7d
children 6a2a7374450b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
39
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
1 <tool id="bamCorrelate" name="bamCorrelate" version="1.0">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
2 <description>corrlates pairs of bam files</description>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
3
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
4 <command>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
5 #set files=[]
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
6 #set labels=[]
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
7 #for $i in $inputs
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
8 #set $files += [str($i.bamfile)]
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
9 #if str($i.label.value) != "":
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
10 #set $labels += ["\"%s\"" % ($i.label.value)]
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
11 #else
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
12 #set $labels += ["\"%s\"" % ($i.bamfile.name)]
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
13 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
14 #end for
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
15 bamCorrelate
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
16 --bamfiles #echo " ".join($files)
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
17 --labels #echo " ".join($labels)
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
18
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
19 --fragmentLength $fragmentLength
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
20 --corMethod $corMethod
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
21
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
22 #set newoutFileName=str($outFileName)+".png"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
23 --plotFile $newoutFileName
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
24
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
25 #if $outputOpt.showOutputOpt == "yes"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
26 #if $outputOpt.outFileRawCounts:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
27 --outRawCounts '$outputOpt.outFileRawCounts'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
28 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
29 #if $outputOpt.outFileCorMatrix:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
30 --outFileCorMatrix '$outputOpt.outFileCorMatrix'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
31 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
32 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
33
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
34 #if $advancedOpt.showAdvancedOpt == "yes":
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
35 #if $advancedOpt.smoothLength:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
36 --smoothLength '$advancedOpt.smoothLength'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
37 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
38
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
39 #if str($advancedOpt.region.value) != '':
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
40 --region '$advancedOpt.region'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
41 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
42
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
43 --binSize '$advancedOpt.binSize'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
44 --numberOfSamples '$advancedOpt.numberOfSamples'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
45
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
46 $advancedOpt.doNotExtendPairedEnds
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
47 $advancedOpt.ignoreDuplicates
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
48 $advancedOpt.includeZeros
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
49
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
50 #if $advancedOpt.minMappingQuality:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
51 --minMappingQuality '$advancedOpt.minMappingQuality'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
52 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
53 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
54
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
55 --numberOfProcessors 4; mv $newoutFileName $outFileName
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
56 </command>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
57
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
58 <inputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
59
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
60 <repeat name="inputs" title="Input files" min="2">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
61 <param name="bamfile" type="data" format="bam"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
62 label="Bam file"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
63 help="The BAM file must be sorted and indexed."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
64 <param name="label" type="text" size="30" optional="true" value=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
65 label="Label"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
66 help="Label to use in the output. If not given the dataset name will be used instead."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
67 </repeat>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
68
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
69 <param name="fragmentLength" type="integer" value="300" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
70 label="Length of the average fragment size"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
71 help ="Reads will be extended to match this length unless they are paired-end, in which case they will be extended to match the fragment length. If this value is set to the read length or smaller, the read will not be extended. *Warning* the fragment length affects the normalization to 1x (see &quot;normalize coverage to 1x&quot;). The formula to normalize using the sequencing depth is genomeSize/(number of mapped reads * fragment length). *NOTE*: If the BAM files contain mated and unmated paired-end reads, unmated reads will be extended to match the fragment length."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
72
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
73 <param name="corMethod" type="select" label="Correlation method">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
74 <option value="pearson">Pearson</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
75 <option value="spearman">Spearman</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
76 </param>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
77
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
78 <conditional name="advancedOpt">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
79 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
80 <option value="no" selected="true">no</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
81 <option value="yes">yes</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
82 </param>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
83 <when value="no" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
84 <when value="yes">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
85 <param name="smoothLength" type="integer" value="1" optional="true" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
86 label="Smooth values using the following length (in bp)"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
87 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."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
88
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
89 <param name="region" type="text" value=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
90 label="Region of the genome to limit the operation to"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
91 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;" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
92
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
93 <param name="binSize" type="integer" value="10000" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
94 label="Bin size in bp"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
95 help="Length in base pairs for a window used to sample the genome."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
96
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
97 <param name="numberOfSamples" type="integer" value="100000" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
98 label="Number of samples"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
99 help="Number of samples taken from the genome to compute the scaling factors"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
100
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
101 <param name="doNotExtendPairedEnds" type="boolean" truevalue="--doNotExtendPairedEnds" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
102 label="Do not extend paired ends"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
103 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."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
104
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
105 <param name="ignoreDuplicates" type="boolean" truevalue="--ignoreDuplicates" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
106 label="Ignore duplicates"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
107 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." />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
108
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
109 <param name="minMappingQuality" type="integer" optional="true" value="1" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
110 label="Minimum mapping quality"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
111 help= "If set, only reads that have a mapping quality score higher than the given value are considered"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
112
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
113 <param name="includeZeros" type="boolean" truevalue="--includeZeros" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
114 label ="Include zeros"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
115 help ="If set, then zero counts that happen for *all* bam files given are included. The default behavior is to ignore those cases" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
116
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
117 </when>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
118 </conditional>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
119
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
120 <conditional name="outputOpt">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
121 <param name="showOutputOpt" type="select" label="Show additional output options" >
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
122 <option value="no" selected="true">no</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
123 <option value="yes">yes</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
124 </param>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
125 <when value="no" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
126 <when value="yes">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
127 <param name="saveRawCounts" type="boolean" label="Save the bin counts"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
128 <param name="saveCorMatrix" type="boolean" label="Save the correlation matrix"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
129 </when>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
130 </conditional>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
131
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
132 </inputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
133 <outputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
134 <data format="png" name="outFileName" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
135 <data format="tabular" name="outFileRawCounts" label="${tool.name} on ${on_string}: bin counts">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
136 <filter>(outputOpt['showOutputOpt'] == 'yes' and outputOpt['saveRawCounts'] == True)</filter>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
137 </data>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
138 <data format="tabular" name="outFileCorMatrix" label="${tool.name} on ${on_string}: correlation matrix">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
139 <filter>(outputOpt['showOutputOpt'] == 'yes' and outputOpt['saveCorMatrix'] == True)</filter>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
140 </data>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
141 </outputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
142 <help>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
143
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
144 **What it does**
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
145
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
146 Genomes are split into bins of given length. For each bin the number of reads
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
147 found for each of the bam files is counted. A correlation is computed for all
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
148 pairs of bam files.
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
149
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
150 -----
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
151
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
152 .. class:: infomark
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
153
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
154 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`_.
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
155
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
156 This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
157
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
158
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
159 .. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
160 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
161 .. _Fidel Ramirez: ramirez@ie-freiburg.mpg.de
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
162
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
163 </help>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
164
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
165 </tool>