annotate fastq_to_tabular.xml @ 0:e018cfd2dc02 draft

Imported from capsule None
author devteam
date Thu, 23 Jan 2014 12:31:52 -0500
parents
children 81c9b58760ff
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
1 <tool id="fastq_to_tabular" name="FASTQ to Tabular" version="1.1.0">
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
2 <description>converter</description>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
3 <requirements>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
4 <requirement type="package" version="1.0.0">galaxy_sequence_utils</requirement>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
5 </requirements>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
6 <command interpreter="python">fastq_to_tabular.py '$input_file' '$output_file' $descr_columns '${input_file.extension[len( 'fastq' ):]}'</command>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
7 <inputs>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
8 <param name="input_file" type="data" format="fastqsanger,fastqcssanger,fastqillumina,fastqsolexa" label="FASTQ file to convert" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
9 <param name="descr_columns" type="integer" size="2" value="1" label="How many columns to divide title string into?" help="Typically 2 to take the ID (first word) and decription (rest) as two columns, or 1 to give a single column">
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
10 <validator type="in_range" min="1" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
11 </param>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
12 </inputs>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
13 <outputs>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
14 <data name="output_file" format="tabular" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
15 </outputs>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
16 <tests>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
17 <!-- basic test -->
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
18 <test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
19 <param name="input_file" value="sanger_full_range_original_sanger.fastqsanger" ftype="fastqsanger" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
20 <param name="descr_columns" value="1"/>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
21 <output name="output_file" file="fastq_to_tabular_out_1.tabular" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
22 </test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
23 <!-- color space test -->
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
24 <test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
25 <param name="input_file" value="sanger_full_range_as_cssanger.fastqcssanger" ftype="fastqcssanger" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
26 <param name="descr_columns" value="1"/>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
27 <output name="output_file" file="fastq_to_tabular_out_2.tabular" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
28 </test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
29 <!-- split title into columns -->
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
30 <test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
31 <param name="input_file" value="sanger_full_range_original_sanger.fastqsanger" ftype="fastqsanger" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
32 <param name="descr_columns" value="2"/>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
33 <output name="output_file" file="fastq_to_tabular_out_3.tabular" />
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
34 </test>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
35 </tests>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
36 <help>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
37
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
38 **What it does**
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
39
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
40 This tool converts FASTQ sequencing reads to a Tabular file.
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
41
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
42 It is conventional to take the first word of the FASTQ "@" title line as the identifier, and any remaining text to be a free form description.
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
43 It is therefore often useful to split this text into two columns in Galaxy (identifier and any description) by setting **How many columns to divide title string into?** to **2**.
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
44 In some cases the description can be usefully broken up into more columns -- see the examples .
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
45
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
46 Tab characters, if present in the source FASTQ title, will be converted to spaces.
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
47
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
48 -----
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
49
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
50 **Example**
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
51
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
52 Consider the following two 454 reads in Sanger FASTQ format (using line wrapping for display, but do note not all tools will accept line wrapped FASTQ files)::
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
53
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
54 @FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95]
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
55 tcagTTAAGATGGGATAATATCCTCAGATTGCGTGATGAACTTTGTTCTGGTGGAGGAGAAGGAAGTGCATTCGACGTAT
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
56 GCCCGTTTGTCGATATTTGtatttaaagtaatccgtcacaaatcagtgacataaatattatttagatttcgggagcaact
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
57 ttatttattccacaagcaggtttaaattttaaatttaaattattgcagaagactttaaattaacctcgttgtcggagtca
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
58 tttgttcggttattggtcgaaagtaaccncgggaagtgccgaaaactaacaaacaaaagaagatagtgaaattttaatta
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
59 aaanaaatagccaaacgtaactaactaaaacggacccgtcgaggaactgccaacggacgacacagggagtagnnn
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
60 +FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95]
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
61 FFFDDDDDDDA666?688FFHGGIIIIIIIIIIIIIIIIIIHHHIIIIIIIIIGHGFFFFF====DFFFFFFFFFFFFFF
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
62 D???:3104/76=:5...4.3,,,366////4&lt;ABBAAA=CCFDDDDDDDD:666CDFFFF=&lt;ABA=;:333111&lt;===9
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
63 9;B889FFFFFFDDBDBDDD=8844231..,,,-,,,,,,,,1133..---17111,,,,,22555131121.--.,333
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
64 11,.,,3--,,.,,--,3511123..--!,,,,--,----9,,,,8=,,-,,,-,,,,---26:9:5-..1,,,,11//,
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
65 ,,,!,,1917--,,,,-3.,--,,17,,,,---+11113.030000,,,044400036;96662.//;7&gt;&lt;;!!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
66 @FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74]
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
67 tcagCCAGCAATTCCGACTTAATTGTTCTTCTTCCATCATTCATCTCGACTAACAGTTCTACGATTAATGAGTTTGGCtt
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
68 taatttgttgttcattattgtcacaattacactactgagactgccaaggcacncagggataggnn
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
69 +FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74]
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
70 FFFFFFFFFDDDDFFFFGFDDDDBAAAAA=&lt;4444@@B=555:BBBBB@@?8:8&lt;?&lt;89898&lt;84442;==3,,,514,,
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
71 ,11,,,.,,21777555513,..--1115758.//34488&gt;&lt;&lt;;;;;9944/!/4,,,57855!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
72
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
73 By default this is converted into a 3 column tabular file, with the full FASTQ title used as column 1:
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
74
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
75 =================================================================================================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
76 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
77 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
78 =================================================================================================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
79
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
80 If you specified the title should be turned into 2 columns, you'd get 4 columns in total:
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
81
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
82 ============== ==================================================================================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
83 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
84 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
85 ============== ==================================================================================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
86
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
87 Similarly, for this example treating the title string as 7 columns makes sense:
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
88
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
89 ============== ============ ========== =========== ============= ============== =================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
90 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
91 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
92 ============== ============ ========== =========== ============= ============== =================== ============== ==============
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
93
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
94 Note the sequences and quality strings have been truncated for display purposes in the above tables.
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
95
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
96 ------
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
97
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
98 **Citation**
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
99
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
100 If you use this tool, please cite `Blankenberg D, Gordon A, Von Kuster G, Coraor N, Taylor J, Nekrutenko A; Galaxy Team. Manipulation of FASTQ data with Galaxy. Bioinformatics. 2010 Jul 15;26(14):1783-5. &lt;http://www.ncbi.nlm.nih.gov/pubmed/20562416&gt;`_
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
101
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
102
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
103 </help>
e018cfd2dc02 Imported from capsule None
devteam
parents:
diff changeset
104 </tool>