annotate picard_macros.xml @ 2:801f5e934011 draft default tip

Uploaded
author devteam
date Thu, 23 Oct 2014 11:40:52 -0400
parents b76a4f17bbbb
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
1 <macros>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
2 <xml name="VS">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
3 <param name="validation_stringency" type="select" label="Select validation stringency" help=" Setting stringency to SILENT can improve performance when processing a BAM file in which variable-length data (read, qualities, tags) do not otherwise need to be decoded.">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
4 <option value="LENIENT" selected="True">Lenient</option>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
5 <option value="SILENT">Silent</option>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
6 <option value="STRICT">Strict</option>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
7 </param>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
8 </xml>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
9
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
10 <token name="@java_options@">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
11 _JAVA_OPTIONS=\${_JAVA_OPTIONS:-'-Xmx2048m -Xms256m'} &amp;&amp;
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
12 export _JAVA_OPTIONS &amp;&amp;
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
13 </token>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
14
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
15 <token name="@more_info@">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
16 ------
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
17
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
18 **Additional information**
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
19
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
20 Additional information about Picard tools is available from Picard web site at http://broadinstitute.github.io/picard/.
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
21 </token>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
22
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
23
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
24 <token name="@description@">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
25 ------
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
26
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
27 **Inputs, outputs, and parameters**
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
28
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
29 Either a SAM file or a BAM file must be supplied. Galaxy automatically coordinate-sorts all uploaded BAM files.
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
30
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
31 From Picard documentation( http://broadinstitute.github.io/picard/)::
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
32
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
33 </token>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
34 <token name="@RG@">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
35 -------
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
36
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
37 **Read Groups are Important!**
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
38
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
39 Setting read groups correctly from the start will simplify your life greatly because you can merge multiple BAM files into one significantly reducing the number of analysis steps. Below we provide an explanation of read groups fields taken from GATK FAQ webpage:
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
40
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
41 .. csv-table::
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
42 :header-rows: 1
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
43
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
44 Tag,Importance,Definition,Meaning
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
45 "ID","Required","Read group identifier. Each @RG line must have a unique ID. The value of ID is used in the RG tags of alignment records. Must be unique among all read groups in header section. Read group IDs may be modified when merging SAM files in order to handle collisions.","Ideally, this should be a globally unique identify across all sequencing data in the world, such as the Illumina flowcell + lane name and number. Will be referenced by each read with the RG:Z field, allowing tools to determine the read group information associated with each read, including the sample from which the read came. Also, a read group is effectively treated as a separate run of the NGS instrument in tools like base quality score recalibration (a GATK component) -- all reads within a read group are assumed to come from the same instrument run and to therefore share the same error model."
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
46 "SM","Sample. Use pool name where a pool is being sequenced.","Required. As important as ID.","The name of the sample sequenced in this read group. GATK tools treat all read groups with the same SM value as containing sequencing data for the same sample. Therefore it's critical that the SM field be correctly specified, especially when using multi-sample tools like the Unified Genotyper (a GATK component)."
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
47 "PL","Platform/technology used to produce the read. Valid values: ILLUMINA, SOLID, LS454, HELICOS and PACBIO.","Important. Not currently used in the GATK, but was in the past, and may return. The only way to known the sequencing technology used to generate the sequencing data","It's a good idea to use this field."
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
48 "LB","DNA preparation library identify","Essential for MarkDuplicates","MarkDuplicates uses the LB field to determine which read groups might contain molecular duplicates, in case the same DNA library was sequenced on multiple lanes."
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
49
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
50 **Example of Read Group usage**
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
51
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
52 Support we have a trio of samples: MOM, DAD, and KID. Each has two DNA libraries prepared, one with 400 bp inserts and another with 200 bp inserts. Each of these libraries is run on two lanes of an illumina hiseq, requiring 3 x 2 x 2 = 12 lanes of data. When the data come off the sequencer, we would create 12 BAM files, with the following @RG fields in the header::
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
53
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
54 Dad's data:
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
55 @RG ID:FLOWCELL1.LANE1 PL:illumina LB:LIB-DAD-1 SM:DAD PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
56 @RG ID:FLOWCELL1.LANE2 PL:illumina LB:LIB-DAD-1 SM:DAD PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
57 @RG ID:FLOWCELL1.LANE3 PL:illumina LB:LIB-DAD-2 SM:DAD PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
58 @RG ID:FLOWCELL1.LANE4 PL:illumina LB:LIB-DAD-2 SM:DAD PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
59
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
60 Mom's data:
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
61 @RG ID:FLOWCELL1.LANE5 PL:illumina LB:LIB-MOM-1 SM:MOM PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
62 @RG ID:FLOWCELL1.LANE6 PL:illumina LB:LIB-MOM-1 SM:MOM PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
63 @RG ID:FLOWCELL1.LANE7 PL:illumina LB:LIB-MOM-2 SM:MOM PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
64 @RG ID:FLOWCELL1.LANE8 PL:illumina LB:LIB-MOM-2 SM:MOM PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
65
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
66 Kid's data:
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
67 @RG ID:FLOWCELL2.LANE1 PL:illumina LB:LIB-KID-1 SM:KID PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
68 @RG ID:FLOWCELL2.LANE2 PL:illumina LB:LIB-KID-1 SM:KID PI:200
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
69 @RG ID:FLOWCELL2.LANE3 PL:illumina LB:LIB-KID-2 SM:KID PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
70 @RG ID:FLOWCELL2.LANE4 PL:illumina LB:LIB-KID-2 SM:KID PI:400
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
71
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
72 Note the hierarchical relationship between read groups (unique for each lane) to libraries (sequenced on two lanes) and samples (across four lanes, two lanes for each library).
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
73 </token>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
74 <token name="@dataset_collections@">
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
75 ------
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
76
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
77 **Dataset collections - processing large numbers of datasets at once**
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
78
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
79 This will be added shortly
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
80
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
81
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
82 </token>
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
83
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
84
b76a4f17bbbb Uploaded
devteam
parents:
diff changeset
85 </macros>