Mercurial > repos > devteam > bwa
annotate bwa_macros.xml @ 5:fbf460831036 draft
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
| author | devteam |
|---|---|
| date | Tue, 21 Jul 2015 13:51:02 -0400 |
| parents | ac30bfd3e2a8 |
| children | 09a7281d24c5 |
| rev | line source |
|---|---|
| 0 | 1 <macros> |
|
5
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
2 <import>read_group_macros.xml</import> |
| 2 | 3 <token name="@set_rg_string@"> |
|
5
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
4 #set $rg_string = "@RG\tID:" + str($rg_id) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
5 #set $rg_string += $format_read_group("\tSM:", $rg_sm) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
6 #set $rg_string += $format_read_group("\tPL:", $rg_pl) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
7 #set $rg_string += $format_read_group("\tLB:", $rg_lb) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
8 #set $rg_string += $format_read_group("\tCN:", $rg_cn) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
9 #set $rg_string += $format_read_group("\tDS:", $rg_ds) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
10 #set $rg_string += $format_read_group("\tDT:", $rg_dt) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
11 #set $rg_string += $format_read_group("\tFO:", $rg_fo) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
12 #set $rg_string += $format_read_group("\tKS:", $rg_ks) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
13 #set $rg_string += $format_read_group("\tPG:", $rg_pg) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
14 #set $rg_string += $format_read_group("\tPI:", $rg_pi) |
|
fbf460831036
planemo upload commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
15 #set $rg_string += $format_read_group("\tPU:", $rg_pu) |
| 2 | 16 </token> |
| 0 | 17 |
| 2 | 18 <token name="@RG@"> |
| 0 | 19 ----- |
| 20 | |
| 21 .. class:: warningmark | |
| 22 | |
| 23 **Read Groups are Important!** | |
| 24 | |
|
4
ac30bfd3e2a8
planemo upload commit a50a3947aebc8a1d11bac39599f4efd8ed9a3bd5
devteam
parents:
2
diff
changeset
|
25 One of the recommended best practices in NGS analysis is adding read group information to BAM files. You can do this directly in BWA interface using the |
| 2 | 26 **Specify read group information?** widget. If you are not familiar with read groups you shold know that this is effectively a way to tag reads with an additional ID. |
| 0 | 27 This allows you to combine BAM files from, for example, multiple BWA runs into a single dataset. This significantly simplifies downstream processing as |
| 2 | 28 instead of dealing with multiple datasets you only have to handle only one. This is possible because the read group information allows you to identify |
| 0 | 29 data from different experiments even if they are combined in one file. Many downstream analysis tools such as varinat callers (e.g., FreeBayes or Naive Varinat Caller |
| 30 present in Galaxy) are aware of readgtroups and will automatically generate calls for each individual sample even if they are combined within a single file. | |
| 31 | |
| 32 **Description of read groups fields** | |
| 33 | |
| 34 (from GATK FAQ webpage): | |
| 35 | |
| 36 .. csv-table:: | |
| 37 :header-rows: 1 | |
| 38 | |
| 39 Tag,Importance,Definition,Meaning | |
| 40 "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." | |
| 41 "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)." | |
| 42 "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." | |
| 43 "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." | |
| 44 | |
| 45 | |
| 46 **Example of Read Group usage** | |
| 47 | |
| 48 Suppose 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:: | |
| 49 | |
| 50 Dad's data: | |
| 51 @RG ID:FLOWCELL1.LANE1 PL:illumina LB:LIB-DAD-1 SM:DAD PI:200 | |
| 52 @RG ID:FLOWCELL1.LANE2 PL:illumina LB:LIB-DAD-1 SM:DAD PI:200 | |
| 53 @RG ID:FLOWCELL1.LANE3 PL:illumina LB:LIB-DAD-2 SM:DAD PI:400 | |
| 54 @RG ID:FLOWCELL1.LANE4 PL:illumina LB:LIB-DAD-2 SM:DAD PI:400 | |
| 55 | |
| 56 Mom's data: | |
| 57 @RG ID:FLOWCELL1.LANE5 PL:illumina LB:LIB-MOM-1 SM:MOM PI:200 | |
| 58 @RG ID:FLOWCELL1.LANE6 PL:illumina LB:LIB-MOM-1 SM:MOM PI:200 | |
| 59 @RG ID:FLOWCELL1.LANE7 PL:illumina LB:LIB-MOM-2 SM:MOM PI:400 | |
| 60 @RG ID:FLOWCELL1.LANE8 PL:illumina LB:LIB-MOM-2 SM:MOM PI:400 | |
| 61 | |
| 62 Kid's data: | |
| 63 @RG ID:FLOWCELL2.LANE1 PL:illumina LB:LIB-KID-1 SM:KID PI:200 | |
| 64 @RG ID:FLOWCELL2.LANE2 PL:illumina LB:LIB-KID-1 SM:KID PI:200 | |
| 65 @RG ID:FLOWCELL2.LANE3 PL:illumina LB:LIB-KID-2 SM:KID PI:400 | |
| 66 @RG ID:FLOWCELL2.LANE4 PL:illumina LB:LIB-KID-2 SM:KID PI:400 | |
| 67 | |
| 68 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). | |
| 2 | 69 </token> |
| 70 <token name="@info@"> | |
| 0 | 71 ----- |
| 72 | |
| 73 .. class:: infomark | |
| 74 | |
| 75 **More info** | |
| 76 | |
| 77 To obtain more information about BWA and ask questions use these resources: | |
| 78 | |
| 79 1. https://biostar.usegalaxy.org/ | |
| 80 2. https://www.biostars.org/ | |
| 81 3. https://github.com/lh3/bwa | |
| 82 4. http://bio-bwa.sourceforge.net/ | |
| 83 | |
| 2 | 84 </token> |
| 0 | 85 |
| 2 | 86 <token name="@dataset_collections@"> |
| 0 | 87 ------ |
| 88 | |
| 89 **Dataset collections - processing large numbers of datasets at once** | |
| 90 | |
|
4
ac30bfd3e2a8
planemo upload commit a50a3947aebc8a1d11bac39599f4efd8ed9a3bd5
devteam
parents:
2
diff
changeset
|
91 Dataset collections are in beta-testing. Extensive documentation will be added later this Spring. |
| 0 | 92 |
| 93 | |
| 2 | 94 </token> |
| 0 | 95 |
| 96 </macros> |