annotate rgPicardFixMate.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="Paired Read Mate Fixer" id="rgPicFixMate" 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 <command interpreter="python">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
4 picard_wrapper.py -i "$input_file" -o "$out_file" --tmpdir "${__new_file_path__}" -n "$out_prefix"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
5 --output-format "$outputFormat" -j "\$JAVA_JAR_PATH/FixMateInformation.jar" --sortorder "$sortOrder"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
6 </command>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
7 <requirements><requirement type="package" version="1.56.0">picard</requirement></requirements>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
8 <inputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
9 <param format="bam,sam" name="input_file" type="data" label="SAM/BAM dataset to fix"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
10 help="If empty, upload or import a SAM/BAM dataset."/>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
11 <param name="sortOrder" type="select" help="If in doubt, leave as default and read Picard/Samtools documentation"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
12 label="Sort order">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
13 <option value="coordinate" selected ="true">Coordinate sort</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
14 <option value="queryname">Query name sort</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
15 <option value="unsorted">Unsorted - docs not clear if this means unchanged or not</option>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
16 </param>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
17 <param name="out_prefix" value="Fix Mate" type="text"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
18 label="Title for the output file" help="Use this remind you what the job was for." size="80" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
19 <param name="outputFormat" type="boolean" checked="True" truevalue="bam" falsevalue="sam" label="Output BAM instead of SAM" help="Uncheck for SAM output" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
20 </inputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
21 <outputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
22 <data format="bam" name="out_file" label="${tool.name} on ${on_string}: ${outputFormat} with fixed mates">
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
23 <change_format>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
24 <when input="outputFormat" value="sam" format="sam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
25 </change_format>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
26 </data>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
27 </outputs>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
28 <tests>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
29 <test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
30 <param name="input_file" value="picard_input_sorted_pair.sam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
31 <param name="sortOrder" value="coordinate" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
32 <param name="outputFormat" value="True" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
33 <param name="out_prefix" value="Test FixMate" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
34 <output name="out_file" file="picard_output_fixmate_sorted_pair.bam" ftype="bam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
35 </test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
36 <test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
37 <param name="input_file" value="picard_input_sorted_pair.sam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
38 <param name="sortOrder" value="coordinate" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
39 <param name="outputFormat" value="False" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
40 <param name="out_prefix" value="Test FixMate" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
41 <output name="out_file" file="picard_output_fixmate_sorted_pair.sam" ftype="sam" />
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
42 </test>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
43 </tests>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
44 <help>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
45
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
46
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
47 .. class:: infomark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
48
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
49 **Purpose**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
50
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
51 Ensure that all mate-pair information is in sync between each read and it's mate pair.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
52
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
53 **Picard documentation**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
54
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
55 This is a Galaxy wrapper for FixMateInformation, a part of the external package Picard-tools_.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
56
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
57 .. _Picard-tools: http://www.google.com/search?q=picard+samtools
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
58
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
59 .. class:: warningmark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
60
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
61 **Useful for paired data only**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
62
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
63 Likely won't do anything helpful for single end sequence data
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
64 Currently, Galaxy doesn't distinguish paired from single ended SAM/BAM so make sure
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
65 the data you choose are valid (paired end) SAM or BAM data - unless you trust this
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
66 tool not to harm your data.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
67
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
68 -----
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
69
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
70 .. class:: infomark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
71
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
72 **Syntax**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
73
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
74 - **Input** - a paired read sam/bam format aligned short read data in your current history
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
75 - **Sort order** - can be used to adjust the ordering of reads
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
76 - **Title** - the title to use for all output files from this job - use it for high level metadata
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
77 - **Output Format** - either SAM or compressed as BAM
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
78
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
79 -----
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
80
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
81 .. class:: infomark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
82
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
83 **Inputs, outputs, and parameters**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
84
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
85 .. csv-table::
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
86
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
87 :header-rows: 1
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
88
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
89 Option,Description
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
90 "INPUT=File","The input file to fix. This option may be specified 0 or more times."
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
91 "OUTPUT=File","The output file to write to"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
92 "SORT_ORDER=SortOrder","Optional sort order if the OUTPUT file should be sorted differently than the INPUT file. Default value: null. Possible values: {unsorted, queryname, coordinate}"
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
93 "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
94
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
95 .. class:: warningmark
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
96
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
97 **Warning on SAM/BAM quality**
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
98
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
99 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
100 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
101 to be the only way to deal with SAM/BAM that cannot be parsed.
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
102
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
103
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
104 </help>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
105 </tool>
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
106
1cd7f3b42609 Uploaded tool.
devteam
parents:
diff changeset
107