annotate picard_DownsampleSam.xml @ 55:26f0e472c09f draft

Uploaded
author devteam
date Tue, 18 Feb 2014 15:51:59 -0500
parents 0a8761ed9d53
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
32
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
1 <tool name="Downsample SAM" id="picard_DownsampleSam" version="1.106.0">
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
2 <!-- found on https://bitbucket.org/bwlang/galaxy-dist/src/ca5ded2e18a9ef802c31429e3cb861e8775b24d0/tools/picard/picard_DownsampleSam.xml -->
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
3 <requirements><requirement type="package" version="1.106.0">picard</requirement></requirements>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
4 <command interpreter="python">
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
5 picard_wrapper.py
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
6 --input=$inputFile
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
7 --output=$outFile
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
8 --probability=$probability
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
9 --seed=$seed
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
10 -j "\$JAVA_JAR_PATH/DownsampleSam.jar"
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
11 </command>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
12 <inputs>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
13 <param format="sam" name="inputFile" type="data" label="SAM dataset to be downsampled"
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
14 help="If empty, upload or import a SAM dataset." />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
15 <param name="probability" type="float" size="5" label="Probability (between 0 and 1) that any given read will be kept" help="specify 1 to keep all reads, 0.1 to keep 10% of the reads" value="1" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
16 <param name="seed" type="integer" size="5" label="Random seed value" help="(same seed + same probability = same set of reads kept)" value="1" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
17
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
18 </inputs>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
19 <outputs>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
20 <data name="outFile" format="sam" label="${tool.name} on ${on_string}">
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
21 </data>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
22 </outputs>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
23 <tests>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
24 <test>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
25 <param name="inputFile" value="cleansamtestinput.sam" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
26 <param name="probability" value="0.1" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
27 <param name="seed" value="2" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
28 <output name="outFile" file="downsamplesamoutput.sam" ftype="sam" />
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
29 </test>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
30 </tests>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
31 <help>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
32
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
33 .. class:: infomark
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
34
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
35 **Purpose**
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
36
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
37 Randomly down-sample a SAM or BAM file to retain a random subset of the reads. Mate-pairs are either both kept or both discarded. Reads marked as not primary alignments are all discarded. Each read is given a probability P of being retained - results with the exact same input in the same order and with the same value for RANDOM_SEED will produce the same results.
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
38
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
39 **Picard documentation**
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
40
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
41 This is a Galaxy wrapper for DownsampleSam, a part of the external package Picard-tools_.
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
42
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
43 .. _Picard-tools: http://www.google.com/search?q=picard+samtools
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
44
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
45 ------
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
46
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
47 .. class:: warningmark
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
48
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
49 **Warning on SAM/BAM quality**
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
50
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
51 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**
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
52 flag when it runs Picard, which allows reads to be discarded if they're empty or don't map. This appears
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
53 to be the only way to deal with SAM/BAM that cannot be parsed.
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
54
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
55
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
56 </help>
0a8761ed9d53 Uploaded
devteam
parents:
diff changeset
57 </tool>