annotate snpSift_caseControl.xml @ 9:f981ba577f2b

Prevent duplication of regulation and extra_annotation options
author Jim Johnson <jj@umn.edu>
date Fri, 29 Nov 2013 17:13:33 -0600
parents 0ad9733e22a4
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
8952990fcab9 Update to snpEff version 3.4 and add data managers to download snpEff genome reference databases
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
1 <tool id="snpSift_caseControl" name="SnpSift CaseControl" version="3.4">
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
2 <description>Count samples are in 'case' and 'control' groups.</description>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
3 <!--
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
4 You can change the amount of memory used, just change the -Xmx parameter (e.g. use -Xmx2G for 2Gb of memory)
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
5 -->
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
6 <expand macro="requirements" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
7 <macros>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
8 <import>snpEff_macros.xml</import>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
9 </macros>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
10 <command>
2
6ad9205c1307 Update to SnpEff version 3.3
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
11 java -Xmx1G -jar \$SNPEFF_JAR_PATH/SnpSift.jar caseControl -q
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
12 #if $name.__str__.strip() != '':
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
13 -name $name
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
14 #end if
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
15 #if $ctrl.ctrl_src == 'caseString':
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
16 '$ctrl.caseControlStr'
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
17 #else
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
18 -tfam "$ctrl.tfam"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
19 #end if
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
20 $input > $output
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
21 </command>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
22 <inputs>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
23 <param format="vcf" name="input" type="data" label="Variant input file in VCF format"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
24 <conditional name="ctrl">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
25 <param name="ctrl_src" type="select" label="Case Control defined in">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
26 <option value="caseString">Case Control String</option>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
27 <option value="tfam">TFAM file</option>
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
28 </param>
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
29 <when value="caseString">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
30 <param name="caseControlStr" type="text" label="Case / Control column designation" size="50">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
31 <help>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
32 Case and control are defined by a string containing plus and minus symbols {'+', '-', '0'} where '+' is case, '-' is control and '0' is neutral
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
33 </help>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
34 <validator type="regex" message="must be only plus(+), minus(-), or zero(0) characters">[+-0]+</validator>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
35 </param>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
36 </when>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
37 <when value="tfam">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
38 <param format="tabular" name="tfam" type="data" label="PLINK TFAM file" help="Read more about TFAM at http://pngu.mgh.harvard.edu/~purcell/plink/data.shtml#tr"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
39 </when>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
40 </conditional>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
41 <param name="name" type="text" optional="true" label="name" help="name to append to the 'Cases' or 'Controls' tags">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
42 <validator type="regex" message="Use only valid ID characters">[_a-zA-Z0-9]+</validator>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
43 </param>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
44 </inputs>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
45 <outputs>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
46 <data format="vcf" name="output" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
47 </outputs>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
48 <expand macro="stdio" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
49 <tests>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
50 <test>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
51 <param name="input" ftype="vcf" value="test.private.01.vcf"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
52 <param name="ctrl_src" value="caseString"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
53 <param name="caseControlStr" value="--"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
54 <output name="output">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
55 <assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
56 <has_text text="Cases=0,0,0;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
57 <has_text text="Controls=0,0,0;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
58 </assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
59 </output>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
60 </test>
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
61
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
62 <test>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
63 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
64 <param name="ctrl_src" value="caseString"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
65 <param name="caseControlStr" value="--"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
66 <output name="output">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
67 <assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
68 <has_text text="Cases=0,0,0;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
69 <has_text text="Controls=2,0,4;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
70 </assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
71 </output>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
72 </test>
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
73
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
74 <test>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
75 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
76 <param name="name" value=""/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
77 <param name="ctrl_src" value="caseString"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
78 <param name="caseControlStr" value="-+"/>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
79 <output name="output">
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
80 <assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
81 <has_text text="Cases=1,0,2;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
82 <has_text text="Controls=1,0,2;" />
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
83 </assert_contents>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
84 </output>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
85 </test>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
86 </tests>
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
87 <help>
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
88
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
89 **SnpSift CaseControl**
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
90
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
91 Allows you to count how many samples are in 'case' group and a 'control' group. You can count 'homozygous', 'heterozygous' or 'any' variants.
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
92
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
93 Case and control are defined by a string containing plus and minus symbols {'+', '-', '0'} where '+' is case, '-' is control and '0' is neutral.
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
94
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
95 This command adds two annotations to the VCF file:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
96
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
97 - **CaseControl**: Two comma separated numbers numbers representing the number of samples that have the variant in the case and the control group. Example:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
98
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
99 "CaseControl=3,4" *the variant is present in 3 cases and 4 controls.*
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
100
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
101
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
102 - **CaseControlP**: A p-value (Fisher exact test) that the number of cases is N or more. Example:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
103
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
104 "CaseControl=4,0;CaseControlP=3.030303e-02" *in this case the pValue of having 4 or more cases and zero controls is 0.03*
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
105
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
106
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
107 For example, if we have ten samples (which means ten genotype columns in the VCF file), the first four are 'case' and the last six are 'control', so the description string would be "++++------". Let's say we want to distinguish genotypes that are homozygous in 'case' and either homozygous or heterozygous in 'control'. We would set:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
108
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
109 - Hom/Het case = "hom"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
110
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
111 - Hom/Het control = "any"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
112
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
113 - Case / Control column designation = ""++++------"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
114
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
115
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
116 @EXTERNAL_DOCUMENTATION@
5
8952990fcab9 Update to snpEff version 3.4 and add data managers to download snpEff genome reference databases
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
117
7
0ad9733e22a4 Uploaded
bgruening
parents: 5
diff changeset
118 @CITATION_SECTION@
5
8952990fcab9 Update to snpEff version 3.4 and add data managers to download snpEff genome reference databases
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
119
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
120 </help>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
121 </tool>