annotate snpeff33/snpSift_caseControl.xml @ 1:a1e35baae42a draft

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