annotate tools/human_genome_variation/gpass.xml @ 1:cdcb0ce84a1b

Uploaded
author xuebing
date Fri, 09 Mar 2012 19:45:15 -0500
parents 9071e359b9a3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
1 <tool id="hgv_gpass" name="GPASS" version="1.0.0">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
2 <description>significant single-SNP associations in case-control studies</description>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
3
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
4 <command interpreter="perl">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
5 gpass.pl ${input1.extra_files_path}/${input1.metadata.base_name}.map ${input1.extra_files_path}/${input1.metadata.base_name}.ped $output $fdr
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
6 </command>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
7
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
8 <inputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
9 <param name="input1" type="data" format="lped" label="Dataset"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
10 <param name="fdr" type="float" value="0.05" label="FDR"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
11 </inputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
12
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
13 <outputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
14 <data name="output" format="tabular" />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
15 </outputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
16
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
17 <requirements>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
18 <requirement type="package">gpass</requirement>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
19 </requirements>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
20
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
21 <!-- we need to be able to set the seed for the random number generator
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
22 <tests>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
23 <test>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
24 <param name='input1' value='gpass_and_beam_input' ftype='lped' >
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
25 <metadata name='base_name' value='gpass_and_beam_input' />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
26 <composite_data value='gpass_and_beam_input.ped' />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
27 <composite_data value='gpass_and_beam_input.map' />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
28 <edit_attributes type='name' value='gpass_and_beam_input' />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
29 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
30 <param name="fdr" value="0.05" />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
31 <output name="output" file="gpass_output.txt" />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
32 </test>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
33 </tests>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
34 -->
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
35
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
36 <help>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
37 **Dataset formats**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
38
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
39 The input dataset must be in lped_ format, and the output is tabular_.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
40 (`Dataset missing?`_)
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
41
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
42 .. _lped: ./static/formatHelp.html#lped
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
43 .. _tabular: ./static/formatHelp.html#tab
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
44 .. _Dataset missing?: ./static/formatHelp.html
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
45
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
46 -----
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
47
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
48 **What it does**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
49
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
50 GPASS (Genome-wide Poisson Approximation for Statistical Significance)
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
51 detects significant single-SNP associations in case-control studies at a user-specified FDR. Unlike previous methods, this tool can accurately approximate the genome-wide significance and FDR of SNP associations, while adjusting for millions of multiple comparisons, within seconds or minutes.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
52
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
53 The program has two main functionalities:
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
54
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
55 1. Detect significant single-SNP associations at a user-specified false
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
56 discovery rate (FDR).
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
57
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
58 *Note*: a "typical" definition of FDR could be
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
59 FDR = E(# of false positive SNPs / # of significant SNPs)
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
60
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
61 This definition however is very inappropriate for association mapping, since SNPs are
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
62 highly correlated. Our FDR is
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
63 defined differently to account for SNP correlations, and thus will obtain
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
64 a proper FDR in terms of "proportion of false positive loci".
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
65
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
66 2. Approximate the significance of a list of candidate SNPs, adjusting for
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
67 multiple comparisons. If you have isolated a few SNPs of interest and want
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
68 to know their significance in a GWAS, you can supply the GWAS data and let
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
69 the program specifically test those SNPs.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
70
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
71
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
72 *Also note*: the number of SNPs in a study cannot be both too small and at the same
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
73 time too clustered in a local region. A few hundreds of SNPs, or tens of SNPs
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
74 spread in different regions, will be fine. The sample size cannot be too small
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
75 either; around 100 or more individuals (case + control combined) will be fine.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
76 Otherwise use permutation.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
77
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
78 -----
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
79
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
80 **Example**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
81
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
82 - input map file::
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
83
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
84 1 rs0 0 738547
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
85 1 rs1 0 5597094
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
86 1 rs2 0 9424115
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
87 etc.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
88
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
89 - input ped file::
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
90
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
91 1 1 0 0 1 1 G G A A A A A A A A A G A A G G G G A A G G G G G G A A A A A G A A G G A G A G A A G G A A G G A A G G A G A A G G A A G G A A A G A G G G A G G G G G A A A G A A G G G G G G G G A G A A A A A A A A
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
92 1 1 0 0 1 1 G G A G G G A A A A A G A A G G G G G G A A G G A G A G G G G G A G G G A G A A G G A G G G A A G G G G A G A G G G A G A A A A G G G G A G A G G G A G A A A A A G G G A G G G A G G G G G A A G G A G
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
93 etc.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
94
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
95 - output dataset, showing significant SNPs and their p-values and FDR::
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
96
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
97 #ID chr position Statistics adj-Pvalue FDR
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
98 rs35 chr1 136606952 4.890849 0.991562 0.682138
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
99 rs36 chr1 137748344 4.931934 0.991562 0.795827
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
100 rs44 chr2 14423047 7.712832 0.665086 0.218776
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
101 etc.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
102
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
103 -----
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
104
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
105 **Reference**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
106
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
107 Zhang Y, Liu JS. (2010)
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
108 Fast and accurate significance approximation for genome-wide association studies.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
109 Submitted.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
110
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
111 </help>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
112 </tool>