0
|
1 <tool id="fastq_to_tabular" name="FASTQ to Tabular" version="1.1.0">
|
|
2 <description>converter</description>
|
|
3 <command interpreter="python">fastq_to_tabular.py '$input_file' '$output_file' $descr_columns '${input_file.extension[len( 'fastq' ):]}'</command>
|
|
4 <inputs>
|
|
5 <param name="input_file" type="data" format="fastqsanger,fastqcssanger,fastqillumina,fastqsolexa" label="FASTQ file to convert" />
|
|
6 <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">
|
|
7 <validator type="in_range" min="1" />
|
|
8 </param>
|
|
9 </inputs>
|
|
10 <outputs>
|
|
11 <data name="output_file" format="tabular" />
|
|
12 </outputs>
|
|
13 <tests>
|
|
14 <!-- basic test -->
|
|
15 <test>
|
|
16 <param name="input_file" value="sanger_full_range_original_sanger.fastqsanger" ftype="fastqsanger" />
|
|
17 <param name="descr_columns" value="1"/>
|
|
18 <output name="output_file" file="fastq_to_tabular_out_1.tabular" />
|
|
19 </test>
|
|
20 <!-- color space test -->
|
|
21 <test>
|
|
22 <param name="input_file" value="sanger_full_range_as_cssanger.fastqcssanger" ftype="fastqcssanger" />
|
|
23 <param name="descr_columns" value="1"/>
|
|
24 <output name="output_file" file="fastq_to_tabular_out_2.tabular" />
|
|
25 </test>
|
|
26 <!-- split title into columns -->
|
|
27 <test>
|
|
28 <param name="input_file" value="sanger_full_range_original_sanger.fastqsanger" ftype="fastqsanger" />
|
|
29 <param name="descr_columns" value="2"/>
|
|
30 <output name="output_file" file="fastq_to_tabular_out_3.tabular" />
|
|
31 </test>
|
|
32 </tests>
|
|
33 <help>
|
|
34
|
|
35 **What it does**
|
|
36
|
|
37 This tool converts FASTQ sequencing reads to a Tabular file.
|
|
38
|
|
39 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.
|
|
40 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**.
|
|
41 In some cases the description can be usefully broken up into more columns -- see the examples .
|
|
42
|
|
43 Tab characters, if present in the source FASTQ title, will be converted to spaces.
|
|
44
|
|
45 -----
|
|
46
|
|
47 **Example**
|
|
48
|
|
49 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)::
|
|
50
|
|
51 @FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95]
|
|
52 tcagTTAAGATGGGATAATATCCTCAGATTGCGTGATGAACTTTGTTCTGGTGGAGGAGAAGGAAGTGCATTCGACGTAT
|
|
53 GCCCGTTTGTCGATATTTGtatttaaagtaatccgtcacaaatcagtgacataaatattatttagatttcgggagcaact
|
|
54 ttatttattccacaagcaggtttaaattttaaatttaaattattgcagaagactttaaattaacctcgttgtcggagtca
|
|
55 tttgttcggttattggtcgaaagtaaccncgggaagtgccgaaaactaacaaacaaaagaagatagtgaaattttaatta
|
|
56 aaanaaatagccaaacgtaactaactaaaacggacccgtcgaggaactgccaacggacgacacagggagtagnnn
|
|
57 +FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95]
|
|
58 FFFDDDDDDDA666?688FFHGGIIIIIIIIIIIIIIIIIIHHHIIIIIIIIIGHGFFFFF====DFFFFFFFFFFFFFF
|
|
59 D???:3104/76=:5...4.3,,,366////4<ABBAAA=CCFDDDDDDDD:666CDFFFF=<ABA=;:333111<===9
|
|
60 9;B889FFFFFFDDBDBDDD=8844231..,,,-,,,,,,,,1133..---17111,,,,,22555131121.--.,333
|
|
61 11,.,,3--,,.,,--,3511123..--!,,,,--,----9,,,,8=,,-,,,-,,,,---26:9:5-..1,,,,11//,
|
|
62 ,,,!,,1917--,,,,-3.,--,,17,,,,---+11113.030000,,,044400036;96662.//;7><;!!!
|
|
63 @FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74]
|
|
64 tcagCCAGCAATTCCGACTTAATTGTTCTTCTTCCATCATTCATCTCGACTAACAGTTCTACGATTAATGAGTTTGGCtt
|
|
65 taatttgttgttcattattgtcacaattacactactgagactgccaaggcacncagggataggnn
|
|
66 +FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74]
|
|
67 FFFFFFFFFDDDDFFFFGFDDDDBAAAAA=<4444@@B=555:BBBBB@@?8:8<?<89898<84442;==3,,,514,,
|
|
68 ,11,,,.,,21777555513,..--1115758.//34488><<;;;;9944/!/4,,,57855!!
|
|
69
|
|
70 By default this is converted into a 3 column tabular file, with the full FASTQ title used as column 1:
|
|
71
|
|
72 =================================================================================================== ============== ==============
|
|
73 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
|
|
74 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
|
|
75 =================================================================================================== ============== ==============
|
|
76
|
|
77 If you specified the title should be turned into 2 columns, you'd get 4 columns in total:
|
|
78
|
|
79 ============== ==================================================================================== ============== ==============
|
|
80 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
|
|
81 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
|
|
82 ============== ==================================================================================== ============== ==============
|
|
83
|
|
84 Similarly, for this example treating the title string as 7 columns makes sense:
|
|
85
|
|
86 ============== ============ ========== =========== ============= ============== =================== ============== ==============
|
|
87 FSRRS4401BE7HA [length=395] [gc=36.46] [flows=800] [phred_min=0] [phred_max=40] [trimmed_length=95] tcagTTAA...nnn FFFDDDDD...!!!
|
|
88 FSRRS4401BRRTC [length=145] [gc=38.62] [flows=800] [phred_min=0] [phred_max=38] [trimmed_length=74] tcagCCAG...gnn FFFFFFFF...5!!
|
|
89 ============== ============ ========== =========== ============= ============== =================== ============== ==============
|
|
90
|
|
91 Note the sequences and quality strings have been truncated for display purposes in the above tables.
|
|
92
|
|
93 ------
|
|
94
|
|
95 **Citation**
|
|
96
|
|
97 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. <http://www.ncbi.nlm.nih.gov/pubmed/20562416>`_
|
|
98
|
|
99
|
|
100 </help>
|
|
101 </tool>
|