27.01.2015 Views

CCfits - HEASARC - NASA

CCfits - HEASARC - NASA

CCfits - HEASARC - NASA

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

24.14 <strong>CCfits</strong>::FITS Class Reference 88<br />

24.14.2.5 <strong>CCfits</strong>::FITS::FITS ( const String & name, RWmode mode, const std::vector<<br />

String > & hduNames, const std::vector< std::vector< String > > & hduKeys,<br />

bool readDataFlag = false, const std::vector< String > & primaryKeys =<br />

std::vector(), const std::vector< int > & hduVersions =<br />

std::vector() )<br />

FITS read constructor in full generality.<br />

Parameters<br />

hduVersions an optional version number for each HDU to be read<br />

hduKeys an array of keywords for each HDU to be read. see above for other<br />

parameter definitions.<br />

24.14.2.6 <strong>CCfits</strong>::FITS::FITS ( const String & name, int bitpix, int naxis, long ∗ naxes )<br />

Constructor for creating new FITS objects containing images.<br />

This constructor is only called for creating new files (mode is not an argument) and<br />

creates a new primary HDU with the datatype & axes specified by bitpix, naxis, and<br />

naxes. The data are added to the new fits object and file by subsequent calls to FITS-<br />

::pHDU().write( )<br />

A file with a compressed image may be creating by appending to the end of the file<br />

name the same "[compress ...]" syntax specified in the cfitsio manual. Note however<br />

that the compressed image will be placed in the first extension and NOT in the primary<br />

HDU.<br />

If the filename corresponds to an existing file and does not start with the ’!’ character<br />

the construction will fail with a CantCreate exception.<br />

The arguments are:<br />

Parameters<br />

name The file to be written to disk<br />

bitpix the datatype of the primary image. bitpix may be one of the following<br />

CFITSIO constants: BYTE_IMG, SHORT_IMG, LONG_IMG, FLO-<br />

AT_IMG, DOUBLE_IMG, USHORT_IMG, ULONG_IMG. Note that<br />

if you send in a bitpix of USHORT_IMG or ULONG_IMG, <strong>CCfits</strong> will<br />

set HDU::bitpix() to its signed equivalent (SHORT_IMG or LONG_I-<br />

MG), and then set BZERO to 2 ∧ 15 or 2 ∧ 31.<br />

naxis the data dimension of the primary image<br />

naxes the array of axis lengths for the primary image. Ignored if naxis =0,<br />

i.e. the primary header is empty. extensions can be added arbitrarily to<br />

the file after this constructor is called. The constructors should write<br />

header information to disk:<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!