annotate picard_SamFormatConverter.xml @ 21:c2f6ec2fee7e draft

Uploaded
author devteam
date Tue, 11 Feb 2014 18:42:41 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
21
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
1 <tool name="Picard SAM Format Converter" id="picard_SFC" version="0.1.0">
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
2 <requirements><requirement type="package">picard</requirement></requirements>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
3 <command interpreter="python">
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
4 picard_wrapper.py
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
5 --input="$inputFile"
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
6 --output-format=$outputFormat
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
7 --output=$outFile
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
8 -j "\$JAVA_JAR_PATH/SamFormatConverter.jar"
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
9 </command>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
10 <inputs>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
11 <param format="bam,sam" name="inputFile" type="data" label="SAM/BAM"
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
12 help="If empty, upload or import a SAM/BAM dataset." />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
13 <param name="outputFormat" type="boolean" checked="True" truevalue="bam" falsevalue="sam" label="Output bam instead of sam" help="Uncheck for sam output"/>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
14 </inputs>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
15 <outputs>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
16 <data name="outFile" format="bam" label="${tool.name} on ${on_string}: ${outputFormat} with read groups replaced">
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
17 <change_format>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
18 <when input="outputFormat" value="sam" format="sam" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
19 </change_format>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
20 </data>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
21 </outputs>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
22 <tests>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
23 <test>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
24 <!-- Command for replacing read groups in bam:
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
25 java -jar SamFormatConverter.jar VALIDATION_STRINGENCY=LENIENT I=test-data/picard_SFC_input1.sam O=picard_SFC_output1.samĀ·
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
26 -->
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
27 <param name="inputFile" value="picard_ARRG_input1.bam" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
28 <param name="outputFormat" value="False" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
29 <output name="outFile" file="picard_ARRG_output1.sam" ftype="sam" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
30 </test>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
31 <test>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
32 <!-- Command for replacing read groups in sam:
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
33 java -jar AddOrReplaceReadGroups.jar VALIDATION_STRINGENCY=LENIENT I=test-data/picard_ARRG_input1.sam O=picard_ARRG_output2.sam RGLB=LIB RGPL=IL RGPU=PL
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
34 picard_ARRG_input1.bam can be created from picard_ARRG_input1.sam
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
35 -->
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
36 <param name="inputFile" value="picard_ARRG_input1.sam" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
37 <output name="outFile" file="picard_ARRG_output2.sam" ftype="sam" />
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
38 </test>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
39 </tests>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
40 <help>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
41
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
42 .. class:: infomark
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
43
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
44 **Purpose**
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
45
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
46 Convert a BAM file to a SAM file, or BAM to SAM.
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
47
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
48 This is a Galaxy wrapper for SamFormatConverter, a part of the external package Picard-tools_.
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
49
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
50 .. _Picard-tools: http://www.google.com/search?q=picard+samtools
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
51
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
52 ------
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
53
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
54 .. class:: infomark
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
55
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
56 **Inputs, outputs, and parameters**
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
57
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
58 Either a sam file or a bam file must be supplied. If a bam file is used, it must
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
59 be coordinate-sorted. Galaxy currently coordinate-sorts all bam files.
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
60
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
61 The output file is either bam (the default) or sam, according to user selection,
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
62 and contains the same information as the input file except for the appropraite
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
63 additional (or modified) read group tags. Bam is recommended since it is smaller.
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
64
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
65 **Warning on SAM/BAM quality**
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
66
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
67 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**
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
68 flag when it runs Picard, which allows reads to be discarded if they're empty or don't map. This appears
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
69 to be the only way to deal with SAM/BAM that cannot be parsed.
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
70
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
71
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
72 </help>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
73 </tool>
c2f6ec2fee7e Uploaded
devteam
parents:
diff changeset
74