annotate somatic_sniper.xml @ 0:e81f5649bd4d draft default tip

Uploaded
author fcaramia
date Thu, 20 Jun 2013 00:06:01 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
1 <tool id="somatic_sniper_tool" name="Somatic Sniper" version="1.0.2">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
2 <description>: identify single nucleotide positions that are different between tumor and normal</description>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
3 <requirements>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
4 <requirement type="package" version="unstable">somatic-sniper</requirement>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
5 </requirements>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
6 <command interpreter="perl">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
7 somatic_sniper_wrapper.pl
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
8
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
9 "NORMAL::$normal"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
10 "TUMOR::$tumor"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
11 "OUTPUT::$snp_output"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
12 "OPTION::-F $output"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
13
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
14 #if $option.option == "modify_parameters":
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
15 "OPTION::-q $option.readFilter"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
16 "OPTION::-Q $option.somaticFilter"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
17 "OPTION::-s $option.mutationPrior"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
18 #if str($option.disablePriors) == "true"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
19 "OPTION::-p"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
20 #end if
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
21 #end if
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
22
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
23 "OPTION::-f $reference.fields.path"
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
24
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
25
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
26 </command>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
27 <inputs>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
28 <param name="reference" type="select" label="Select a reference genome">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
29 <options from_data_table="all_fasta">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
30 <filter type="sort_by" column="2" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
31 <validator type="no_options" message="No indexes are available" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
32 </options>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
33 </param>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
34
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
35 <param format="bam" name="normal" type="data" label="Normal sample" help=""/>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
36 <param format="bam" name="tumor" type="data" label="Tumor Sample" help=""/>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
37 <param name="output" type="select" label="Output Type" help="" optional="true">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
38 <option value="classic" selected="true">Classic</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
39 <option value="vcf">VCF</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
40 <option value="bed">BED</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
41 </param>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
42
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
43
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
44 <conditional name="option">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
45 <param name="option" type="select" label="Optional Parameters" help="" optional="true">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
46 <option value="default_parameters" selected="true">Default Parameters</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
47 <option value="modify_parameters">Modify Parameters</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
48 </param>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
49 <when value="modify_parameters">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
50
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
51 <param name="readFilter" label="filtering reads with mapping quality less than" type="integer" value="0" optional="true" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
52 <param name="somaticFilter" label="filtering somatic snv output with somatic quality less than" type="integer" value="15" optional="true" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
53 <param name="disablePriors" type="select" label="disable priors in the somatic calculation. Increases sensitivity for solid tumors" help="" optional="true">
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
54 <option value="true" >true</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
55 <option value="false" selected="true">false</option>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
56 </param>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
57 <param name="mutationPrior" label="prior probability of a somatic mutation" type="float" value="0.10000" optional="true" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
58
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
59 </when>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
60
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
61 </conditional>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
62
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
63 </inputs>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
64 <outputs>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
65 <data name="snp_output" format="text" label="${tool.name} result on ${on_string}" />
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
66 </outputs>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
67 <help>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
68 |
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
69
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
70
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
71 **Reference**
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
72
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
73 http://gmt.genome.wustl.edu/somatic-sniper/current/
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
74
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
75 -----
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
76
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
77 **What it does**
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
78
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
79 The purpose of this program is to identify single nucleotide positions that are different between tumor and normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
80 (or, in theory, any two bam files). It takes a tumor bam and a normal bam and compares the two to determine the
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
81 differences. It outputs a file in a format very similar to Samtools consensus format. It uses the genotype likelihood
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
82 model of MAQ (as implemented in Samtools) and then calculates the probability that the tumor and normal genotypes are
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
83 different. This probability is reported as a somatic score. The somatic score is the Phred-scaled probability (between 0 to 255)
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
84 that the Tumor and Normal genotypes are not different where 0 means there is no probability that the genotypes are different and
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
85 255 means there is a probability of 1 – 10(255/-10) that the genotypes are different between tumor and normal. This is consistent
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
86 with how the SAM format reports such probabilities.
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
87
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
88 bam-somaticsniper [options] -f ref.fasta tumor.bam normal.bam snp_output_file
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
89
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
90 Bam files must contain LB tag in @RG line.
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
91 Picard tools can be used to add lines to BAM headers.
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
92
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
93 -----
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
94
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
95 **Required Parameters**
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
96
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
97 ::
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
98
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
99 -f FILE REQUIRED reference sequence in the FASTA format
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
100
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
101 -----
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
102
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
103 **Options**
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
104
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
105 ::
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
106
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
107 -q INT filtering reads with mapping quality less than INT [0]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
108
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
109 -Q INT filtering somatic snv output with somatic quality less than INT [15]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
110
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
111 -p FLAG disable priors in the somatic calculation. Increases sensitivity for solid tumors
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
112
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
113 -J FLAG Use prior probabilities accounting for the somatic mutation rate
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
114
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
115 -s FLOAT prior probability of a somatic mutation (implies -J) [0.010000]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
116
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
117 -T FLOAT theta in maq consensus calling model (for -c/-g) [0.850000]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
118
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
119 -N INT number of haplotypes in the sample (for -c/-g) [2]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
120
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
121 -r FLOAT prior of a difference between two haplotypes (for -c/-g) [0.001000]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
122
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
123 -F STRING select output format [classic]
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
124 Available formats:
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
125 classic
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
126 vcf
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
127 bed
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
128
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
129 -----
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
130
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
131 **File Formats**
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
132
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
133 ::
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
134
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
135 Classic:
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
136
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
137 Each line contains the following tab-separated values:
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
138
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
139 1. Chromosome
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
140 2. Position
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
141 3. Reference base
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
142 4. IUB genotype of tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
143 5. IUB genotype of normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
144 6. Somatic Score
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
145 7. Tumor Consensus quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
146 8. Tumor variant allele quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
147 9. Tumor mean mapping quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
148 10. Normal Consensus quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
149 11. Normal variant allele quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
150 12. Normal mean mapping quality
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
151 13. Depth in tumor (# of reads crossing the position)
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
152 14. Depth in normal (# of reads crossing the position)
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
153 15. Mean base quality of reads supporting reference in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
154 16. Mean mapping quality of reads supporting reference in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
155 17. Depth of reads supporting reference in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
156 18. Mean base quality of reads supporting variant(s) in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
157 19. Mean mapping quality of reads supporting variant(s) in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
158 20. Depth of reads supporting variant(s) in tumor
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
159 21. Mean base quality of reads supporting reference in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
160 22. Mean mapping quality of reads supporting reference in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
161 23. Depth of reads supporting reference in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
162 24. Mean base quality of reads supporting variant(s) in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
163 25. Mean mapping quality of reads supporting variant(s) in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
164 26. Depth of reads supporting variant(s) in normal
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
165
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
166
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
167
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
168 </help>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
169 </tool>
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
170
e81f5649bd4d Uploaded
fcaramia
parents:
diff changeset
171