annotate bamFingerprint.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="bamFingerprint" name="bamFingerprint" version="1.0">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
2 <description>plots profiles 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 bamFingerprint
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
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
21 #set newoutFileName=str($outFileName)+".png"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
22 --plotFile $newoutFileName
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
23
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
24 #if $outputOpt.showOutputOpt == "yes"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
25 #if $outputOpt.saveRawCounts:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
26 --outRawCounts '$outFileRawCounts'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
27 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
28 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
29
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
30 #if $advancedOpt.showAdvancedOpt == "yes":
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
31 #if $advancedOpt.smoothLength:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
32 --smoothLength '$advancedOpt.smoothLength'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
33 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
34
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
35 #if str($advancedOpt.region.value) != '':
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
36 --region '$advancedOpt.region'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
37 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
38
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
39 --binSize '$advancedOpt.binSize'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
40 --numberOfSamples '$advancedOpt.numberOfSamples'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
41
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
42 $advancedOpt.doNotExtendPairedEnds
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
43 $advancedOpt.ignoreDuplicates
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
44 $advancedOpt.skipZeros
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
45
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
46 #if $advancedOpt.minMappingQuality:
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
47 --minMappingQuality '$advancedOpt.minMappingQuality'
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
48 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
49 #end if
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
50
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
51 --numberOfProcessors 4; mv $newoutFileName $outFileName
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
52 </command>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
53
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
54 <inputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
55
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
56 <repeat name="inputs" title="Input files" min="2">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
57 <param name="bamfile" type="data" format="bam"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
58 label="Bam file"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
59 help="The BAM file must be sorted and indexed."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
60 <param name="label" type="text" size="30" optional="true" value=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
61 label="Label"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
62 help="Label to use in the output. If not given the dataset name will be used instead."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
63 </repeat>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
64
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
65 <param name="fragmentLength" type="integer" value="200" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
66 label="Length of the average fragment size"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
67
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
68 <conditional name="advancedOpt">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
69 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
70 <option value="no" selected="true">no</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
71 <option value="yes">yes</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
72 </param>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
73 <when value="no" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
74 <when value="yes">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
75 <param name="smoothLength" type="integer" value="1" optional="true" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
76 label="Smooth values using the following length (in bp)"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
77 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
78
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
79 <param name="region" type="text" value=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
80 label="Region of the genome to limit the operation to"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
81 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
82
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
83 <param name="binSize" type="integer" value="10000" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
84 label="Bin size in bp"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
85 help="Length in base pairs for a window used to sample the genome."/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
86
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
87 <param name="numberOfSamples" type="integer" value="100000" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
88 label="Number of samples"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
89 help="Number of samples taken from the genome to compute the scaling factors"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
90
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
91 <param name="doNotExtendPairedEnds" type="boolean" truevalue="--doNotExtendPairedEnds" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
92 label="Do not extend paired ends"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
93 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
94
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
95 <param name="ignoreDuplicates" type="boolean" truevalue="--ignoreDuplicates" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
96 label="Ignore duplicates"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
97 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
98
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
99 <param name="minMappingQuality" type="integer" optional="true" value="1" min="1"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
100 label="Minimum mapping quality"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
101 help= "If set, only reads that have a mapping quality score higher than the given value are considered"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
102
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
103 <param name="skipZeros" type="boolean" truevalue="--skipZeros" falsevalue=""
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
104 label ="Include zeros"
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
105 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" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
106
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
107 </when>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
108 </conditional>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
109
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
110 <conditional name="outputOpt">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
111 <param name="showOutputOpt" type="select" label="Show additional output options" >
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
112 <option value="no" selected="true">no</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
113 <option value="yes">yes</option>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
114 </param>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
115 <when value="no" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
116 <when value="yes">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
117 <param name="saveRawCounts" type="boolean" label="Save the bin counts"/>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
118 </when>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
119 </conditional>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
120
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
121 </inputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
122 <outputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
123 <data format="png" name="outFileName" />
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
124 <data format="tabular" name="outFileRawCounts" label="${tool.name} on ${on_string}: bin counts">
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
125 <filter>(outputOpt['showOutputOpt'] == 'yes' and outputOpt['saveRawCounts'] == True)</filter>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
126 </data>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
127 </outputs>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
128 <help>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
129
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
130 **What it does**
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
131
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
132 Samples indexed bam files and plots a profile for each bam file. At each
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
133 sample position all reads overlaping a window (bin) of specified length are
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
134 counted. This counts are then sorted and the cumulative sum plotted
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
135
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
136 -----
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
137
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
138 .. class:: infomark
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
139
c6f1a059bc7d 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`_.
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
141
c6f1a059bc7d 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`_.
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
143
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
144
c6f1a059bc7d 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/
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
146 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
147 .. _Fidel Ramirez: ramirez@ie-freiburg.mpg.de
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
148
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
149 </help>
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
150
c6f1a059bc7d Uploaded
bgruening
parents:
diff changeset
151 </tool>