<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Fixed-width Gallery — Astropy v0.2.4</title>
<link rel="stylesheet" href="../../_static/bootstrap-astropy.css" type="text/css" />
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../../',
VERSION: '0.2.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../../_static/jquery.js"></script>
<script type="text/javascript" src="../../_static/underscore.js"></script>
<script type="text/javascript" src="../../_static/doctools.js"></script>
<script type="text/javascript" src="../../_static/sidebar.js"></script>
<link rel="shortcut icon" href="../../_static/astropy_logo.ico"/>
<link rel="top" title="Astropy v0.2.4" href="../../index.html" />
<link rel="up" title="ASCII Tables (astropy.io.ascii)" href="index.html" />
<link rel="next" title="Base class elements" href="base_classes.html" />
<link rel="prev" title="Writing tables" href="write.html" />
</head>
<body>
<div class="topbar">
<a class="brand" title="Documentation Home" href="../../index.html"></a>
<ul>
<li><a class="homelink" title="AstroPy Homepage" href="http://www.astropy.org"></a></li>
<li><a title="General Index" href="../../genindex.html">Index</a></li>
<li><a title="Python Module Index" href="../../py-modindex.html">Modules</a></li>
<li>
<form action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</li>
</ul>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right">
<a href="base_classes.html" title="Base class elements">
next »
</a>
</li>
<li class="right">
<a href="write.html" title="Writing tables">
« previous
</a>
|
</li>
<li>
<a href="../../index.html">Astropy v0.2.4</a>
»
</li>
<li><a href="index.html" accesskey="U">ASCII Tables (<tt class="docutils literal"><span class="pre">astropy.io.ascii</span></tt>)</a> »</li>
<li>Fixed-width Gallery</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="fixed-width-gallery">
<span id="id1"></span><h1>Fixed-width Gallery<a class="headerlink" href="#fixed-width-gallery" title="Permalink to this headline">¶</a></h1>
<p>Fixed-width tables are those where each column has the same width for every row
in the table. This is commonly used to make tables easy to read for humans or
FORTRAN codes. It also reduces issues with quoting and special characters,
for example:</p>
<div class="highlight-python"><pre>Col1 Col2 Col3 Col4
---- --------- ---- ----
1.2 "hello" 1 a
2.4 's worlds 2 2</pre>
</div>
<p>There are a number of common variations in the formatting of fixed-width tables
which <a class="reference internal" href="index.html#module-astropy.io.ascii" title="astropy.io.ascii"><tt class="xref py py-mod docutils literal"><span class="pre">astropy.io.ascii</span></tt></a> can read and write. The most signicant difference is
whether there is no header line (<tt class="xref py py-class docutils literal"><span class="pre">FixedWidthNoHeader</span></tt>), one
header line (<tt class="xref py py-class docutils literal"><span class="pre">FixedWidth</span></tt>), or two header lines
(<tt class="xref py py-class docutils literal"><span class="pre">FixedWidthTwoLine</span></tt>). Next, there are variations in the
delimiter character, whether the delimiter appears on either end (“bookends”),
and padding around the delimiter.</p>
<p>Details are available in the class API documentation, but the easiest way to
understand all the options and their interactions is by example.</p>
<div class="section" id="reading">
<h2>Reading<a class="headerlink" href="#reading" title="Permalink to this headline">¶</a></h2>
<div class="section" id="fixedwidth">
<h3>FixedWidth<a class="headerlink" href="#fixedwidth" title="Permalink to this headline">¶</a></h3>
<p><strong>Nice, typical fixed format table</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">from</span> <span class="nn">astropy.io</span> <span class="kn">import</span> <span class="n">ascii</span>
<span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"># comment (with blank line above)</span>
<span class="gp">... </span><span class="s">| Col1 | Col2 |</span>
<span class="gp">... </span><span class="s">| 1.2 | "hello" |</span>
<span class="gp">... </span><span class="s">| 2.4 |'s worlds|</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">)</span>
<span class="go">rec.array([(1.2, '"hello"'), (2.4, "'s worlds")],</span>
<span class="go"> dtype=[('Col1', '<f8'), ('Col2', '|S9')])</span>
</pre></div>
</div>
<p><strong>Typical fixed format table with col names provided</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"># comment (with blank line above)</span>
<span class="gp">... </span><span class="s">| Col1 | Col2 |</span>
<span class="gp">... </span><span class="s">| 1.2 | "hello" |</span>
<span class="gp">... </span><span class="s">| 2.4 |'s worlds|</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span> <span class="n">names</span><span class="o">=</span><span class="p">(</span><span class="s">'name1'</span><span class="p">,</span> <span class="s">'name2'</span><span class="p">))</span>
<span class="go">rec.array([(1.2, '"hello"'), (2.4, "'s worlds")],</span>
<span class="go"> dtype=[('name1', '<f8'), ('name2', '|S9')])</span>
</pre></div>
</div>
<p><strong>Weird input table with data values chopped by col extent</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"> Col1 | Col2 |</span>
<span class="gp">... </span><span class="s"> 1.2 "hello"</span>
<span class="gp">... </span><span class="s"> 2.4 sdf's worlds</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">)</span>
<span class="go">rec.array([(1.2, '"hel'), (2.4, "df's wo")],</span>
<span class="go"> dtype=[('Col1', '<f8'), ('Col2', '|S7')])</span>
</pre></div>
</div>
<p><strong>Table with double delimiters</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">|| Name || Phone || TCP||</span>
<span class="gp">... </span><span class="s">| John | 555-1234 |192.168.1.10X|</span>
<span class="gp">... </span><span class="s">| Mary | 555-2134 |192.168.1.12X|</span>
<span class="gp">... </span><span class="s">| Bob | 555-4527 | 192.168.1.9X|</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">)</span>
<span class="go">rec.array([('John', '555-1234', '192.168.1.10'),</span>
<span class="go"> ('Mary', '555-2134', '192.168.1.12'),</span>
<span class="go"> ('Bob', '555-4527', '192.168.1.9')],</span>
<span class="go"> dtype=[('Name', '|S4'), ('Phone', '|S8'), ('TCP', '|S12')])</span>
</pre></div>
</div>
<p><strong>Table with space delimiter</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"> Name --Phone- ----TCP-----</span>
<span class="gp">... </span><span class="s"> John 555-1234 192.168.1.10</span>
<span class="gp">... </span><span class="s"> Mary 555-2134 192.168.1.12</span>
<span class="gp">... </span><span class="s"> Bob 555-4527 192.168.1.9</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span> <span class="n">delimiter</span><span class="o">=</span><span class="s">' '</span><span class="p">)</span>
<span class="go">rec.array([('John', '555-1234', '192.168.1.10'),</span>
<span class="go"> ('Mary', '555-2134', '192.168.1.12'),</span>
<span class="go"> ('Bob', '555-4527', '192.168.1.9')],</span>
<span class="go"> dtype=[('Name', '|S4'), ('--Phone-', '|S8'), ('----TCP-----', '|S12')])</span>
</pre></div>
</div>
<p><strong>Table with no header row and auto-column naming.</strong></p>
<p>Use header_start and data_start keywords to indicate no header line.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">| John | 555-1234 |192.168.1.10|</span>
<span class="gp">... </span><span class="s">| Mary | 555-2134 |192.168.1.12|</span>
<span class="gp">... </span><span class="s">| Bob | 555-4527 | 192.168.1.9|</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">header_start</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">data_start</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
<span class="go">rec.array([('John', '555-1234', '192.168.1.10'),</span>
<span class="go"> ('Mary', '555-2134', '192.168.1.12'),</span>
<span class="go"> ('Bob', '555-4527', '192.168.1.9')],</span>
<span class="go"> dtype=[('col1', '|S4'), ('col2', '|S8'), ('col3', '|S12')])</span>
</pre></div>
</div>
<p><strong>Table with no header row and with col names provided.</strong></p>
<p>Second and third rows also have hanging spaces after final “|”. Use header_start and data_start
keywords to indicate no header line.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="p">[</span><span class="s">"| John | 555-1234 |192.168.1.10|"</span>
<span class="gp">... </span> <span class="s">"| Mary | 555-2134 |192.168.1.12| "</span>
<span class="gp">... </span> <span class="s">"| Bob | 555-4527 | 192.168.1.9| "</span><span class="p">]</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">header_start</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">data_start</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">names</span><span class="o">=</span><span class="p">(</span><span class="s">'Name'</span><span class="p">,</span> <span class="s">'Phone'</span><span class="p">,</span> <span class="s">'TCP'</span><span class="p">))</span>
<span class="go">rec.array([('John', '555-1234', '192.168.1.10')],</span>
<span class="go"> dtype=[('Name', '|S4'), ('Phone', '|S8'), ('TCP', '|S12')])</span>
</pre></div>
</div>
</div>
<div class="section" id="fixedwidthnoheader">
<h3>FixedWidthNoHeader<a class="headerlink" href="#fixedwidthnoheader" title="Permalink to this headline">¶</a></h3>
<p><strong>Table with no header row and auto-column naming. Use the FixedWidthNoHeader
convenience class.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">| John | 555-1234 |192.168.1.10|</span>
<span class="gp">... </span><span class="s">| Mary | 555-2134 |192.168.1.12|</span>
<span class="gp">... </span><span class="s">| Bob | 555-4527 | 192.168.1.9|</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">)</span>
<span class="go">rec.array([('John', '555-1234', '192.168.1.10'),</span>
<span class="go"> ('Mary', '555-2134', '192.168.1.12'),</span>
<span class="go"> ('Bob', '555-4527', '192.168.1.9')],</span>
<span class="go"> dtype=[('col1', '|S4'), ('col2', '|S8'), ('col3', '|S12')])</span>
</pre></div>
</div>
<p><strong>Table with no delimiter with column start and end values specified.</strong></p>
<p>This uses the col_starts and col_ends keywords. Note that the
col_ends values are inclusive so a position range of 0 to 5
will select the first 6 characters.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"># 5 9 17 18 28 <== Column start / end indexes</span>
<span class="gp">... </span><span class="s"># | | || | <== Column separation positions</span>
<span class="gp">... </span><span class="s"> John 555- 1234 192.168.1.10</span>
<span class="gp">... </span><span class="s"> Mary 555- 2134 192.168.1.12</span>
<span class="gp">... </span><span class="s"> Bob 555- 4527 192.168.1.9</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">names</span><span class="o">=</span><span class="p">(</span><span class="s">'Name'</span><span class="p">,</span> <span class="s">'Phone'</span><span class="p">,</span> <span class="s">'TCP'</span><span class="p">),</span>
<span class="gp">... </span> <span class="n">col_starts</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">9</span><span class="p">,</span> <span class="mi">18</span><span class="p">),</span>
<span class="gp">... </span> <span class="n">col_ends</span><span class="o">=</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">17</span><span class="p">,</span> <span class="mi">28</span><span class="p">),</span>
<span class="gp">... </span> <span class="p">)</span>
<span class="go">rec.array([('John', '555- 1234', '192.168.1.'),</span>
<span class="go"> ('Mary', '555- 2134', '192.168.1.'),</span>
<span class="go"> ('Bob', '555- 4527', '192.168.1')],</span>
<span class="go"> dtype=[('Name', '|S4'), ('Phone', '|S9'), ('TCP', '|S10')])</span>
</pre></div>
</div>
</div>
<div class="section" id="fixedwidthtwoline">
<h3>FixedWidthTwoLine<a class="headerlink" href="#fixedwidthtwoline" title="Permalink to this headline">¶</a></h3>
<p><strong>Typical fixed format table with two header lines with some cruft</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s"> Col1 Col2</span>
<span class="gp">... </span><span class="s"> ---- ---------</span>
<span class="gp">... </span><span class="s"> 1.2xx"hello"</span>
<span class="gp">... </span><span class="s"> 2.4 's worlds</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">)</span>
<span class="go">rec.array([(1.2, '"hello"'), (2.4, "'s worlds")],</span>
<span class="go"> dtype=[('Col1', '<f8'), ('Col2', '|S9')])</span>
</pre></div>
</div>
<p><strong>Restructured text table</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">======= ===========</span>
<span class="gp">... </span><span class="s"> Col1 Col2</span>
<span class="gp">... </span><span class="s">======= ===========</span>
<span class="gp">... </span><span class="s"> 1.2 "hello"</span>
<span class="gp">... </span><span class="s"> 2.4 's worlds</span>
<span class="gp">... </span><span class="s">======= ===========</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">header_start</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">position_line</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">data_end</span><span class="o">=-</span><span class="mi">1</span><span class="p">)</span>
<span class="go">rec.array([(1.2, '"hello"'), (2.4, "'s worlds")],</span>
<span class="go"> dtype=[('Col1', '<f8'), ('Col2', '|S9')])</span>
</pre></div>
</div>
<p><strong>Text table designed for humans and test having position line before the header line.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">+------+----------+</span>
<span class="gp">... </span><span class="s">| Col1 | Col2 |</span>
<span class="gp">... </span><span class="s">+------|----------+</span>
<span class="gp">... </span><span class="s">| 1.2 | "hello" |</span>
<span class="gp">... </span><span class="s">| 2.4 | 's worlds|</span>
<span class="gp">... </span><span class="s">+------+----------+</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">,</span> <span class="n">delimiter</span><span class="o">=</span><span class="s">'+'</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">header_start</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">position_line</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">data_start</span><span class="o">=</span><span class="mi">3</span><span class="p">,</span> <span class="n">data_end</span><span class="o">=-</span><span class="mi">1</span><span class="p">)</span>
<span class="go">rec.array([(1.2, '"hello"'), (2.4, "'s worlds")],</span>
<span class="go"> dtype=[('Col1', '<f8'), ('Col2', '|S9')])</span>
</pre></div>
</div>
</div>
</div>
<div class="section" id="writing">
<h2>Writing<a class="headerlink" href="#writing" title="Permalink to this headline">¶</a></h2>
<div class="section" id="id2">
<h3>FixedWidth<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
<p><strong>Define input values ``dat`` for all write examples.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">table</span> <span class="o">=</span> <span class="s">"""</span>
<span class="gp">... </span><span class="s">| Col1 | Col2 | Col3 | Col4 |</span>
<span class="gp">... </span><span class="s">| 1.2 | "hello" | 1 | a |</span>
<span class="gp">... </span><span class="s">| 2.4 | 's worlds | 2 | 2 |</span>
<span class="gp">... </span><span class="s">"""</span>
<span class="gp">>>> </span><span class="n">dat</span> <span class="o">=</span> <span class="n">ascii</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">Reader</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">)</span>
</pre></div>
</div>
<p><strong>Write a table as a normal fixed width table.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">)</span>
<span class="go">| Col1 | Col2 | Col3 | Col4 |</span>
<span class="go">| 1.2 | "hello" | 1 | a |</span>
<span class="go">| 2.4 | 's worlds | 2 | 2 |</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no padding.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span> <span class="n">delimiter_pad</span><span class="o">=</span><span class="bp">None</span><span class="p">)</span>
<span class="go">|Col1| Col2|Col3|Col4|</span>
<span class="go">| 1.2| "hello"| 1| a|</span>
<span class="go">| 2.4|'s worlds| 2| 2|</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no bookend.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span> <span class="n">bookend</span><span class="o">=</span><span class="bp">False</span><span class="p">)</span>
<span class="go">Col1 | Col2 | Col3 | Col4</span>
<span class="go"> 1.2 | "hello" | 1 | a</span>
<span class="go"> 2.4 | 's worlds | 2 | 2</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no delimiter.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span> <span class="n">bookend</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">delimiter</span><span class="o">=</span><span class="bp">None</span><span class="p">)</span>
<span class="go">Col1 Col2 Col3 Col4</span>
<span class="go"> 1.2 "hello" 1 a</span>
<span class="go"> 2.4 's worlds 2 2</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no delimiter and formatting.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidth</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">formats</span><span class="o">=</span><span class="p">{</span><span class="s">'Col1'</span><span class="p">:</span> <span class="s">'</span><span class="si">%-8.3f</span><span class="s">'</span><span class="p">,</span> <span class="s">'Col2'</span><span class="p">:</span> <span class="s">'</span><span class="si">%-15s</span><span class="s">'</span><span class="p">})</span>
<span class="go">| Col1 | Col2 | Col3 | Col4 |</span>
<span class="go">| 1.200 | "hello" | 1 | a |</span>
<span class="go">| 2.400 | 's worlds | 2 | 2 |</span>
</pre></div>
</div>
</div>
<div class="section" id="id3">
<h3>FixedWidthNoHeader<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
<p><strong>Write a table as a normal fixed width table.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">)</span>
<span class="go">| 1.2 | "hello" | 1 | a |</span>
<span class="go">| 2.4 | 's worlds | 2 | 2 |</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no padding.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">,</span> <span class="n">delimiter_pad</span><span class="o">=</span><span class="bp">None</span><span class="p">)</span>
<span class="go">|1.2| "hello"|1|a|</span>
<span class="go">|2.4|'s worlds|2|2|</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no bookend.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">,</span> <span class="n">bookend</span><span class="o">=</span><span class="bp">False</span><span class="p">)</span>
<span class="go">1.2 | "hello" | 1 | a</span>
<span class="go">2.4 | 's worlds | 2 | 2</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no delimiter.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthNoHeader</span><span class="p">,</span> <span class="n">bookend</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">delimiter</span><span class="o">=</span><span class="bp">None</span><span class="p">)</span>
<span class="go">1.2 "hello" 1 a</span>
<span class="go">2.4 's worlds 2 2</span>
</pre></div>
</div>
</div>
<div class="section" id="id4">
<h3>FixedWidthTwoLine<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
<p><strong>Write a table as a normal fixed width table.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">)</span>
<span class="go">Col1 Col2 Col3 Col4</span>
<span class="go">---- --------- ---- ----</span>
<span class="go"> 1.2 "hello" 1 a</span>
<span class="go"> 2.4 's worlds 2 2</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with space padding and ‘=’ position_char.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">,</span>
<span class="gp">... </span> <span class="n">delimiter_pad</span><span class="o">=</span><span class="s">' '</span><span class="p">,</span> <span class="n">position_char</span><span class="o">=</span><span class="s">'='</span><span class="p">)</span>
<span class="go">Col1 Col2 Col3 Col4</span>
<span class="go">==== ========= ==== ====</span>
<span class="go"> 1.2 "hello" 1 a</span>
<span class="go"> 2.4 's worlds 2 2</span>
</pre></div>
</div>
<p><strong>Write a table as a fixed width table with no bookend.</strong></p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">ascii</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">dat</span><span class="p">,</span> <span class="n">Writer</span><span class="o">=</span><span class="n">ascii</span><span class="o">.</span><span class="n">FixedWidthTwoLine</span><span class="p">,</span> <span class="n">bookend</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">delimiter</span><span class="o">=</span><span class="s">'|'</span><span class="p">)</span>
<span class="go">|Col1| Col2|Col3|Col4|</span>
<span class="go">|----|---------|----|----|</span>
<span class="go">| 1.2| "hello"| 1| a|</span>
<span class="go">| 2.4|'s worlds| 2| 2|</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper"><h3>Page Contents</h3>
<ul>
<li><a class="reference internal" href="#">Fixed-width Gallery</a><ul>
<li><a class="reference internal" href="#reading">Reading</a><ul>
<li><a class="reference internal" href="#fixedwidth">FixedWidth</a></li>
<li><a class="reference internal" href="#fixedwidthnoheader">FixedWidthNoHeader</a></li>
<li><a class="reference internal" href="#fixedwidthtwoline">FixedWidthTwoLine</a></li>
</ul>
</li>
<li><a class="reference internal" href="#writing">Writing</a><ul>
<li><a class="reference internal" href="#id2">FixedWidth</a></li>
<li><a class="reference internal" href="#id3">FixedWidthNoHeader</a></li>
<li><a class="reference internal" href="#id4">FixedWidthTwoLine</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<div class="clearer"></div>
</div>
<footer class="footer">
<p class="pull-right">
<a href="http://github.com/astropy/astropy/tree/v0.2.4/docs/io/ascii/fixed_width_gallery.rst">Edit This Page on Github</a>
<a href="../../_sources/io/ascii/fixed_width_gallery.txt"
rel="nofollow">Page Source</a>
<a href="#">Back to Top</a></p>
<p>
© Copyright 2011-2013, The Astropy Developers.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
Last built 22 Oct 2013. <br/>
</p>
</footer>
</body>
</html>
