annotate picard_MarkDuplicates.xml @ 5:3d4f1fa26f0e draft

Uploaded
author devteam
date Tue, 16 Dec 2014 19:03:21 -0500
parents
children 4ff1e04010e6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
1 <tool name="MarkDuplicates" id="picard_MarkDuplicates" version="1.126.0">
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
2 <description>examine aligned records in BAM datasets to locate duplicate molecules</description>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
3 <requirements>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
4 <requirement type="package" version="1.126.0">picard</requirement>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
5 </requirements>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
6
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
7 <macros>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
8 <import>picard_macros.xml</import>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
9 </macros>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
10
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
11 <command>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
12 @java_options@
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
13
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
14 java -jar \$JAVA_JAR_PATH/picard.jar
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
15 MarkDuplicates
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
16
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
17 INPUT="${inputFile}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
18 OUTPUT="${outFile}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
19
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
20 METRICS_FILE="${metrics_file}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
21 #for $element in $comments:
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
22 COMMENT="${element.comment}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
23 #end for
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
24 REMOVE_DUPLICATES="${remove_duplicates}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
25 ASSUME_SORTED="${assume_sorted}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
26
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
27 DUPLICATE_SCORING_STRATEGY="${duplicate_scoring_strategy}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
28
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
29 READ_NAME_REGEX="${read_name_regex}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
30 OPTICAL_DUPLICATE_PIXEL_DISTANCE="${optical_duplicate_pixel_distance}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
31
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
32 VALIDATION_STRINGENCY="${validation_stringency}"
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
33 QUIET=true
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
34 VERBOSITY=ERROR
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
35
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
36 </command>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
37 <inputs>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
38 <param format="bam" name="inputFile" type="data" label="Select SAM/BAM dataset or dataset collection" help="If empty, upload or import a SAM/BAM dataset"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
39 <repeat name="comments" title="Comment" min="0" help="You can provide multiple comments">
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
40 <param name="comment" type="text" size="50" label="Add this comment to BAM dataset"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
41 </repeat>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
42 <param name="remove_duplicates" type="boolean" label="If true do not write duplicates to the output file instead of writing them with appropriate flags set" help="REMOVE_DUPLICATES; default=False"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
43 <param name="assume_sorted" type="boolean" label="Assume the input file is already sorted" checked="true" truevalue="true" falsevalue="false" help="ASSUME_SORTED; default=True"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
44
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
45 <param name="duplicate_scoring_strategy" type="select" label="The scoring strategy for choosing the non-duplicate among candidates" help="DUPLICATE_SCORING_STRATEGY; default=SUM_OF_BASE_QUALITIES">
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
46 <option value="SUM_OF_BASE_QUALITIES">SUM_OF_BASE_QUALITIES</option>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
47 <option value="TOTAL_MAPPED_REFERENCE_LENGTH">TOTAL_MAPPED_REFERENCE_LENGTH</option>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
48 </param>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
49
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
50
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
51 <param name="read_name_regex" type="text" size="40" value="[a-zA-Z0-9]+:[0-9]:([0-9]+):([0-9]+):([0-9]+).*." label="Regular expression that can be used to parse read names in the incoming SAM/BAM dataset" help="READ_NAME_REGEX; Read names are parsed to extract three variables: tile/region, x coordinate and y coordinate. These values are used to estimate the rate of optical duplication in order to give a more accurate estimated library size. See help below for more info; default=[a-zA-Z0-9]+:[0-9]:([0-9]+):([0-9]+):([0-9]+).*.">
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
52 <sanitizer>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
53 <valid initial="string.printable">
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
54 </valid>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
55 </sanitizer>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
56 </param>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
57 <param name="optical_duplicate_pixel_distance" type="integer" value="100" min="0" max="500" label="The maximum offset between two duplicte clusters in order to consider them optical duplicates" help="OPTICAL_DUPLICATE_PIXEL_DISTANCE; default=100"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
58
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
59 <expand macro="VS" />
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
60
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
61 </inputs>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
62
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
63 <outputs>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
64 <data format="txt" name="metrics_file" label="${tool.name} on ${on_string}: MarkDuplicate metrics"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
65 <data format="bam" name="outFile" label="${tool.name} on ${on_string}: MarkDuplicates BAM output"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
66 </outputs>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
67
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
68 <tests>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
69 <test>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
70 <param name="inputFile" value="picard_MarkDuplicates.bam" ftype="bam"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
71 <param name="comment" value="test-run"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
72 <param name="assume_sorted" value="True"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
73 <param name="remove_duplicates" value="True"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
74 <param name="read_name_regex" value="[a-zA-Z0-9]+:[0-9]:([0-9]+):([0-9]+):([0-9]+).*."/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
75 <param name="optical_duplicate_pixel_distance" value="100"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
76 <param name="duplicate_scoring_strategy" value="SUM_OF_BASE_QUALITIES"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
77 <param name="validation_stringency" value="LENIENT"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
78 <output name="outFile" file="picard_MarkDuplicates_test1.bam" ftype="bam" lines_diff="2"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
79 </test>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
80 </tests>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
81
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
82 <stdio>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
83 <exit_code range="1:" level="fatal"/>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
84 </stdio>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
85
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
86 <help>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
87
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
88 **Purpose**
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
89
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
90 Examines aligned records in the supplied SAM or BAM dataset to locate duplicate molecules. All records are then written to the output file with the duplicate records flagged.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
91
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
92 @dataset_collections@
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
93
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
94 @description@
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
95
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
96 COMMENT=String
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
97 CO=String Comment(s) to include in the output file's header. This option may be specified 0 or
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
98 more times.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
99
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
100 REMOVE_DUPLICATES=Boolean If true do not write duplicates to the output file instead of writing them with
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
101 appropriate flags set. Default value: false.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
102
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
103 READ_NAME_REGEX=String Regular expression that can be used to parse read names in the incoming SAM file. Read
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
104 names are parsed to extract three variables: tile/region, x coordinate and y coordinate.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
105 These values are used to estimate the rate of optical duplication in order to give a more
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
106 accurate estimated library size. Set this option to null to disable optical duplicate
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
107 detection. The regular expression should contain three capture groups for the three
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
108 variables, in order. It must match the entire read name. Note that if the default regex
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
109 is specified, a regex match is not actually done, but instead the read name is split on
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
110 colon character. For 5 element names, the 3rd, 4th and 5th elements are assumed to be
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
111 tile, x and y values. For 7 element names (CASAVA 1.8), the 5th, 6th, and 7th elements
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
112 are assumed to be tile, x and y values. Default value:
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
113 [a-zA-Z0-9]+:[0-9]:([0-9]+):([0-9]+):([0-9]+).*.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
114
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
115 DUPLICATE_SCORING_STRATEGY=ScoringStrategy
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
116 DS=ScoringStrategy The scoring strategy for choosing the non-duplicate among candidates. Default value:
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
117 SUM_OF_BASE_QUALITIES. Possible values: {SUM_OF_BASE_QUALITIES, TOTAL_MAPPED_REFERENCE_LENGTH}
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
118
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
119 OPTICAL_DUPLICATE_PIXEL_DISTANCE=Integer
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
120 The maximum offset between two duplicte clusters in order to consider them optical
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
121 duplicates. This should usually be set to some fairly small number (e.g. 5-10 pixels)
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
122 unless using later versions of the Illumina pipeline that multiply pixel values by 10, in
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
123 which case 50-100 is more normal. Default value: 100.
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
124
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
125 @more_info@
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
126
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
127 </help>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
128 </tool>
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
129
3d4f1fa26f0e Uploaded
devteam
parents:
diff changeset
130