<?xml version="1.0" encoding="ascii"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>Bio.SeqIO.QualityIO.FastqPhredWriter</title> <link rel="stylesheet" href="epydoc.css" type="text/css" /> <script type="text/javascript" src="epydoc.js"></script> </head> <body bgcolor="white" text="black" link="blue" vlink="#204080" alink="#204080"> <!-- ==================== NAVIGATION BAR ==================== --> <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0"> <tr valign="middle"> <!-- Tree link --> <th> <a href="module-tree.html">Trees</a> </th> <!-- Index link --> <th> <a href="identifier-index.html">Indices</a> </th> <!-- Help link --> <th> <a href="help.html">Help</a> </th> <th class="navbar" width="100%"></th> </tr> </table> <table width="100%" cellpadding="0" cellspacing="0"> <tr valign="top"> <td width="100%"> <span class="breadcrumbs"> <a href="Bio-module.html">Package Bio</a> :: <a href="Bio.SeqIO-module.html">Package SeqIO</a> :: <a href="Bio.SeqIO.QualityIO-module.html">Module QualityIO</a> :: Class FastqPhredWriter </span> </td> <td> <table cellpadding="0" cellspacing="0"> <!-- hide/show private --> <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink" onclick="toggle_private();">hide private</a>]</span></td></tr> <tr><td align="right"><span class="options" >[<a href="frames.html" target="_top">frames</a >] | <a href="Bio.SeqIO.QualityIO.FastqPhredWriter-class.html" target="_top">no frames</a>]</span></td></tr> </table> </td> </tr> </table> <!-- ==================== CLASS DESCRIPTION ==================== --> <h1 class="epydoc">Class FastqPhredWriter</h1><p class="nomargin-top"><span class="codelink"><a href="Bio.SeqIO.QualityIO-pysrc.html#FastqPhredWriter">source code</a></span></p> <pre class="base-tree"> object --+ | <a href="Bio.SeqIO.Interfaces.SequenceWriter-class.html">Interfaces.SequenceWriter</a> --+ | <a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html">Interfaces.SequentialSequenceWriter</a> --+ | <strong class="uidshort">FastqPhredWriter</strong> </pre> <hr /> <p>Class to write standard FASTQ format files (using PHRED quality scores).</p> <p>Although you can use this class directly, you are strongly encouraged to use the Bio.SeqIO.write() function instead via the format name "fastq" or the alias "fastq-sanger". For example, this code reads in a standard Sanger style FASTQ file (using PHRED scores) and re-saves it as another Sanger style FASTQ file:</p> <pre class="py-doctest"> <span class="py-prompt">>>> </span><span class="py-keyword">from</span> Bio <span class="py-keyword">import</span> SeqIO <span class="py-prompt">>>> </span>record_iterator = SeqIO.parse(open(<span class="py-string">"Quality/example.fastq"</span>), <span class="py-string">"fastq"</span>) <span class="py-prompt">>>> </span>out_handle = open(<span class="py-string">"Quality/temp.fastq"</span>, <span class="py-string">"w"</span>) <span class="py-prompt">>>> </span>SeqIO.write(record_iterator, out_handle, <span class="py-string">"fastq"</span>) <span class="py-output">3</span> <span class="py-output"></span><span class="py-prompt">>>> </span>out_handle.close()</pre> <p>You might want to do this if the original file included extra line breaks, which while valid may not be supported by all tools. The output file from Biopython will have each sequence on a single line, and each quality string on a single line (which is considered desirable for maximum compatibility).</p> <p>In this next example, an old style Solexa/Illumina FASTQ file (using Solexa quality scores) is converted into a standard Sanger style FASTQ file using PHRED qualities:</p> <pre class="py-doctest"> <span class="py-prompt">>>> </span><span class="py-keyword">from</span> Bio <span class="py-keyword">import</span> SeqIO <span class="py-prompt">>>> </span>record_iterator = SeqIO.parse(open(<span class="py-string">"Quality/solexa_example.fastq"</span>), <span class="py-string">"fastq-solexa"</span>) <span class="py-prompt">>>> </span>out_handle = open(<span class="py-string">"Quality/temp.fastq"</span>, <span class="py-string">"w"</span>) <span class="py-prompt">>>> </span>SeqIO.write(record_iterator, out_handle, <span class="py-string">"fastq"</span>) <span class="py-output">5</span> <span class="py-output"></span><span class="py-prompt">>>> </span>out_handle.close()</pre> <p>This code is also called if you use the .format("fastq") method of a SeqRecord, or .format("fastq-sanger") if you prefer that alias.</p> <p>Note that Sanger FASTQ files have an upper limit of PHRED quality 93, which is encoded as ASCII 126, the tilde. If your quality scores are truncated to fit, a warning is issued.</p> <p>P.S. To avoid cluttering up your working directory, you can delete this temporary file now:</p> <pre class="py-doctest"> <span class="py-prompt">>>> </span><span class="py-keyword">import</span> os <span class="py-prompt">>>> </span>os.remove(<span class="py-string">"Quality/temp.fastq"</span>)</pre> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> <table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr bgcolor="#70b0f0" class="table-header"> <td colspan="2" class="table-header"> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr valign="top"> <td align="left"><span class="table-header">Instance Methods</span></td> <td align="right" valign="top" ><span class="options">[<a href="#section-InstanceMethods" class="privatelink" onclick="toggle_private();" >hide private</a>]</span></td> </tr> </table> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td><span class="summary-sig"><a href="Bio.SeqIO.QualityIO.FastqPhredWriter-class.html#write_record" class="summary-sig-name">write_record</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">record</span>)</span><br /> Write a single FASTQ record to the file.</td> <td align="right" valign="top"> <span class="codelink"><a href="Bio.SeqIO.QualityIO-pysrc.html#FastqPhredWriter.write_record">source code</a></span> </td> </tr> </table> </td> </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html">Interfaces.SequentialSequenceWriter</a></code></b>: <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#__init__">__init__</a></code>, <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#write_file">write_file</a></code>, <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#write_footer">write_footer</a></code>, <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#write_header">write_header</a></code>, <code><a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#write_records">write_records</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="Bio.SeqIO.Interfaces.SequenceWriter-class.html">Interfaces.SequenceWriter</a></code></b>: <code><a href="Bio.SeqIO.Interfaces.SequenceWriter-class.html#clean">clean</a></code> </p> <div class="private"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="Bio.SeqIO.Interfaces.SequenceWriter-class.html">Interfaces.SequenceWriter</a></code></b> (private): <code><a href="Bio.SeqIO.Interfaces.SequenceWriter-class.html#_get_seq_string" onclick="show_private();">_get_seq_string</a></code> </p></div> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, <code>__format__</code>, <code>__getattribute__</code>, <code>__hash__</code>, <code>__new__</code>, <code>__reduce__</code>, <code>__reduce_ex__</code>, <code>__repr__</code>, <code>__setattr__</code>, <code>__sizeof__</code>, <code>__str__</code>, <code>__subclasshook__</code> </p> </td> </tr> </table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr bgcolor="#70b0f0" class="table-header"> <td colspan="2" class="table-header"> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr valign="top"> <td align="left"><span class="table-header">Properties</span></td> <td align="right" valign="top" ><span class="options">[<a href="#section-Properties" class="privatelink" onclick="toggle_private();" >hide private</a>]</span></td> </tr> </table> </td> </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__class__</code> </p> </td> </tr> </table> <!-- ==================== METHOD DETAILS ==================== --> <a name="section-MethodDetails"></a> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr bgcolor="#70b0f0" class="table-header"> <td colspan="2" class="table-header"> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr valign="top"> <td align="left"><span class="table-header">Method Details</span></td> <td align="right" valign="top" ><span class="options">[<a href="#section-MethodDetails" class="privatelink" onclick="toggle_private();" >hide private</a>]</span></td> </tr> </table> </td> </tr> </table> <a name="write_record"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">write_record</span>(<span class="sig-arg">self</span>, <span class="sig-arg">record</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="Bio.SeqIO.QualityIO-pysrc.html#FastqPhredWriter.write_record">source code</a></span> </td> </tr></table> <p>Write a single FASTQ record to the file.</p> <dl class="fields"> <dt>Overrides: <a href="Bio.SeqIO.Interfaces.SequentialSequenceWriter-class.html#write_record">Interfaces.SequentialSequenceWriter.write_record</a> </dt> </dl> </td></tr></table> </div> <br /> <!-- ==================== NAVIGATION BAR ==================== --> <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0"> <tr valign="middle"> <!-- Tree link --> <th> <a href="module-tree.html">Trees</a> </th> <!-- Index link --> <th> <a href="identifier-index.html">Indices</a> </th> <!-- Help link --> <th> <a href="help.html">Help</a> </th> <th class="navbar" width="100%"></th> </tr> </table> <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> Generated by Epydoc 3.0.1 on Thu Aug 18 18:22:16 2011 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" >http://epydoc.sourceforge.net</a> </td> </tr> </table> <script type="text/javascript"> <!-- // Private objects are initially displayed (because if // javascript is turned off then we want them to be // visible); but by default, we want to hide them. So hide // them unless we have a cookie that says to show them. checkCookie(); // --> </script> </body> </html>