annotate snpSift_caseControl.xml @ 5:192a236898f5

Add test cases for SnpSift
author Jim Johnson <jj@umn.edu>
date Mon, 25 Mar 2013 08:51:33 -0500
parents a9bae7957c36
children ec16dae84230
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
1 <tool id="snpSift_caseControl" name="SnpSift CaseControl" version="3.1">
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
2 <description>Count samples are in 'case' and 'control' groups.</description>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
3 <!--
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
4 You will need to change the path to wherever your installation is.
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
5 You can change the amount of memory used, just change the -Xmx parameter (e.g. use -Xmx2G for 2Gb of memory)
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
6 -->
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
7 <requirements>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
8 <requirement type="package" version="3.1">snpEff</requirement>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
9 </requirements>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
10 <command>
2
a9bae7957c36 Fix typo on caseControl in commandline
Jim Johnson <jj@umn.edu>
parents: 1
diff changeset
11 java -Xmx1G -jar \$JAVA_JAR_PATH/SnpSift.jar caseControl -q $hhCase $hhControl '$caseControStr' $input > $output
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
12 </command>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
13 <inputs>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
14 <param format="vcf" name="input" type="data" label="VCF input"/>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
15 <param name="hhCase" type="select" label="Hom/Het case">
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
16 <option value="any">Any</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
17 <option value="hom">Homozygous</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
18 <option value="het">Heterozygous</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
19 </param>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
20 <param name="hhControl" type="select" label="Hom/Het control">
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
21 <option value="any">Any</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
22 <option value="hom">Homozygous</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
23 <option value="het">Heterozygous</option>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
24 </param>
1
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
25 <param name="caseControStr" type="text" label="Case / Control column designation" size="50">
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
26 <help>
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
27 Case and control are defined by a string containing plus and minus symbols {'+', '-', '0'} where '+' is case, '-' is control and '0' is neutral
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
28 </help>
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
29 <validator type="regex" message="must be only plus(+), minus(-), or zero(0) characters">[+-0]+</validator>
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
30 </param>
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
31 </inputs>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
32 <outputs>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
33 <data format="vcf" name="output" />
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
34 </outputs>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
35 <stdio>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
36 <exit_code range=":-1" level="fatal" description="Error: Cannot open file" />
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
37 <exit_code range="1:" level="fatal" description="Error" />
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
38 </stdio>
5
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
39 <tests>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
40
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
41 <test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
42 <param name="input" ftype="vcf" value="test.private.01.vcf"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
43 <param name="hhCase" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
44 <param name="hhControl" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
45 <param name="caseControStr" value="--"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
46 <output name="output">
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
47 <assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
48 <has_text text="Cases=0,0,0;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
49 <has_text text="Controls=0,0,0;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
50 </assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
51 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
52 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
53
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
54 <test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
55 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
56 <param name="hhCase" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
57 <param name="hhControl" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
58 <param name="caseControStr" value="--"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
59 <output name="output">
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
60 <assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
61 <has_text text="Cases=0,0,0;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
62 <has_text text="Controls=2,0,4;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
63 </assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
64 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
65 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
66
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
67 <test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
68 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
69 <param name="hhCase" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
70 <param name="hhControl" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
71 <param name="caseControStr" value="-+"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
72 <output name="output">
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
73 <assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
74 <has_text text="Cases=1,0,2;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
75 <has_text text="Controls=1,0,2;" />
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
76 </assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
77 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
78 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
79
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
80 </tests>
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
81
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
82 <help>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
83
1
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
84 **SnpSift CaseControl**
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
85
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
86 Allows you to count how many samples are in 'case' group and a 'control' group. You can count 'homozygous', 'heterozygous' or 'any' variants.
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
87
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
88 Case and control are defined by a string containing plus and minus symbols {'+', '-', '0'} where '+' is case, '-' is control and '0' is neutral.
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
89
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
90 This command adds two annotations to the VCF file:
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
91
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
92 - **CaseControl**: Two comma separated numbers numbers representing the number of samples that have the variant in the case and the control group. Example:
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
93
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
94 "CaseControl=3,4" *the variant is present in 3 cases and 4 controls.*
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
95
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
96
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
97 - **CaseControlP**: A p-value (Fisher exact test) that the number of cases is N or more. Example:
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
98
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
99 "CaseControl=4,0;CaseControlP=3.030303e-02" *in this case the pValue of having 4 or more cases and zero controls is 0.03*
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
100
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
101
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
102 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:
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
103
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
104 - Hom/Het case = "hom"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
105
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
106 - Hom/Het control = "any"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
107
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
108 - Case / Control column designation = ""++++------"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
109
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
110
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
111 For details about this tool, please go to http://snpeff.sourceforge.net/SnpSift.html#casecontrol
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
112
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
113 </help>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
114 </tool>