annotate README.txt @ 2:885ba15c2564 draft

Uploaded
author saskia-hiltemann
date Mon, 03 Aug 2015 05:45:16 -0400
parents 1209f18a5a83
children ac09a5aaed0b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
1 Installs VirtualNormal Correction Tool
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
2
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
3 After installing this tool via admin panel, manually configure the following:
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
4
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
5 1) edit virtual_normal_correction.loc file
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
6
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
7 - change "/path/to/hg18.crr" to the location of the Complete Genomics reference crr file on your system
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
8 (can be downloaded from ftp://ftp.completegenomics.com/ReferenceFiles/ )
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
9
2
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
10 - change "/path/to/VN_genomes_varfiles_lists_hg18" to the location of the directory containing files with the locations of all the Complete Genomics
0
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
11 varfiles to be used as a virtual normal. This file should contain 1 file location per line, e.g.
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
12
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
13 /path/to/normal-varfile-1
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
14 /path/to/normal-varfile-2
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
15 /path/to/normal-varfile-3
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
16 /path/to/normal-varfile-4
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
17 /path/to/normal-varfile-5
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
18 /path/to/normal-varfile-6
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
19 /path/to/normal-varfile-7
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
20 /path/to/normal-varfile-8
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
21 ...
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
22
2
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
23 - edit the tool xml file to offer sets of virtual normals
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
24
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
25 [..]
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
26 <!-- edit these options to reflect sets of normal you have available. The values must name files within the directories specified in data_table_conf.xml file -->
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
27 <param name="VNset" type="select" label="Select Virtual Normal set to use" help="1000Genomes set can only be used for hg19 samples, for hg18 54 genomes will be used.">
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
28 <option value="46_diversity.txt" > CG Diversity Panel and trios (54 Genomes) </option>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
29 <option value="433_1000g.txt" > CG 1000G project genomes (433 Genomes) (hg19 only) </option>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
30 <option value="479_diversity_1000g.txt" > Diversity and 1000G (479 genomes) (hg19 only) </option>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
31 <option value="10_tutorial.txt" > Small VN for tutorial (10 Genomes) </option>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
32 </param>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
33 [..]
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
34
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
35 the values indicate files expected to be at the location configured in the loc file,
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
36
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
37
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
38 So if your .loc file looks like this:
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
39
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
40
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
41 #loc file for annovar tool
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
42
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
43 # <columns>value, dbkey, name, VN_genomes_varfiles_list, VN_genomes_junctionfile_list, reference_crr_cgatools</columns>
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
44
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
45 hg18 hg18 Virtual Normal hg18 /path/to/VN_genomes_varfiles_lists_hg18 /path/to/VN_genomes_junctionfiles_lists_hg18 /path/to/hg18.crr
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
46 hg19 hg19 Virtual_Normal hg19 /path/to/VN_genomes_varfiles_lists_hg19 /path/to/VN_genomes_junctionfiles_lists_hg19 /path/to/hg19.crr
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
47
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
48 And your xml file like the example above, then the tool expects the following files to exist:
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
49 /path/to/VN_genomes/varfiles_list_hg18/46_diversity.txt
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
50 /path/to/VN_genomes/varfiles_list_hg18/433_1000g.txt
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
51 etc
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
52 and containing a 1-per-line list of locations of the varfiles of the normal genomes.
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
53
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
54
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
55
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
56
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
57 Varfiles can be in compressed or uncompressed form. For example, Complete Genomics' Diversity panel can be used.
0
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
58 (can be downloaded from ftp://ftp2.completegenomics.com/)
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
59
2
885ba15c2564 Uploaded
saskia-hiltemann
parents: 0
diff changeset
60 - change "/path/to/VN_genomes_junctionfiles_lists_hg18" to the location of the file containing the locations of all the Complete Genomics
0
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
61 junctionfiles to be used as a virtual normal. This file should contain 1 file location per line. For example, Complete Genomics'
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
62 Diversity panel can be used. (can be downloaded from ftp://ftp2.completegenomics.com/)
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
63
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
64 2) restart Galaxy for changes to take effect
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
65
1209f18a5a83 Uploaded
saskia-hiltemann
parents:
diff changeset
66 After this initial setup, additional normals can be added to the lists without having to restart Galaxy.