annotate snpSift_caseControl.xml @ 25:7c1c337fb21c default tip

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