27.01.2015 Views

CCfits - HEASARC - NASA

CCfits - HEASARC - NASA

CCfits - HEASARC - NASA

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

24.32 <strong>CCfits</strong>::HDU Class Reference 115<br />

Reimplemented in <strong>CCfits</strong>::ExtHDU.<br />

24.32.2.12 void <strong>CCfits</strong>::HDU::readAllKeys ( )<br />

read all of the keys in the header<br />

This member function reads keys that are not meta data for columns or image information,<br />

[which are considered to be part of the column or image objects]. Also, history<br />

and comment keys are read and returned by getHistory() and getComment(). The exact<br />

list of keyword classes this will read is returned by the function keywordCategories().<br />

Note that readAllKeys can only construct keys of type string, double, complex,<br />

integer, and bool because the FITS header records do not encode exact type information.<br />

24.32.2.13 template void <strong>CCfits</strong>::HDU::readKey ( const String & keyName, T &<br />

val )<br />

read a keyword of specified type from the header of a disk FITS file and return its value.<br />

T is one of the types String, double, float, int, std::complex, and bool. If a<br />

Keyword object with the name keyName already exists in this HDU due to a previous<br />

read call, then this will re-read from the file and create a new Keyword object to replace<br />

the existing one.<br />

24.32.2.14 template void <strong>CCfits</strong>::HDU::readKeys ( std::vector< String > &<br />

keyNames, std::vector< T > & vals )<br />

read a set of specified keywords of the same data type from the header of a disk FITS<br />

file and return their values<br />

T is one of the types String, double, float, int, std::complex, and bool.<br />

24.32.2.15 void <strong>CCfits</strong>::HDU::scale ( double value ) [inline, virtual]<br />

set the BSCALE keyword value for images (see warning for images of int type)<br />

For primary HDUs and image extensions, this will add (or update) the BSCALE keyword<br />

in the header. The new setting will affect future image array read/writes as described<br />

in section 4.7 Data Scaling of the CFITSIO manual. For table extensions this<br />

function does nothing.<br />

WARNING: If the image contains integer-type data (as indicated by the bitpix() return<br />

value), the new scale and zero value combination must not be such that the scaled<br />

data would require a floating-point type (this uses the CFITSIO function fits_get_img-<br />

_equivtype to make the determination). If this situation occurs, the function will throw<br />

a FitsException.<br />

Reimplemented in <strong>CCfits</strong>::PHDU, and <strong>CCfits</strong>::ImageExt< T >.<br />

Generated on Tue Dec 6 2011 16:12:51 for <strong>CCfits</strong> by Doxygen

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!