<!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/xhtml;charset=UTF-8"/>
<title>CCfits: CCfits::AsciiTable Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><b>CCfits</b>::<a class="el" href="classCCfits_1_1AsciiTable.html">AsciiTable</a>
</div>
</div>
<div class="contents">
<h1>CCfits::AsciiTable Class Reference</h1><!-- doxytag: class="CCfits::AsciiTable" --><!-- doxytag: inherits="CCfits::Table" -->
<p>Class Representing Ascii <a class="el" href="classCCfits_1_1Table.html">Table</a> Extensions.
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="AsciiTable_8h_source.html">AsciiTable.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for CCfits::AsciiTable:</div>
<div class="dynsection">
<div class="center">
<img src="classCCfits_1_1AsciiTable.gif" alt="Inheritance diagram" usemap="#CCfits::AsciiTable_map" alt=""/>
<map id="CCfits::AsciiTable_map" name="CCfits::AsciiTable_map">
<area href="classCCfits_1_1Table.html" alt="CCfits::Table" shape="rect" coords="0,112,111,136"/>
<area href="classCCfits_1_1ExtHDU.html" alt="CCfits::ExtHDU" shape="rect" coords="0,56,111,80"/>
<area href="classCCfits_1_1HDU.html" alt="CCfits::HDU" shape="rect" coords="0,0,111,24"/>
</map>
</div>
</div>
<p><a href="classCCfits_1_1AsciiTable-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#a245630609bfb16d581263b7ee868ce10">addColumn</a> (ValueType type, const String &columnName, long repeatWidth, const String &colUnit=String(""), long decimals=0, size_t columnNumber=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">add a new column to an existing table <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a>. <a href="#a245630609bfb16d581263b7ee868ce10"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aef13a5add47a41179c1f751c2235a17e"></a><!-- doxytag: member="CCfits::AsciiTable::clone" ref="aef13a5add47a41179c1f751c2235a17e" args="(FITSBase *p) const " -->
virtual <a class="el" href="classCCfits_1_1AsciiTable.html">AsciiTable</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#aef13a5add47a41179c1f751c2235a17e">clone</a> (FITSBase *p) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">virtual copy constructor <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#a7560ef2a9c29653a9685e6d20371e15e">readData</a> (bool readFlag=false, const std::vector< String > &keys=std::vector< String >())</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">read columns and keys specified in the input array. <a href="#a7560ef2a9c29653a9685e6d20371e15e"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#a69d98cb082fc738212066f583242c67c">AsciiTable</a> (FITSBase *p, int number)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">read <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> with <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> number <code>number</code> from existing file. <a href="#a69d98cb082fc738212066f583242c67c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#a56e7f260511c4a4ee08c84d00c624913">AsciiTable</a> (FITSBase *p, const String &hduName, int rows, const std::vector< String > &columnName=std::vector< String >(), const std::vector< String > &columnFmt=std::vector< String >(), const std::vector< String > &columnUnit=std::vector< String >(), int version=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">writing constructor: create new Ascii <a class="el" href="classCCfits_1_1Table.html">Table</a> object with the specified columns <a href="#a56e7f260511c4a4ee08c84d00c624913"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#a1c5cfbf4c9bcecf8b0bee071fca37d32">AsciiTable</a> (FITSBase *p, const String &hduName=String(""), bool readFlag=false, const std::vector< String > &keys=std::vector< String >(), int version=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">reading constructor: Construct a <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> extension from an extension of an existing disk file. <a href="#a1c5cfbf4c9bcecf8b0bee071fca37d32"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="addd0761345234235bd36d3dc46d452f6"></a><!-- doxytag: member="CCfits::AsciiTable::~AsciiTable" ref="addd0761345234235bd36d3dc46d452f6" args="()" -->
</td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1AsciiTable.html#addd0761345234235bd36d3dc46d452f6">~AsciiTable</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">destructor. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Class Representing Ascii <a class="el" href="classCCfits_1_1Table.html">Table</a> Extensions. </p>
<p>May only contain columns with scalar row entries and a small range of data types. <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> (re)implements functions prescribed in the <a class="el" href="classCCfits_1_1Table.html">Table</a> abstract class. The implementations allow the calling of cfitsio specialized routines for <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> header construction.</p>
<p>Direct instantiation of <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> objects is disallowed: they are created by explicit calls to <a class="el" href="classCCfits_1_1FITS.html#a867732f42c7863550baf28795efc6876" title="Add a table extension to an existing FITS object. Add extension to FITS object for...">FITS::addTable</a>( ... ), <a class="el" href="classCCfits_1_1FITS.html#a3640e3ad1c29931b37a13ac91106504e" title="get data from single HDU from disk file.">FITS::read</a>(...) or internally by one of the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> ctors on initialization. The default for <a class="el" href="classCCfits_1_1FITS.html#a867732f42c7863550baf28795efc6876" title="Add a table extension to an existing FITS object. Add extension to FITS object for...">FITS::addTable</a> is to produce <a class="el" href="classCCfits_1_1BinTable.html" title="Class Representing Binary Table Extensions. Contains columns with scalar or vector...">BinTable</a> extensions. </p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a1c5cfbf4c9bcecf8b0bee071fca37d32"></a><!-- doxytag: member="CCfits::AsciiTable::AsciiTable" ref="a1c5cfbf4c9bcecf8b0bee071fca37d32" args="(FITSBase *p, const String &hduName=String(""), bool readFlag=false, const std::vector< String > &keys=std::vector< String >(), int version=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::AsciiTable::AsciiTable </td>
<td>(</td>
<td class="paramtype">FITSBase * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>hduName</em> = <code>String("")</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>readFlag</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>keys</em> = <code>std::vector<String>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>version</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>reading constructor: Construct a <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> extension from an extension of an existing disk file. </p>
<p>The <a class="el" href="classCCfits_1_1Table.html">Table</a> is specified by name and optional version number within the file. An array of strings representing columns or keys indicates which data are to be read. The column data are only read if readFlag is true. Reading on construction is optimized, so it is more efficient to read data at the point of instantiation. This favours a "resource acquisition is initialization" model of data management.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>pointer to FITSBase object for internal use </td></tr>
<tr><td valign="top"></td><td valign="top"><em>hduName</em> </td><td>name of <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> object to be read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>readFlag</em> </td><td>flag to determine whether to read data on construction </td></tr>
<tr><td valign="top"></td><td valign="top"><em>keys</em> </td><td>(optional) a list of keywords/columns to be read. The implementation will determine which are keywords. If none are specified, the constructor will simply read the header </td></tr>
<tr><td valign="top"></td><td valign="top"><em>version</em> </td><td>(optional) version number. If not specified, will read the first extension that matches hduName. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a56e7f260511c4a4ee08c84d00c624913"></a><!-- doxytag: member="CCfits::AsciiTable::AsciiTable" ref="a56e7f260511c4a4ee08c84d00c624913" args="(FITSBase *p, const String &hduName, int rows, const std::vector< String > &columnName=std::vector< String >(), const std::vector< String > &columnFmt=std::vector< String >(), const std::vector< String > &columnUnit=std::vector< String >(), int version=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::AsciiTable::AsciiTable </td>
<td>(</td>
<td class="paramtype">FITSBase * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>hduName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnName</em> = <code>std::vector<String>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnFmt</em> = <code>std::vector<String>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnUnit</em> = <code>std::vector<String>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>version</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>writing constructor: create new Ascii <a class="el" href="classCCfits_1_1Table.html">Table</a> object with the specified columns </p>
<p>The constructor creates a valid <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> which is ready for <a class="el" href="classCCfits_1_1Column.html#a9415ebdf1c8bab1194f352471a057f6f" title="write a vector of values into a scalar column starting with firstRow">Column::write</a> or insertRows operations. The disk <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> file is update accordingly. The data type of each column is determined by the columnFmt argument (TFORM keywords). See cfitsio documentation for acceptable values.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>hduName</em> </td><td>name of <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> object to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>rows</em> </td><td>number of rows in the table (NAXIS2) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnName</em> </td><td>array of column names for columns to be constructed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnFmt</em> </td><td>array of column formats for columns to be constructed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnUnit</em> </td><td>(optional) array of units for data in columns. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>version</em> </td><td>(optional) version number for <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a>.</td></tr>
</table>
</dd>
</dl>
<p>The dimensions of columnType, columnName and columnFmt must match, although this is not enforced at present.</p>
<dl class="todo"><dt><b><a class="el" href="todo.html#_todo000001">Todo:</a></b></dt><dd>{enforce equal dimensions for arrays input to <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a>, <a class="el" href="classCCfits_1_1BinTable.html" title="Class Representing Binary Table Extensions. Contains columns with scalar or vector...">BinTable</a> writing ctor}</dd></dl>
</div>
</div>
<a class="anchor" id="a69d98cb082fc738212066f583242c67c"></a><!-- doxytag: member="CCfits::AsciiTable::AsciiTable" ref="a69d98cb082fc738212066f583242c67c" args="(FITSBase *p, int number)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::AsciiTable::AsciiTable </td>
<td>(</td>
<td class="paramtype">FITSBase * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>number</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>read <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> with <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> number <code>number</code> from existing file. </p>
<p>This is used internally by methods that need to access HDUs for which no EXTNAME [or equivalent] keyword exists. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a245630609bfb16d581263b7ee868ce10"></a><!-- doxytag: member="CCfits::AsciiTable::addColumn" ref="a245630609bfb16d581263b7ee868ce10" args="(ValueType type, const String &columnName, long repeatWidth, const String &colUnit=String(""), long decimals=0, size_t columnNumber=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::AsciiTable::addColumn </td>
<td>(</td>
<td class="paramtype">ValueType </td>
<td class="paramname"> <em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>columnName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>repeatWidth</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>colUnit</em> = <code>String("")</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>decimals</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>columnNumber</em> = <code>0</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>add a new column to an existing table <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>The data type of the column to be added </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnName</em> </td><td>The name of the column to be added </td></tr>
<tr><td valign="top"></td><td valign="top"><em>repeatWidth</em> </td><td>for a string valued, this is the width of a string. For a numeric column it supplies the vector length of the rows. It is ignored for ascii table numeric data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>colUnit</em> </td><td>an optional field specifying the units of the data (TUNITn) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>decimals</em> </td><td>optional parameter specifying the number of decimals for an ascii numeric column </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnNumber</em> </td><td>optional parameter specifying column number to be created. If not specified the column is added to the end. If specified, the column is inserted and the columns already read are reindexed. This parameter is provided as a convenience to support existing code rather than recommended. </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#a1a4ee80da434b132a5b9015e3d939c11">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="a7560ef2a9c29653a9685e6d20371e15e"></a><!-- doxytag: member="CCfits::AsciiTable::readData" ref="a7560ef2a9c29653a9685e6d20371e15e" args="(bool readFlag=false, const std::vector< String > &keys=std::vector< String >())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::AsciiTable::readData </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>readFlag</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>keys</em> = <code>std::vector<String>()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>read columns and keys specified in the input array. </p>
<p>See <a class="el" href="classCCfits_1_1Table.html">Table</a> class documentation for further details. </p>
<p>Implements <a class="el" href="classCCfits_1_1ExtHDU.html#a166d6a339f64d7d8d4715d33ea75195b">CCfits::ExtHDU</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="AsciiTable_8h_source.html">AsciiTable.h</a></li>
<li>AsciiTable.cxx</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Wed Sep 9 11:59:41 2009 for CCfits by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Fedora
>
13
>
i386
>
media
>
os
>
by-pkgid
>
ecbd8c5b7568e331fe6ea5b9a07a78a0
>
files
>
37
