annotate rgPicardInsertSize.xml @ 0:1cd7f3b42609

Uploaded tool.
author devteam
date Tue, 23 Oct 2012 13:14:29 -0400
parents
children 9227b8c3093b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
1 <tool name="Insertion size metrics" id="PicardInsertSize" version="1.56.0">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
2 <description>for PAIRED data</description>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
3 <requirements><requirement type="package" version="1.56.0">picard</requirement></requirements>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
4 <command interpreter="python">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
5 picard_wrapper.py -i "$input_file" -n "$out_prefix" --tmpdir "${__new_file_path__}" --deviations "$deviations"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
6 --histwidth "$histWidth" --minpct "$minPct" --malevel "$malevel"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
7 -j "\$JAVA_JAR_PATH/CollectInsertSizeMetrics.jar" -d "$html_file.files_path" -t "$html_file"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
8 </command>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
9 <inputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
10 <param format="bam,sam" name="input_file" type="data" label="SAM/BAM dataset to generate statistics for"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
11 help="If empty, upload or import a SAM/BAM dataset."/>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
12 <param name="out_prefix" value="Insertion size metrics" type="text"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
13 label="Title for the output file" help="Use this remind you what the job was for" size="120" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
14 <param name="deviations" value="10.0" type="float"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
15 label="Deviations" size="5"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
16 help="See Picard documentation: Generate mean, sd and plots by trimming the data down to MEDIAN + DEVIATIONS*MEDIAN_ABSOLUTE_DEVIATION" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
17 <param name="histWidth" value="0" type="integer"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
18 label="Histogram width" size="5"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
19 help="Explicitly sets the histogram width option - leave 0 to ignore" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
20 <param name="minPct" value="0.05" type="float"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
21 label="Minimum percentage" size="5"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
22 help="Discard any data categories (out of FR, TANDEM, RF) that have fewer than this percentage of overall reads" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
23 <param name="malevel" value="0" type="select" multiple="true" label="Metric Accumulation Level"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
24 help="Level(s) at which metrics will be accumulated">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
25 <option value="ALL_READS" selected="true">All reads (default)</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
26 <option value="SAMPLE" default="true">Sample</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
27 <option value="LIBRARY" default="true">Library</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
28 <option value="READ_GROUP" default="true">Read group</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
29 </param>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
30 </inputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
31 <outputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
32 <data format="html" name="html_file" label="InsertSize_${out_prefix}.html"/>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
33 </outputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
34 <tests>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
35 <test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
36 <param name="input_file" value="picard_input_tiny.sam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
37 <param name="out_prefix" value="Insertion size metrics" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
38 <param name="deviations" value="10.0" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
39 <param name="histWidth" value="0" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
40 <param name="minPct" value="0.01" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
41 <param name="malevel" value="ALL_READS" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
42 <output name="html_file" file="picard_output_insertsize_tinysam.html" ftype="html" compare="contains" lines_diff="40" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
43 </test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
44 </tests>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
45 <help>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
46
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
47
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
48 .. class:: infomark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
49
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
50 **Purpose**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
51
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
52 Reads a SAM or BAM file and describes the distribution
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
53 of insert size (excluding duplicates) with metrics and a histogram plot.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
54
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
55 **Picard documentation**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
56
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
57 This is a Galaxy wrapper for CollectInsertSizeMetrics, a part of the external package Picard-tools_.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
58
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
59 .. _Picard-tools: http://www.google.com/search?q=picard+samtools
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
60
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
61 .. class:: warningmark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
62
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
63 **Useful for paired data only**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
64
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
65 This tool works for paired data only and can be expected to fail for single end data.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
66
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
67 -----
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
68
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
69 .. class:: infomark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
70
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
71 **Inputs, outputs, and parameters**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
72
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
73 Picard documentation says (reformatted for Galaxy):
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
74
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
75 .. csv-table::
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
76 :header-rows: 1
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
77
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
78 Option,Description
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
79 "INPUT=File","SAM or BAM file Required."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
80 "OUTPUT=File","File to write insert size metrics to Required."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
81 "HISTOGRAM_FILE=File","File to write insert size histogram chart to Required."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
82 "TAIL_LIMIT=Integer","When calculating mean and stdev stop when the bins in the tail of the distribution contain fewer than mode/TAIL_LIMIT items. This also limits how much data goes into each data category of the histogram."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
83 "HISTOGRAM_WIDTH=Integer","Explicitly sets the histogram width, overriding the TAIL_LIMIT option. Also, when calculating mean and stdev, only bins LE HISTOGRAM_WIDTH will be included. "
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
84 "MINIMUM_PCT=Float","When generating the histogram, discard any data categories (out of FR, TANDEM, RF) that have fewer than this percentage of overall reads. (Range: 0 to 1) Default value: 0.01."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
85 "STOP_AFTER=Integer","Stop after processing N reads, mainly for debugging. Default value: 0."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
86 "CREATE_MD5_FILE=Boolean","Whether to create an MD5 digest for any BAM files created. Default value: false."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
87
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
88 .. class:: warningmark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
89
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
90 **Warning on SAM/BAM quality**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
91
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
92 Many SAM/BAM files produced externally and uploaded to Galaxy do not fully conform to SAM/BAM specifications. Galaxy deals with this by using the **LENIENT**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
93 flag when it runs Picard, which allows reads to be discarded if they're empty or don't map. This appears
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
94 to be the only way to deal with SAM/BAM that cannot be parsed.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
95
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
96 </help>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
97 </tool>