<!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::Column 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_1Column.html">Column</a>
</div>
</div>
<div class="contents">
<h1>CCfits::Column Class Reference</h1><!-- doxytag: class="CCfits::Column" -->
<p>Abstract base class for <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> objects.
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="Column_8h_source.html">Column.h</a>></code></p>
<p>Inherited by CCfits::ColumnData< T >, and CCfits::ColumnVectorData< T >.</p>
<p><a href="classCCfits_1_1Column-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1InsufficientElements.html">InsufficientElements</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown if the data supplied for a write operation is less than declared. <a href="classCCfits_1_1Column_1_1InsufficientElements.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1InvalidDataType.html">InvalidDataType</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown for invalid data type inputs. <a href="classCCfits_1_1Column_1_1InvalidDataType.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1InvalidNumberOfRows.html">InvalidNumberOfRows</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown if user enters a non-positive number for the number of rows to write. <a href="classCCfits_1_1Column_1_1InvalidNumberOfRows.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1InvalidRowNumber.html">InvalidRowNumber</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown on attempting to read a row number beyond the end of a table. <a href="classCCfits_1_1Column_1_1InvalidRowNumber.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1InvalidRowParameter.html">InvalidRowParameter</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown on incorrect row writing request. <a href="classCCfits_1_1Column_1_1InvalidRowParameter.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1NoNullValue.html">NoNullValue</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown if a null value is specified without support from existing column header. <a href="classCCfits_1_1Column_1_1NoNullValue.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1RangeError.html">RangeError</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">exception to be thrown for inputs that cause range errors in column read operations. <a href="classCCfits_1_1Column_1_1RangeError.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column_1_1WrongColumnType.html">WrongColumnType</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception thrown on attempting to access a scalar column as vector data. <a href="classCCfits_1_1Column_1_1WrongColumnType.html#_details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2>Public 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_1Column.html#a01cd84a7155888aadc568231f908bd5e">Column</a> (const <a class="el" href="classCCfits_1_1Column.html">Column</a> &right)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">copy constructor, used in copying Columns to standard library containers. <a href="#a01cd84a7155888aadc568231f908bd5e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afcd02b475ed7c08c391bc5917a9b3f06"></a><!-- doxytag: member="CCfits::Column::~Column" ref="afcd02b475ed7c08c391bc5917a9b3f06" args="()" -->
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#afcd02b475ed7c08c391bc5917a9b3f06">~Column</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">destructor. <br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename T > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ac61a0a9b0e560ded24e8fd802d395525">addNullValue</a> (T nullVal)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the TNULLn keyword for the column. <a href="#ac61a0a9b0e560ded24e8fd802d395525"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a8409427a876646e0f1846f55146872bc">dimen</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return TDIMn keyword <a href="#a8409427a876646e0f1846f55146872bc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#aa21fb01249bbb97f4a3149e704634f61">display</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return TDISPn keyword <a href="#aa21fb01249bbb97f4a3149e704634f61"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a9e95e761de30327378669d11295de1cc">format</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return TFORMn keyword <a href="#a9e95e761de30327378669d11295de1cc"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename T > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">bool </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a6d73e6c945867e9b6eab455c3c2c0f0e">getNullValue</a> (T *nullVal) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the value of the TNULLn keyword for the column. <a href="#a6d73e6c945867e9b6eab455c3c2c0f0e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab5c2c865112b6610e89bb0829e35c6dd"></a><!-- doxytag: member="CCfits::Column::index" ref="ab5c2c865112b6610e89bb0829e35c6dd" args="() const " -->
int </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ab5c2c865112b6610e89bb0829e35c6dd">index</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">get the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> index (the n in TTYPEn etc). <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3ab461fa13db155ab8d5fd649cf0e9ba"></a><!-- doxytag: member="CCfits::Column::isRead" ref="a3ab461fa13db155ab8d5fd649cf0e9ba" args="() const " -->
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a3ab461fa13db155ab8d5fd649cf0e9ba">isRead</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">flag set to true if the entire column data has been read from disk <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a09634d63a37f46d871ddee6ffa456fe7"></a><!-- doxytag: member="CCfits::Column::name" ref="a09634d63a37f46d871ddee6ffa456fe7" args="() const " -->
const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a09634d63a37f46d871ddee6ffa456fe7">name</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return name of <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> (TTYPEn keyword) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a53c239a7eda28388ac278de7f5b6f59f"></a><!-- doxytag: member="CCfits::Column::parent" ref="a53c239a7eda28388ac278de7f5b6f59f" args="() const " -->
<a class="el" href="classCCfits_1_1Table.html">Table</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a53c239a7eda28388ac278de7f5b6f59f">parent</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a pointer to the <a class="el" href="classCCfits_1_1Table.html">Table</a> which owns this <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> <br/></td></tr>
<tr><td class="memTemplParams" colspan="2"><a class="anchor" id="a09d161cbf0a10bc12d642412e2e54682"></a><!-- doxytag: member="CCfits::Column::read" ref="a09d161cbf0a10bc12d642412e2e54682" args="(std::valarray< S > &vals, long rows, S *nullValue)" -->
template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a09d161cbf0a10bc12d642412e2e54682">read</a> (std::valarray< S > &vals, long rows, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a single row of a vector column into a std::valarray, setting undefined values <br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a741622fab97293a954f5210ed7ccfc3c">read</a> (std::valarray< S > &vals, long first, long last, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve data from a scalar column into a std::valarray, applying nullValue when relevant. <a href="#a741622fab97293a954f5210ed7ccfc3c"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a1607fa486fd4c4ff9781ebb248e9641c">read</a> (std::vector< S > &vals, long first, long last, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve data from a scalar column into a std::vector>, applying nullValue when relevant. <a href="#a1607fa486fd4c4ff9781ebb248e9641c"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ae4fc022c148cfde5f792fd888b41e405">read</a> (std::valarray< S > &vals, long rows)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a single row of a vector column into a std::valarray <a href="#ae4fc022c148cfde5f792fd888b41e405"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ac2a72f9ba0a010a5d8c9c08c350af8c1">read</a> (std::valarray< S > &vals, long first, long last)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve data from a scalar column into a std::valarray. <a href="#ac2a72f9ba0a010a5d8c9c08c350af8c1"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a0589a56d088182076b0d63d6190147c0">read</a> (std::vector< S > &vals, long first, long last)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve data from a scalar column into a std::vector. <a href="#a0589a56d088182076b0d63d6190147c0"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a1fb4982b8df2bbe9c1697daeea5baa37">readArrays</a> (std::vector< std::valarray< S > > &vals, long first, long last, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a set of rows of a vector column into a container, setting undefined values <a href="#a1fb4982b8df2bbe9c1697daeea5baa37"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a55943005151e1b08871b0364786e655d">readArrays</a> (std::vector< std::valarray< S > > &vals, long first, long last)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a set of rows of a vector column into a vector of valarrays <a href="#a55943005151e1b08871b0364786e655d"></a><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_1Column.html#ab33449dbc7dd32f10d493e2b5470b739">readData</a> (long firstRow, long nelements, long firstElem=1)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read (or reread) data from the disk into the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> object's internal arrays. <a href="#ab33449dbc7dd32f10d493e2b5470b739"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a922e6694d82092fc487c406b74287ea0"></a><!-- doxytag: member="CCfits::Column::repeat" ref="a922e6694d82092fc487c406b74287ea0" args="() const " -->
size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a922e6694d82092fc487c406b74287ea0">repeat</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">get the repeat count for the rows <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a3529fff681af7e826b31cb366dae9afa">resetRead</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">reset the Column's isRead flag to false <a href="#a3529fff681af7e826b31cb366dae9afa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ad11ca53a9ed8c8d60e12aff99cc757af">rows</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return the number of rows in the table. <a href="#ad11ca53a9ed8c8d60e12aff99cc757af"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#aa73abbd02668c1d3a48e0b2e187be177">scale</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">get TSCALn value <a href="#aa73abbd02668c1d3a48e0b2e187be177"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a07f4db0fc1eb719f128555712977adc9"></a><!-- doxytag: member="CCfits::Column::setDimen" ref="a07f4db0fc1eb719f128555712977adc9" args="()" -->
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a07f4db0fc1eb719f128555712977adc9">setDimen</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">set the TDIMn keyword. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a20d67e697b433cef52a8a3680bc1ba6f"></a><!-- doxytag: member="CCfits::Column::setDisplay" ref="a20d67e697b433cef52a8a3680bc1ba6f" args="()" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a20d67e697b433cef52a8a3680bc1ba6f">setDisplay</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">set the TDISPn keyword <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a005f5d623d129e979d3ba1bd2bd0be17"></a><!-- doxytag: member="CCfits::Column::type" ref="a005f5d623d129e979d3ba1bd2bd0be17" args="() const " -->
ValueType </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a005f5d623d129e979d3ba1bd2bd0be17">type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">returns the data type of the column <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeb67db3dcfa5eb20db8ccf540f1f1cae"></a><!-- doxytag: member="CCfits::Column::unit" ref="aeb67db3dcfa5eb20db8ccf540f1f1cae" args="() const " -->
const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#aeb67db3dcfa5eb20db8ccf540f1f1cae">unit</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">get units of data in <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> (TUNITn keyword) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7e6589bf0f95eaefc52eeb5c1a119b44"></a><!-- doxytag: member="CCfits::Column::varLength" ref="a7e6589bf0f95eaefc52eeb5c1a119b44" args="() const " -->
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a7e6589bf0f95eaefc52eeb5c1a119b44">varLength</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">boolean, set to true if <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> has variable length vector rows. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6d952ee287b4764941a76eb59ceb450c"></a><!-- doxytag: member="CCfits::Column::width" ref="a6d952ee287b4764941a76eb59ceb450c" args="() const " -->
long </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a6d952ee287b4764941a76eb59ceb450c">width</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return column data width <br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#aff2fcbf80d23b8d4b2cd9609bc988bc8">write</a> (S *indata, long nElements, const std::vector< long > &vectorLengths, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a C-array of values of size nElements into a vector column with specified number of entries written per row. <a href="#aff2fcbf80d23b8d4b2cd9609bc988bc8"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a41dab9d43aed1c3f336850062252c672">write</a> (const std::vector< S > &indata, const std::vector< long > &vectorLengths, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of values into a column with specified number of entries written per row. <a href="#a41dab9d43aed1c3f336850062252c672"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#afcca9f01f987e941bd01e9e13e72fb80">write</a> (const std::valarray< S > &indata, const std::vector< long > &vectorLengths, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a valarray of values into a column with specified number of entries written per row. <a href="#afcca9f01f987e941bd01e9e13e72fb80"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ac7a25319a0a34dfe1edb44035730643c">write</a> (S *indata, long nElements, long nRows, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a C array of values into a range of rows of a vector column, processing undefined values. <a href="#ac7a25319a0a34dfe1edb44035730643c"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ab9498fd586ff58e5329c189e43eddffd">write</a> (const std::vector< S > &indata, long nRows, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of values into a range of rows of a vector column, processing undefined values <a href="#ab9498fd586ff58e5329c189e43eddffd"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a96667ebb8efe99481762970c603b0d69">write</a> (const std::valarray< S > &indata, long nRows, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a valarray of values into a range of rows of a vector column. <a href="#a96667ebb8efe99481762970c603b0d69"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#af9051d08b2b7fbeb45626ce202ea80c8">write</a> (S *indata, long nElements, long nRows, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a C array of values into a range of rows of a vector column <a href="#af9051d08b2b7fbeb45626ce202ea80c8"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a7f8ba0d8a89b6db76943544d4a6eeeee">write</a> (const std::vector< S > &indata, long nRows, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of values into a range of rows of a vector column <a href="#a7f8ba0d8a89b6db76943544d4a6eeeee"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a02ec60e97128feee6d271ebd4fabfb58">write</a> (const std::valarray< S > &indata, long nRows, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a valarray of values into a range of rows of a vector column. <a href="#a02ec60e97128feee6d271ebd4fabfb58"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ab01ddb37033287c720cf83ba79d66cd5">write</a> (S *indata, long nRows, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a C array into a scalar <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a>, processing undefined values. <a href="#ab01ddb37033287c720cf83ba79d66cd5"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#abe4388ba994fe5c2aabaa1cec89dc356">write</a> (const std::valarray< S > &indata, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a valarray of values into a scalar column starting with firstRow, replacing elements equal to nullValue with the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. <a href="#abe4388ba994fe5c2aabaa1cec89dc356"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ac64b1199e3a6274fe3bae37e0d779a4d">write</a> (const std::vector< S > &indata, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of values into a scalar column starting with firstRow, replacing elements equal to nullValue with the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. <a href="#ac64b1199e3a6274fe3bae37e0d779a4d"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#aad15136325c2e37c041de39a3f1d9ea6">write</a> (S *indata, long nRows, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a C array of size nRows into a scalar <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> starting with row firstRow. <a href="#aad15136325c2e37c041de39a3f1d9ea6"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a622edd52a8a9cc7a3b6431bd5ffa6f25">write</a> (const std::valarray< S > &indata, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a valarray of values into a scalar column starting with firstRow <a href="#a622edd52a8a9cc7a3b6431bd5ffa6f25"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a9415ebdf1c8bab1194f352471a057f6f">write</a> (const std::vector< S > &indata, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of values into a scalar column starting with firstRow <a href="#a9415ebdf1c8bab1194f352471a057f6f"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a7b33e7e14ed7cc3d17f7570ba53a1880">writeArrays</a> (const std::vector< std::valarray< S > > &indata, long firstRow, S *nullValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of valarray objects to the column, starting at row firstRow >= 1, processing undefined values <a href="#a7b33e7e14ed7cc3d17f7570ba53a1880"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<typename S > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ae489911b61dabbec1d169ab2bd879e94">writeArrays</a> (const std::vector< std::valarray< S > > &indata, long firstRow)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">write a vector of valarray objects to the column, starting at row firstRow >= 1 <a href="#ae489911b61dabbec1d169ab2bd879e94"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a3329c1be8b0491661be582b59710ba32">zero</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">get TZEROn value <a href="#a3329c1be8b0491661be582b59710ba32"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3a1f099043fecc7567eca702be5e6a41"></a><!-- doxytag: member="CCfits::Column::Column" ref="a3a1f099043fecc7567eca702be5e6a41" args="(Table *p=0)" -->
</td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a3a1f099043fecc7567eca702be5e6a41">Column</a> (<a class="el" href="classCCfits_1_1Table.html">Table</a> *p=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Simple constructor to be called by subclass reading ctors. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a206d06dd199e7c73c32864b06f760f77">Column</a> (int columnIndex, const String &columnName, ValueType type, const String &format, const String &unit, <a class="el" href="classCCfits_1_1Table.html">Table</a> *p, int rpt=1, long w=1, const String &comment="")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">new column creation constructor <a href="#a206d06dd199e7c73c32864b06f760f77"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afa347ea0046bd222d1b70346ec126332"></a><!-- doxytag: member="CCfits::Column::comment" ref="afa347ea0046bd222d1b70346ec126332" args="() const " -->
const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#afa347ea0046bd222d1b70346ec126332">comment</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">retrieve comment for <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad79fd54bd8997985b37cb6722777c4c0"></a><!-- doxytag: member="CCfits::Column::fitsPointer" ref="ad79fd54bd8997985b37cb6722777c4c0" args="()" -->
fitsfile * </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#ad79fd54bd8997985b37cb6722777c4c0">fitsPointer</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">fits pointer corresponding to fits file containing column data. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2a85f49e6e72ed0b3619df9e586ad159"></a><!-- doxytag: member="CCfits::Column::makeHDUCurrent" ref="a2a85f49e6e72ed0b3619df9e586ad159" args="()" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a2a85f49e6e72ed0b3619df9e586ad159">makeHDUCurrent</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">make <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> containing this the current <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> of the fits file. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a636120f892e981e24fc7e29248c66a59"></a><!-- doxytag: member="CCfits::Column::put" ref="a636120f892e981e24fc7e29248c66a59" args="(std::ostream &s) const " -->
virtual std::ostream & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Column.html#a636120f892e981e24fc7e29248c66a59">put</a> (std::ostream &s) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">internal implementation of << operator. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Abstract base class for <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> objects. </p>
<p>Columns are the data containers used in <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> tables. Columns of scalar type (one entry per cell) are implemented by the template subclass ColumnData<T>. Columns of vector type (vector and variable rows) are implemented with the template subclass ColumnVectorData<T>. AsciiTables may only contain Columns of type ColumnData<T>, where T is an implemented <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> data type (see the CCfits.h header for a complete list. This requirement is enforced by ensuring that AsciiTable's addColumn method may only create an <a class="el" href="classCCfits_1_1AsciiTable.html" title="Class Representing Ascii Table Extensions.">AsciiTable</a> compatible column. The ColumnData<T> class stores its data in a std::vector<T> object.</p>
<p>BinTables may contain either ColumnData<T> or ColumnVectorData<T>. For ColumnVectorData, T must be a numeric type: string vectors are handled by ColumnData<T>; string arrays are not supported. The internal representation of the data is a std::vector<std::valarray<T> > object. The std::valarray class is designed for efficient numeric processing and has many vectorized numeric and transcendental functions defined on it.</p>
<p>Member template functions for read/write operations are provided in multiple overloads as the interface to data operations. Implicit data type conversions are supported but where they are required make the operations less efficient. Reading numeric column data as character arrays, supported by cfitsio, is not supported by CCfits.</p>
<p>As a base class, <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> provides protected accessor/mutator inline functions to allow only its subclasses to access data members. </p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a01cd84a7155888aadc568231f908bd5e"></a><!-- doxytag: member="CCfits::Column::Column" ref="a01cd84a7155888aadc568231f908bd5e" args="(const Column &right)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::Column::Column </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classCCfits_1_1Column.html">Column</a> & </td>
<td class="paramname"> <em>right</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>copy constructor, used in copying Columns to standard library containers. </p>
<p>The copy constructor is for internal use only: it does not affect the disk fits file associated with the object. </p>
</div>
</div>
<a class="anchor" id="a206d06dd199e7c73c32864b06f760f77"></a><!-- doxytag: member="CCfits::Column::Column" ref="a206d06dd199e7c73c32864b06f760f77" args="(int columnIndex, const String &columnName, ValueType type, const String &format, const String &unit, Table *p, int rpt=1, long w=1, const String &comment="")" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::Column::Column </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>columnIndex</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">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>format</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>unit</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classCCfits_1_1Table.html">Table</a> * </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>rpt</em> = <code>1</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>w</em> = <code>1</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>comment</em> = <code>""</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>new column creation constructor </p>
<p>This constructor allows the specification of:</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>columnIndex</em> </td><td>The column number </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnName</em> </td><td>The column name, keyword TTYPEn </td></tr>
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>used for determining class of T in ColumnData<T>, ColumnVectorData<T> </td></tr>
<tr><td valign="top"></td><td valign="top"><em>format</em> </td><td>the column data format, TFORMn keyword </td></tr>
<tr><td valign="top"></td><td valign="top"><em>unit</em> </td><td>the column data unit, TUNITn keyword </td></tr>
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>the <a class="el" href="classCCfits_1_1Table.html">Table</a> pointer </td></tr>
<tr><td valign="top"></td><td valign="top"><em>rpt</em> </td><td>(optional) repeat count for the row ( == 1 for AsciiTables) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>w</em> </td><td>the row width </td></tr>
<tr><td valign="top"></td><td valign="top"><em>comment</em> </td><td>comment to be added to the header. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ac61a0a9b0e560ded24e8fd802d395525"></a><!-- doxytag: member="CCfits::Column::addNullValue" ref="ac61a0a9b0e560ded24e8fd802d395525" args="(T nullVal)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename T > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::addNullValue </td>
<td>(</td>
<td class="paramtype">T </td>
<td class="paramname"> <em>nullVal</em></td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the TNULLn keyword for the column. </p>
<p>Only relevant for integer valued columns, TNULLn is the value used by cfitsio in undefined processing. All entries in the table equal to an input "null value" are set equal to the value of TNULLn. (For floating point columns a system NaN value is used). </p>
</div>
</div>
<a class="anchor" id="a8409427a876646e0f1846f55146872bc"></a><!-- doxytag: member="CCfits::Column::dimen" ref="a8409427a876646e0f1846f55146872bc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const String & CCfits::Column::dimen </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return TDIMn keyword </p>
<p>represents dimensions of data arrays in vector columns. for scalar columns, returns a default value. </p>
</div>
</div>
<a class="anchor" id="aa21fb01249bbb97f4a3149e704634f61"></a><!-- doxytag: member="CCfits::Column::display" ref="aa21fb01249bbb97f4a3149e704634f61" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const String & CCfits::Column::display </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return TDISPn keyword </p>
<p>TDISPn is suggested format for output of column data. </p>
</div>
</div>
<a class="anchor" id="a9e95e761de30327378669d11295de1cc"></a><!-- doxytag: member="CCfits::Column::format" ref="a9e95e761de30327378669d11295de1cc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const String & CCfits::Column::format </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return TFORMn keyword </p>
<p>TFORMn specifies data format stored in disk file. </p>
</div>
</div>
<a class="anchor" id="a6d73e6c945867e9b6eab455c3c2c0f0e"></a><!-- doxytag: member="CCfits::Column::getNullValue" ref="a6d73e6c945867e9b6eab455c3c2c0f0e" args="(T *nullVal) const " -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename T > </div>
<table class="memname">
<tr>
<td class="memname">bool CCfits::Column::getNullValue </td>
<td>(</td>
<td class="paramtype">T * </td>
<td class="paramname"> <em>nullVal</em></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the value of the TNULLn keyword for the column. </p>
<p>Only relevant for integer valued columns. If the TNULLn keyword is present, its value will be written to <em>*nullVal</em> and the function returns <em>true</em>. If the keyword is not found or its value is undefined, the function returns <em>false</em> and <em>*nullVal</em> is not modified.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nullVal</em> </td><td>A pointer to the variable for storing the TNULLn value. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a741622fab97293a954f5210ed7ccfc3c"></a><!-- doxytag: member="CCfits::Column::read" ref="a741622fab97293a954f5210ed7ccfc3c" args="(std::valarray< S > &vals, long first, long last, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::read </td>
<td>(</td>
<td class="paramtype">std::valarray< S > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve data from a scalar column into a std::valarray, applying nullValue when relevant. </p>
<p>If both <em>nullValue</em> and <em>*nullValue</em> are not 0, then any undefined values in the file will be converted to <em>*nullValue</em> when copied into the <em>vals</em> valarray. See cfitsio documentation for further details</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>pointer to value to be applied to undefined elements. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a1607fa486fd4c4ff9781ebb248e9641c"></a><!-- doxytag: member="CCfits::Column::read" ref="a1607fa486fd4c4ff9781ebb248e9641c" args="(std::vector< S > &vals, long first, long last, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::read </td>
<td>(</td>
<td class="paramtype">std::vector< S > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve data from a scalar column into a std::vector>, applying nullValue when relevant. </p>
<p>If both <em>nullValue</em> and <em>*nullValue</em> are not 0, then any undefined values in the file will be converted to <em>*nullValue</em> when copied into the <em>vals</em> vector. See cfitsio documentation for further details</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>pointer to value to be applied to undefined elements. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ae4fc022c148cfde5f792fd888b41e405"></a><!-- doxytag: member="CCfits::Column::read" ref="ae4fc022c148cfde5f792fd888b41e405" args="(std::valarray< S > &vals, long rows)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::read </td>
<td>(</td>
<td class="paramtype">std::valarray< S > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>rows</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a single row of a vector column into a std::valarray </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output valarray object </td></tr>
<tr><td valign="top"></td><td valign="top"><em>rows</em> </td><td>The row number to be retrieved (starting at 1). </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac2a72f9ba0a010a5d8c9c08c350af8c1"></a><!-- doxytag: member="CCfits::Column::read" ref="ac2a72f9ba0a010a5d8c9c08c350af8c1" args="(std::valarray< S > &vals, long first, long last)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::read </td>
<td>(</td>
<td class="paramtype">std::valarray< S > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve data from a scalar column into a std::valarray. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a0589a56d088182076b0d63d6190147c0"></a><!-- doxytag: member="CCfits::Column::read" ref="a0589a56d088182076b0d63d6190147c0" args="(std::vector< S > &vals, long first, long last)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::read </td>
<td>(</td>
<td class="paramtype">std::vector< S > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve data from a scalar column into a std::vector. </p>
<p>This and the following functions perform implicit data conversions. An exception will be thrown if no conversion exists.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a1fb4982b8df2bbe9c1697daeea5baa37"></a><!-- doxytag: member="CCfits::Column::readArrays" ref="a1fb4982b8df2bbe9c1697daeea5baa37" args="(std::vector< std::valarray< S > > &vals, long first, long last, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::readArrays </td>
<td>(</td>
<td class="paramtype">std::vector< std::valarray< S > > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a set of rows of a vector column into a container, setting undefined 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>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>pointer to integer value regarded as undefined </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a55943005151e1b08871b0364786e655d"></a><!-- doxytag: member="CCfits::Column::readArrays" ref="a55943005151e1b08871b0364786e655d" args="(std::vector< std::valarray< S > > &vals, long first, long last)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::readArrays </td>
<td>(</td>
<td class="paramtype">std::vector< std::valarray< S > > & </td>
<td class="paramname"> <em>vals</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>last</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a set of rows of a vector column into a vector of valarrays </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>vals</em> </td><td>The output container. The function will resize this as necessary </td></tr>
<tr><td valign="top"></td><td valign="top"><em>first,last</em> </td><td>the span of row numbers to read. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ab33449dbc7dd32f10d493e2b5470b739"></a><!-- doxytag: member="CCfits::Column::readData" ref="ab33449dbc7dd32f10d493e2b5470b739" args="(long firstRow, long nelements, long firstElem=1)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::readData </td>
<td>(</td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em> = <code>1</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nelements</em> = <code>1</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstElem</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Read (or reread) data from the disk into the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> object's internal arrays. </p>
<p>This function normally does not need to be called. See the <b>resetRead</b> function for an alternative way of performing a reread from disk. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be read </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nelements</em> </td><td>The number of elements to read </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstElem</em> </td><td>The number of the element on the first row to start at (ignored for scalar columns) </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3529fff681af7e826b31cb366dae9afa"></a><!-- doxytag: member="CCfits::Column::resetRead" ref="a3529fff681af7e826b31cb366dae9afa" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::resetRead </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>reset the Column's isRead flag to false </p>
<p>This forces the data to be reread from the disk the next time a read command is called on the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a>, rather than simply retrieving the data already stored in the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> object's internal arrays. This may be useful for example if trying to reread a <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> using a different nullValue argument than for an earlier read. </p>
</div>
</div>
<a class="anchor" id="ad11ca53a9ed8c8d60e12aff99cc757af"></a><!-- doxytag: member="CCfits::Column::rows" ref="ad11ca53a9ed8c8d60e12aff99cc757af" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CCfits::Column::rows </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return the number of rows in the table. </p>
<p>return number of rows in the <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> </p>
</div>
</div>
<a class="anchor" id="aa73abbd02668c1d3a48e0b2e187be177"></a><!-- doxytag: member="CCfits::Column::scale" ref="aa73abbd02668c1d3a48e0b2e187be177" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CCfits::Column::scale </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>get TSCALn value </p>
<p>TSCALn is used to convert a data array represented on disk in integer format as floating. Useful for compact storage of digitized data. </p>
</div>
</div>
<a class="anchor" id="aff2fcbf80d23b8d4b2cd9609bc988bc8"></a><!-- doxytag: member="CCfits::Column::write" ref="aff2fcbf80d23b8d4b2cd9609bc988bc8" args="(S *indata, long nElements, const std::vector< long > &vectorLengths, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nElements</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< long > & </td>
<td class="paramname"> <em>vectorLengths</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a C-array of values of size nElements into a vector column with specified number of entries written per row. </p>
<p>Intended for writing a varying number of elements to multiple rows in a vector column, this may be used for either variable or fixed-width columns. See the indata valarray version of this function for a complete description. </p>
</div>
</div>
<a class="anchor" id="a41dab9d43aed1c3f336850062252c672"></a><!-- doxytag: member="CCfits::Column::write" ref="a41dab9d43aed1c3f336850062252c672" args="(const std::vector< S > &indata, const std::vector< long > &vectorLengths, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::vector< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< long > & </td>
<td class="paramname"> <em>vectorLengths</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of values into a column with specified number of entries written per row. </p>
<p>Intended for writing a varying number of elements to multiple rows in a vector column, this may be used for either variable or fixed-width columns. See the indata valarray version of this function for a complete description. </p>
</div>
</div>
<a class="anchor" id="afcca9f01f987e941bd01e9e13e72fb80"></a><!-- doxytag: member="CCfits::Column::write" ref="afcca9f01f987e941bd01e9e13e72fb80" args="(const std::valarray< S > &indata, const std::vector< long > &vectorLengths, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::valarray< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< long > & </td>
<td class="paramname"> <em>vectorLengths</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a valarray of values into a column with specified number of entries written per row. </p>
<p>Data are written into vectorLengths.size() rows, with vectorLength[n] elements written to row n+firstRow -1. Although primarily intended for wrapping calls to multiple variable-width vector column rows, it may also be used to write a variable number of elements to fixed-width column rows.</p>
<p>When writing to fixed-width column rows, if the number of elements sent to a particular row are fewer than the column's repeat value, the remaining elements in the row will not be modified.</p>
<p>Since cfitsio does not support null value processing for variable width columns this function and its variants do not have version which process undefined 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>indata</em> </td><td>The data to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>vectorLengths</em> </td><td>the number of elements to write to each successive row. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>the first row to be written. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac7a25319a0a34dfe1edb44035730643c"></a><!-- doxytag: member="CCfits::Column::write" ref="ac7a25319a0a34dfe1edb44035730643c" args="(S *indata, long nElements, long nRows, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nElements</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a C array of values into a range of rows of a vector column, processing undefined values. </p>
<p>see version without undefined processing for details. </p>
</div>
</div>
<a class="anchor" id="ab9498fd586ff58e5329c189e43eddffd"></a><!-- doxytag: member="CCfits::Column::write" ref="ab9498fd586ff58e5329c189e43eddffd" args="(const std::vector< S > &indata, long nRows, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::vector< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of values into a range of rows of a vector column, processing undefined values </p>
<p>see version without undefined processing for details. </p>
</div>
</div>
<a class="anchor" id="a96667ebb8efe99481762970c603b0d69"></a><!-- doxytag: member="CCfits::Column::write" ref="a96667ebb8efe99481762970c603b0d69" args="(const std::valarray< S > &indata, long nRows, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::valarray< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a valarray of values into a range of rows of a vector column. </p>
<p>see version without undefined processing for details. </p>
</div>
</div>
<a class="anchor" id="af9051d08b2b7fbeb45626ce202ea80c8"></a><!-- doxytag: member="CCfits::Column::write" ref="af9051d08b2b7fbeb45626ce202ea80c8" args="(S *indata, long nElements, long nRows, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nElements</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a C array of values into a range of rows of a vector column </p>
<p>Details are as for vector input; only difference is the need to supply the size of the C-array.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nElements</em> </td><td>The size of indata </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nRows</em> </td><td>the number of rows to which to write the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a7f8ba0d8a89b6db76943544d4a6eeeee"></a><!-- doxytag: member="CCfits::Column::write" ref="a7f8ba0d8a89b6db76943544d4a6eeeee" args="(const std::vector< S > &indata, long nRows, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::vector< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of values into a range of rows of a vector column </p>
<p>The primary use of this is for fixed width columns, in which case Column's repeat attribute is used to determine how many elements are written to each row; if indata.size() is too small an exception will be thrown. If the column is variable width, the call will write indata.size()/nRows elements to each row.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nRows</em> </td><td>the number of rows to which to write the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a02ec60e97128feee6d271ebd4fabfb58"></a><!-- doxytag: member="CCfits::Column::write" ref="a02ec60e97128feee6d271ebd4fabfb58" args="(const std::valarray< S > &indata, long nRows, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::valarray< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a valarray of values into a range of rows of a vector column. </p>
<p>The primary use of this is for fixed width columns, in which case Column's repeat attribute is used to determine how many elements are written to each row; if indata.size() is too small an exception will be thrown. If the column is variable width, the call will write indata.size()/nRows elements to each row.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nRows</em> </td><td>the number of rows to which to write the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ab01ddb37033287c720cf83ba79d66cd5"></a><!-- doxytag: member="CCfits::Column::write" ref="ab01ddb37033287c720cf83ba79d66cd5" args="(S *indata, long nRows, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a C array into a scalar <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a>, processing undefined 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>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nRows</em> </td><td>The size of the data array to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>Pointer to the value in the input array to be set to undefined values </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="abe4388ba994fe5c2aabaa1cec89dc356"></a><!-- doxytag: member="CCfits::Column::write" ref="abe4388ba994fe5c2aabaa1cec89dc356" args="(const std::valarray< S > &indata, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::valarray< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a valarray of values into a scalar column starting with firstRow, replacing elements equal to nullValue with the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. </p>
<p>If <em>nullValue</em> is not 0, the appropriate <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value will be substituted for all elements of <em>indata</em> equal to <em>*nullValue</em>. For integer type columns there must be a pre-existing TNULLn keyword to define the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value, otherwise a <a class="el" href="classCCfits_1_1FitsError.html" title="FitsError is the exception thrown by non-zero cfitsio status codes.">FitsError</a> exception is thrown. For floating point columns, the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null is the IEEE NaN (Not-a-Number) value. See the cfitsio fits_write_colnull function documentation for more details.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>Pointer to the value for which equivalent <em>indata</em> elements will be replaced in the file with the appropriate <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac64b1199e3a6274fe3bae37e0d779a4d"></a><!-- doxytag: member="CCfits::Column::write" ref="ac64b1199e3a6274fe3bae37e0d779a4d" args="(const std::vector< S > &indata, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::vector< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of values into a scalar column starting with firstRow, replacing elements equal to nullValue with the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. </p>
<p>If <em>nullValue</em> is not 0, the appropriate <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value will be substituted for all elements of <em>indata</em> equal to <em>*nullValue</em>. For integer type columns there must be a pre-existing TNULLn keyword to define the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value, otherwise a <a class="el" href="classCCfits_1_1FitsError.html" title="FitsError is the exception thrown by non-zero cfitsio status codes.">FitsError</a> exception is thrown. For floating point columns, the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null is the IEEE NaN (Not-a-Number) value. See the cfitsio fits_write_colnull function documentation for more details.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nullValue</em> </td><td>Pointer to the value for which equivalent <em>indata</em> elements will be replaced in the file with the appropriate <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> null value. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aad15136325c2e37c041de39a3f1d9ea6"></a><!-- doxytag: member="CCfits::Column::write" ref="aad15136325c2e37c041de39a3f1d9ea6" args="(S *indata, long nRows, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>nRows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a C array of size nRows into a scalar <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> starting with row firstRow. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nRows</em> </td><td>The size of the data array to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a622edd52a8a9cc7a3b6431bd5ffa6f25"></a><!-- doxytag: member="CCfits::Column::write" ref="a622edd52a8a9cc7a3b6431bd5ffa6f25" args="(const std::valarray< S > &indata, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::valarray< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a valarray of values into a scalar column starting with firstRow </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a9415ebdf1c8bab1194f352471a057f6f"></a><!-- doxytag: member="CCfits::Column::write" ref="a9415ebdf1c8bab1194f352471a057f6f" args="(const std::vector< S > &indata, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::write </td>
<td>(</td>
<td class="paramtype">const std::vector< S > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of values into a scalar column starting with firstRow </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>The first row to be written </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a7b33e7e14ed7cc3d17f7570ba53a1880"></a><!-- doxytag: member="CCfits::Column::writeArrays" ref="a7b33e7e14ed7cc3d17f7570ba53a1880" args="(const std::vector< std::valarray< S > > &indata, long firstRow, S *nullValue)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::writeArrays </td>
<td>(</td>
<td class="paramtype">const std::vector< std::valarray< S > > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">S * </td>
<td class="paramname"> <em>nullValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of valarray objects to the column, starting at row firstRow >= 1, processing undefined values </p>
<p>see version without undefined processing for details. </p>
</div>
</div>
<a class="anchor" id="ae489911b61dabbec1d169ab2bd879e94"></a><!-- doxytag: member="CCfits::Column::writeArrays" ref="ae489911b61dabbec1d169ab2bd879e94" args="(const std::vector< std::valarray< S > > &indata, long firstRow)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename S > </div>
<table class="memname">
<tr>
<td class="memname">void CCfits::Column::writeArrays </td>
<td>(</td>
<td class="paramtype">const std::vector< std::valarray< S > > & </td>
<td class="paramname"> <em>indata</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>firstRow</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>write a vector of valarray objects to the column, starting at row firstRow >= 1 </p>
<p>Intended for writing a varying number of elements to multiple rows in a vector column, this may be used for either variable or fixed-width columns. When writing to fixed-width column rows, if the number of elements sent to a particular row are fewer than the column's repeat value, the remaining elements in the row will not be modified.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>indata</em> </td><td>The data to be written </td></tr>
<tr><td valign="top"></td><td valign="top"><em>firstRow</em> </td><td>the first row to be written. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3329c1be8b0491661be582b59710ba32"></a><!-- doxytag: member="CCfits::Column::zero" ref="a3329c1be8b0491661be582b59710ba32" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CCfits::Column::zero </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>get TZEROn value </p>
<p>TZEROn is an integer offset used in the implementation of unsigned data </p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="Column_8h_source.html">Column.h</a></li>
<li>Column.cxx</li>
<li><a class="el" href="ColumnT_8h_source.html">ColumnT.h</a></li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Wed Sep 9 11:59:42 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
>
42
