annotate snpSift_caseControl.xml @ 7:b26a1aff7f81

Fix issues with snpEff commandline template and add test cases
author Jim Johnson <jj@umn.edu>
date Thu, 28 Mar 2013 12:29:45 -0500
parents ec16dae84230
children 13b6ad2ddace
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>
6
ec16dae84230 Fix tests for SnpSift caseControl and intervals
Jim Johnson <jj@umn.edu>
parents: 5
diff changeset
48 <has_text text="CaseControl=0/0,0/2;" />
5
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
49 </assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
50 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
51 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
52
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
53 <test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
54 <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
55 <param name="hhCase" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
56 <param name="hhControl" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
57 <param name="caseControStr" value="--"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
58 <output name="output">
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
59 <assert_contents>
6
ec16dae84230 Fix tests for SnpSift caseControl and intervals
Jim Johnson <jj@umn.edu>
parents: 5
diff changeset
60 <has_text text="CaseControl=0/0,2/0;" />
5
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
61 </assert_contents>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
62 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
63 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
64
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 <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
67 <param name="hhCase" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
68 <param name="hhControl" value="any"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
69 <param name="caseControStr" value="-+"/>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
70 <output name="output">
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
71 <assert_contents>
6
ec16dae84230 Fix tests for SnpSift caseControl and intervals
Jim Johnson <jj@umn.edu>
parents: 5
diff changeset
72 <has_text text="CaseControl=1/0,1/0;" />
5
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 </output>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
75 </test>
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
76
192a236898f5 Add test cases for SnpSift
Jim Johnson <jj@umn.edu>
parents: 2
diff changeset
77 </tests>
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
78
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
79 <help>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
80
1
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
81 **SnpSift CaseControl**
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
82
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
83 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
84
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
85 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
86
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
87 This command adds two annotations to the VCF file:
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
88
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
89 - **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
90
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
91 "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
92
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 - **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
95
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
96 "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
97
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 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
100
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
101 - Hom/Het case = "hom"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
102
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
103 - Hom/Het control = "any"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
104
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
105 - Case / Control column designation = ""++++------"
2c595fea585c Add more doocumentation
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
106
0
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
107
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
108 For details about this tool, please go to http://snpeff.sourceforge.net/SnpSift.html#casecontrol
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
109
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
110 </help>
c07c403fc470 Uploaded
jjohnson
parents:
diff changeset
111 </tool>