annotate snpSift_caseControl.xml @ 3:a8f4ebfb8253

Update tool_dependencies.xml for package_snpeff_3_3
author Jim Johnson <jj@umn.edu>
date Fri, 04 Oct 2013 09:31:27 -0500
parents 6ad9205c1307
children 8952990fcab9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
6ad9205c1307 Update to SnpEff version 3.3
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
1 <tool id="snpSift_caseControl" name="SnpSift CaseControl" version="3.3">
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
2 <description>Count samples are in 'case' and 'control' groups.</description>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
3 <!--
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
4 You will need to change the path to wherever your installation is.
e1d9f6a0ad53 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)
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
6 -->
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
7 <requirements>
2
6ad9205c1307 Update to SnpEff version 3.3
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
8 <requirement type="package" version="3.3">snpEff</requirement>
0
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
9 </requirements>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
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
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
21 </command>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
22 <inputs>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
23 <param format="vcf" name="input" type="data" label="VCF input"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
24 <conditional name="ctrl">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
25 <param name="ctrl_src" type="select" label="Case Control defined in">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
26 <option value="caseString">Case Control String</option>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
27 <option value="tfam">TFAM</option>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
28 </param>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
29 <when value="caseString">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
30 <param name="caseControlStr" type="text" label="Case / Control column designation" size="50">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
31 <help>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
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
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
33 </help>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
34 <validator type="regex" message="must be only plus(+), minus(-), or zero(0) characters">[+-0]+</validator>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
35 </param>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
36 </when>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
37 <when value="tfam">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
38 <param format="tabular" name="tfam" type="data" label="PLINK TFAM file"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
39 </when>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
40 </conditional>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
41 <param name="name" type="text" optional="true" label="name" help="name to append to the 'Cases' or 'Controls' tags">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
42 <validator type="regex" message="Use only valid ID characters">[_a-zA-Z0-9]+</validator>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
43 </param>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
44 </inputs>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
45 <outputs>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
46 <data format="vcf" name="output" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
47 </outputs>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
48 <stdio>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
49 <exit_code range=":-1" level="fatal" description="Error: Cannot open file" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
50 <exit_code range="1:" level="fatal" description="Error" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
51 </stdio>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
52 <tests>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
53
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
54 <test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
55 <param name="input" ftype="vcf" value="test.private.01.vcf"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
56 <param name="ctrl_src" value="caseString"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
57 <param name="caseControlStr" value="--"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
58 <output name="output">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
59 <assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
60 <has_text text="Cases=0,0,0;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
61 <has_text text="Controls=0,0,0;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
62 </assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
63 </output>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
64 </test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
65
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
66 <test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
67 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
68 <param name="ctrl_src" value="caseString"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
69 <param name="caseControlStr" value="--"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
70 <output name="output">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
71 <assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
72 <has_text text="Cases=0,0,0;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
73 <has_text text="Controls=2,0,4;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
74 </assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
75 </output>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
76 </test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
77
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
78 <test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
79 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
80 <param name="name" value=""/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
81 <param name="ctrl_src" value="caseString"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
82 <param name="caseControlStr" value="-+"/>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
83 <output name="output">
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
84 <assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
85 <has_text text="Cases=1,0,2;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
86 <has_text text="Controls=1,0,2;" />
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
87 </assert_contents>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
88 </output>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
89 </test>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
90
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
91 </tests>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
92
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
93 <help>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
94
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
95 **SnpSift CaseControl**
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
96
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
97 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
98
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
99 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
100
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
101 This command adds two annotations to the VCF file:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
102
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
103 - **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
104
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
105 "CaseControl=3,4" *the variant is present in 3 cases and 4 controls.*
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
106
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
107
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
108 - **CaseControlP**: A p-value (Fisher exact test) that the number of cases is N or more. Example:
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
109
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
110 "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
111
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
112
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
113 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
114
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
115 - Hom/Het case = "hom"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
116
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
117 - Hom/Het control = "any"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
118
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
119 - Case / Control column designation = ""++++------"
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
120
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
121
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
122 For details about this tool, please go to http://snpeff.sourceforge.net/SnpSift.html#casecontrol
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
123
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
124 </help>
e1d9f6a0ad53 Uploaded
jjohnson
parents:
diff changeset
125 </tool>