annotate snpeff_3_3/snpSift_caseControl.xml @ 0:80e2dbf1b1f5 draft

Uploaded
author fubar
date Sun, 11 Aug 2013 08:15:14 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
1 <tool id="snpSift_caseControl" name="SnpSift CaseControl" version="3.3">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
2 <description>Count samples are in 'case' and 'control' groups.</description>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
3 <!--
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
4 You will need to change the path to wherever your installation is.
80e2dbf1b1f5 Uploaded
fubar
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)
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
6 -->
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
7 <requirements>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
8 <requirement type="package" version="3.3">snpEff</requirement>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
9 </requirements>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
10 <command>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
11 java -Xmx1G -jar \$JAVA_JAR_PATH/SnpSift.jar caseControl -q
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
12 #if $name.__str__.strip() != '':
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
13 -name $name
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
14 #end if
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
15 #if $ctrl.ctrl_src == 'caseString':
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
16 '$ctrl.caseControlStr'
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
17 #else
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
18 -tfam "$ctrl.tfam"
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
19 #end if
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
20 $input > $output
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
21 </command>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
22 <inputs>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
23 <param format="vcf" name="input" type="data" label="VCF input"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
24 <conditional name="ctrl">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
25 <param name="ctrl_src" type="select" label="Case Control defined in">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
26 <option value="caseString">Case Control String</option>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
27 <option value="tfam">TFAM</option>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
28 </param>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
29 <when value="caseString">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
30 <param name="caseControlStr" type="text" label="Case / Control column designation" size="50">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
31 <help>
80e2dbf1b1f5 Uploaded
fubar
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
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
33 </help>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
34 <validator type="regex" message="must be only plus(+), minus(-), or zero(0) characters">[+-0]+</validator>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
35 </param>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
36 </when>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
37 <when value="tfam">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
38 <param format="tabular" name="tfam" type="data" label="PLINK TFAM file"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
39 </when>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
40 </conditional>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
41 <param name="name" type="text" optional="true" label="name" help="name to append to the 'Cases' or 'Controls' tags">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
42 <validator type="regex" message="Use only valid ID characters">[_a-zA-Z0-9]+</validator>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
43 </param>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
44 </inputs>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
45 <outputs>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
46 <data format="vcf" name="output" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
47 </outputs>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
48 <stdio>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
49 <exit_code range=":-1" level="fatal" description="Error: Cannot open file" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
50 <exit_code range="1:" level="fatal" description="Error" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
51 </stdio>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
52 <tests>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
53
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
54 <test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
55 <param name="input" ftype="vcf" value="test.private.01.vcf"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
56 <param name="ctrl_src" value="caseString"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
57 <param name="caseControlStr" value="--"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
58 <output name="output">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
59 <assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
60 <has_text text="Cases=0,0,0;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
61 <has_text text="Controls=0,0,0;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
62 </assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
63 </output>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
64 </test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
65
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
66 <test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
67 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
68 <param name="ctrl_src" value="caseString"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
69 <param name="caseControlStr" value="--"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
70 <output name="output">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
71 <assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
72 <has_text text="Cases=0,0,0;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
73 <has_text text="Controls=2,0,4;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
74 </assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
75 </output>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
76 </test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
77
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
78 <test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
79 <param name="input" ftype="vcf" value="test.private.02.vcf"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
80 <param name="name" value=""/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
81 <param name="ctrl_src" value="caseString"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
82 <param name="caseControlStr" value="-+"/>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
83 <output name="output">
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
84 <assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
85 <has_text text="Cases=1,0,2;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
86 <has_text text="Controls=1,0,2;" />
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
87 </assert_contents>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
88 </output>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
89 </test>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
90
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
91 </tests>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
92
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
93 <help>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
94
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
95 **SnpSift CaseControl**
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
96
80e2dbf1b1f5 Uploaded
fubar
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.
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
98
80e2dbf1b1f5 Uploaded
fubar
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.
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
100
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
101 This command adds two annotations to the VCF file:
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
102
80e2dbf1b1f5 Uploaded
fubar
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:
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
104
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
105 "CaseControl=3,4" *the variant is present in 3 cases and 4 controls.*
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
106
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
107
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
108 - **CaseControlP**: A p-value (Fisher exact test) that the number of cases is N or more. Example:
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
109
80e2dbf1b1f5 Uploaded
fubar
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*
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
111
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
112
80e2dbf1b1f5 Uploaded
fubar
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:
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
114
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
115 - Hom/Het case = "hom"
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
116
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
117 - Hom/Het control = "any"
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
118
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
119 - Case / Control column designation = ""++++------"
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
120
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
121
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
122 For details about this tool, read the fine manual_ http://snpeff.sourceforge.net/SnpSift.html#casecontrol
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
123
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
124 For details about this tool, please see the snpEff_ web site.
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
125
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
126 .. _snpEff: http://snpEff.sourceforge.net
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
127 .. _manual: http://snpeff.sourceforge.net/SnpSift.html#casecontrol
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
128 .. _licensed: http://creativecommons.org/licenses/by-nc-nd/3.0/
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
129 </help>
80e2dbf1b1f5 Uploaded
fubar
parents:
diff changeset
130 </tool>