annotate tools/fastq/fastq_paired_unpaired.xml @ 3:528ba9c896e0 draft

Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
author peterjc
date Wed, 18 Sep 2013 06:13:27 -0400
parents 95a632a71951
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
1 <tool id="fastq_paired_unpaired" name="Divide FASTQ file into paired and unpaired reads" version="0.0.7">
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
2 <description>using the read name suffices</description>
2
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
3 <version_command interpreter="python">fastq_paired_unpaired.py --version</version_command>
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
4 <command interpreter="python">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
5 fastq_paired_unpaired.py $input_fastq.extension $input_fastq
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
6 #if $output_choice_cond.output_choice=="separate"
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
7 $output_forward $output_reverse
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
8 #elif $output_choice_cond.output_choice=="interleaved"
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
9 $output_paired
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
10 #end if
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
11 $output_singles
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
12 </command>
2
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
13 <stdio>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
14 <!-- Anything other than zero is an error -->
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
15 <exit_code range="1:" />
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
16 <exit_code range=":-1" />
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
17 </stdio>
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
18 <inputs>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
19 <param name="input_fastq" type="data" format="fastq" label="FASTQ file to divide into paired and unpaired reads"/>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
20 <conditional name="output_choice_cond">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
21 <param name="output_choice" type="select" label="How to output paired reads?">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
22 <option value="separate">Separate (two FASTQ files, for the forward and reverse reads, in matching order).</option>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
23 <option value="interleaved">Interleaved (one FASTQ file, alternating forward read then partner reverse read).</option>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
24 </param>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
25 <!-- Seems need these dummy entries here, compare this to indels/indel_sam2interval.xml -->
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
26 <when value="separate" />
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
27 <when value="interleaved" />
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
28 </conditional>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
29 </inputs>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
30 <outputs>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
31 <data name="output_singles" format="input" label="Orphan or single reads"/>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
32 <data name="output_forward" format="input" label="Forward paired reads">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
33 <filter>output_choice_cond["output_choice"] == "separate"</filter>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
34 </data>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
35 <data name="output_reverse" format="input" label="Reverse paired reads">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
36 <filter>output_choice_cond["output_choice"] == "separate"</filter>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
37 </data>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
38 <data name="output_paired" format="input" label="Interleaved paired reads">
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
39 <filter>output_choice_cond["output_choice"] == "interleaved"</filter>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
40 </data>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
41 </outputs>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
42 <tests>
2
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
43 <test>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
44 <param name="input_fastq" value="sanger-pairs-mixed.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
45 <param name="output_choice" value="separate"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
46 <output name="output_singles" file="sanger-pairs-singles.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
47 <output name="output_forward" file="sanger-pairs-forward.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
48 <output name="output_reverse" file="sanger-pairs-reverse.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
49 </test>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
50 <test>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
51 <param name="input_fastq" value="sanger-pairs-mixed.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
52 <param name="output_choice" value="interleaved"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
53 <output name="output_singles" file="sanger-pairs-singles.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
54 <output name="output_paired" file="sanger-pairs-interleaved.fastq" ftype="fastq"/>
95a632a71951 Uploaded v0.0.6, adds unit test
peterjc
parents: 1
diff changeset
55 </test>
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
56 </tests>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
57 <help>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
58
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
59 **What it does**
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
60
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
61 Using the common read name suffix conventions, it divides a FASTQ file into
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
62 paired reads, and orphan or single reads.
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
63
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
64 The input file should be a valid FASTQ file which has been sorted so that
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
65 any partner forward+reverse reads are consecutive. The output files all
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
66 preserve this sort order. Pairing are recognised based on standard name
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
67 suffices. See below or run the tool with no arguments for more details.
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
68
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
69 Any reads where the forward/reverse naming suffix used is not recognised
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
70 are treated as orphan reads. The tool supports the /1 and /2 convention
1
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
71 originally used by Illumina, .f and .r convention, the Sanger convention
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
72 (see http://staden.sourceforge.net/manual/pregap4_unix_50.html for details),
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
73 and the current Illumina convention where the reads get the same identifier
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
74 with the fragment number in the description, for example:
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
75
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
76 * @HWI-ST916:79:D04M5ACXX:1:1101:10000:100326 1:N:0:TGNCCA
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
77 * @HWI-ST916:79:D04M5ACXX:1:1101:10000:100326 2:N:0:TGNCCA
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
78
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
79 Note that this does support multiple forward and reverse reads per template
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
80 (which is quite common with Sanger sequencing), e.g. this which is sorted
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
81 alphabetically:
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
82
1
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
83 * WTSI_1055_4p17.p1kapIBF
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
84 * WTSI_1055_4p17.p1kpIBF
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
85 * WTSI_1055_4p17.q1kapIBR
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
86 * WTSI_1055_4p17.q1kpIBR
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
87
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
88 or this where the reads already come in pairs:
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
89
1
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
90 * WTSI_1055_4p17.p1kapIBF
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
91 * WTSI_1055_4p17.q1kapIBR
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
92 * WTSI_1055_4p17.p1kpIBF
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
93 * WTSI_1055_4p17.q1kpIBR
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
94
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
95 both become:
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
96
1
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
97 * WTSI_1055_4p17.p1kapIBF paired with WTSI_1055_4p17.q1kapIBR
7ed81e36fc1c Uploaded v0.0.5 which handles Illumina 1.8 style pair naming.
peterjc
parents: 0
diff changeset
98 * WTSI_1055_4p17.p1kpIBF paired with WTSI_1055_4p17.q1kpIBR
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
99
3
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
100 **References**
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
101
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
102 If you use this Galaxy tool in work leading to a scientific publication please
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
103 cite the following paper:
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
104
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
105 Peter J.A. Cock, Björn A. Grüning, Konrad Paszkiewicz and Leighton Pritchard (2013).
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
106 Galaxy tools and workflows for sequence analysis with applications
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
107 in molecular plant pathology. PeerJ 1:e167
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
108 http://dx.doi.org/10.7717/peerj.167
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
109
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
110 This tool is available to install into other Galaxy Instances via the Galaxy
528ba9c896e0 Uploaded v0.0.8, MIT licence and reST for README, citation information, development moved to GitHub
peterjc
parents: 2
diff changeset
111 Tool Shed at http://toolshed.g2.bx.psu.edu/view/peterjc/fastq_paired_unpaired
0
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
112 </help>
72e9fcaec61f Migrated tool version 0.0.4 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
113 </tool>