Primary HDU and extensions in one object. Look into test/testfitsextensionio.cpp for examples. More...

Inherits ltl::FitsIn, and ltl::FitsExtension.

Public Member Functions
	FitsExtensionIn (const char *path, const bool quiet_please=false, const bool ignore_header=false)
	Construct a FitsExtensionIn object from C string filename. More...

	FitsExtensionIn (const string &path, const bool quiet_please=false, const bool ignore_header=false)
	Construct a FitsExtensionIn object from C++ string filename. More...

virtual	~FitsExtensionIn ()

FitsIn	getExtension (const string &xtension, const string &extname, const int extver=0, const int extlevel=0)

FitsIn	getExtension (const size_t extno)
	Return FitsIn object holding extno 's extension (get by sequential number). More...

virtual FitsIn	getNextExtension ()
	Return the next extension. More...

void	freeData ()
	Unmap data segment, free address space. More...

virtual void	describeSelf (std::ostream &os)
	Write FITS file geometry and class interna to out stream. More...

FitsHeader	getHeader () const
	Return copy of FITS header. More...

std::string	adjustKeyword (std::string keyword) const
	Return keyword trimmed (or expanded) to a width of 8 chars. More...

int	eraseCard (const std::string &keyword) throw (FitsException)
	Erase FITS card keyword. More...

off_t	getDataOffset () const
	Return the byte offset within the file to the data segment. More...

off_t	getDataLength () const
	Return the size of the data segment in bytes. More...

std::string	writeHeader (const bool with_junk=false)
	Return a new valid FITS file format header. More...

string	getFilename () const
	Return ltl::FitsIO::filename_ . More...

unsigned char *	streampos () const
	Return ltl::FitsIO::fitsstreamptr_ . More...

size_t	getExtNo () const
	Return number of actual extension. More...

bool	getPrimary () const
	Return status of primary flag, i.e. reading or writing primary header / data. More...

void	resetExtNo ()
	Reset Extension counter and raise primary flag. More...

void	incExtNo ()
	Increment Extension counter and lower primary flag. More...

void	unsetPrimary ()
	Lower primary flag. More...


unsigned char *	begin ()

unsigned char *	end ()

void	resetPosition ()

void	setPosition (off_t offset)

ptrdiff_t	getPosition ()


void	setRegion (const util::Region &fregion) throw (FitsException)
	Select region of interest in data segment. More...

void	resetRegion ()
	Reset region of interest in data segment to full region. More...


template<class T >
T *	getRegionArray (const util::Region &reg)
	Return array holding preselected region of data segment. More...

template<class T >
void	readRegionArray (T &i, const util::Region &reg)
	Fill container via iterator i with region reg of data segment. More...

template<class T >
void	readRegionArray (T &i)
	Fill container via iterator i with preselected region of data segment. More...

template<class T >
void	readDataArray (T &i)
	Fill container via iterator i with data segment. More...

template<class T >
T *	getDataArray (const T)
	Return array holding data segment. More...

template<class T >
T	getNextPixel (const T)
	Read next pixel of datasegment with per pixel read. More...

Adding new Cards
void	addCommentCard (const std::string &keyword, const std::string &comment)
	Add a commentary card. More...

void	addHistory (const std::string &history)
	Add a history of arbitrary length. More...

void	addComment (const std::string &comment)
	Add a history of arbitrary length. More...

void	addValueCard (const std::string &keyword, const std::string &value, const std::string comment="", const bool fixed=true)
	Add a string value card. More...

void	addValueCard (const std::string &keyword, const char *value, const std::string comment="", const bool fixed=true)
	Add a char value card. More...

void	addValueCard (const std::string &keyword, const bool value, const std::string comment="", const bool fixed=true)
	Add a boolean value card. More...

void	addValueCard (const std::string &keyword, const int value, const std::string comment="", const bool fixed=true)
	Add an integer value card. More...

void	addValueCard (const std::string &keyword, const long value, const std::string comment="", const bool fixed=true)
	Add an integer value card. More...

void	addValueCard (const std::string &keyword, const float value, const std::string comment="", const bool fixed=true)
	Add a floating point value card. More...

void	addValueCard (const std::string &keyword, const double value, const std::string comment="", const bool fixed=true)
	Add a floating point value card. More...

Shortcuts
Get (and set) values of mandatories and array keys via shortcuts.
int	getBitpix () const
	Return BITPIX setting. More...

int	getBytpix () const
	Return bytes per pixel, i.e. abs( bitpix_ ) / 8. More...

int	getNaxis () const
	Return NAXIS setting. More...

int	getNaxis (const int i) const
	Return width of i NAXIS. More...

double	getBscale () const
	Return BSCALE setting. More...

double	getBzero () const
	Return BZERO setting. More...

void	setBscale (const double value)
	Set the BSCALE key to value. More...

void	setBzero (const double value)
	Set the BZERO key to value. More...

util::Region	getFullRegion () const
	Return a util::Region according to the NAXIS geometry. More...

Read Cards
Search the lists for card matching keyword and return requested instance.
std::string	getString (const std::string &keyword) const
	Return string value of FITS key keyword. More...

bool	getBool (const std::string &keyword) const
	Return boolean value of FITS key keyword. More...

long	getInt (const std::string &keyword) const
	Return integer value of FITS key keyword. More...

double	getFloat (const std::string &keyword) const
	Return floating point value of FITS key keyword. More...

bool	isFixed (const std::string &keyword) const
	Indicate if value of FITS key keyword is of fixed type. More...

std::string	getComment (const std::string &keyword) const
	Return comment of FITS key keyword. More...

std::string	getComment () const
	Return complete COMMENT. More...

std::string	getHistory () const
	Return complete HISTORY. More...

std::string	getValueAsString (const std::string &keyword) const
	Return value of FITS key keyword as a string irrespective of its type. More...


size_t	getRegionLength () const
	Get number of pixels in selected region. More...

size_t	getRegionLength (const size_t dim) const
	Get length along dimension dim of selected region in pixels. More...

int	getRegionStart (const size_t dim) const
	Get start pixel coordinate in dimension dim of selected region. More...

int	getRegionEnd (const size_t dim) const
	Get end pixel coordinate in dimension dim of selected region. More...

util::Region	getRegion () const
	Return copy of selected region. More...

Protected Member Functions
void	addCommentCard (FitsCard *cardptr) throw (FitsException)
	Add a commentary card to the correct list. More...

void	addValueCard (FitsCard *cardptr) throw (FitsException)
	Add a value holding card to its proper list. More...

void	readHeader (const std::string &filename, const bool alljunk=false, unsigned char *inmemptr=NULL, size_t inmemlen=0) throw (FitsException)
	Read and parse a FITS header from file. More...

void	parseCommentToCardList (const std::string &keyword, const std::string &comment)
	Parse and add a commentstring to its list. More...

void	addJunkCard (const std::string &native_card)
	Just split 80 char card into keyword + rest and push it on the junk list. More...

void	addJunkCard (const std::string &keyword, const std::string &comment)
	Add a suitable trimmed junk card. More...

void	addJunkCard (FitsCard *cardptr)
	Add a preexisting ltl::FitsCard to junk list. More...

void	clearCardList (std::list< FitsCard * > &the_list)
	Clear a whole list of cards. More...

int	eraseCardFromList (const std::string &keyword, std::list< FitsCard * > &the_list)
	Erase first ltl::FitsCard mathcing keyword from the_list. More...

int	eraseCardsFromJunkList (const std::string &keyword)
	Erase all cards matching keyword from the ltl::FitsHeader::junk_ list. More...

FitsCard *	findCardInList (const std::string &keyword, const std::list< FitsCard * > &the_list) const
	Return pointer to card matching keyword in the_list. More...

FitsCard *	getValueCard (const std::string &keyword) const throw (FitsException)
	Return pointer to first card matching keyword on any non commentary list. More...

std::string	writeCommentsOfList (const std::list< FitsCard * > &the_list) const
	Return string holding new line broken comments of a whole list. More...

std::string	writeCardsOfList (const std::list< FitsCard * > &the_list) const
	Return string holding FITS formatted cards of a list. More...

void	copy (const FitsHeader &other)
	Copy header from other. More...

void	copyCardList (std::list< FitsCard * > &dest_list, const std::list< FitsCard * > &src_list)
	Copy list of ltl::FitsCard. More...

void	testRegion (const util::Region &testreg) const throw (FitsException)
	Test if region complies with FITS file geometry. More...

Parse Record string
The next 4 methods parse a complete 2880 char record into lists of ltl::FitsCards.
std::string::size_type	parseRecord (const std::string &record, const bool alljunk=false) throw (FitsException)
	Parse a FITS record and assign the cards to their proper lists. More...

std::string::size_type	parseMandatory (const std::string &record) throw (FitsException)
	Parse the mandatory keys of record. More...

std::string::size_type	parseNaxis (const std::string &record, std::string::size_type card_of_record=0)
	Parse cards until Naxis parameter is matched, returns card offset in record. More...

void	checkNaxis () throw (FitsException)
	Check the Naxis list, ltl::FitsException on error. More...

Parse Card String
These 2 functions parse a 80 char line card into an ltl::FitsCard.
FitsCard *	parseCard (const std::string &card) const throw (FitsException)
	Parse 80 char line into an ltl::FitsCard object. More...

std::string	getCardComment (const std::string &teststring) const throw (FitsException)
	Return the comment of a 80 char line card remainder. More...

Protected Attributes
bool	ignore_hd_
	Boolean indicating if header is not parsed. More...

bool	bint_
	Boolean indicating BSCALE and BZERO being integer. More...

bool	shutup_
	Boolean indicating if no error messages shall be written to stderr. More...

int	bitpix_
	Shortcuts to FITS keywords BITPIX, abs(BITPIX)/8 and NAXIS. More...

int	bytpix_

int	naxis_

int *	naxis_array_
	Pointer to array holding shortcuts to NAXIS keywords. More...

bool	extended_
	Shortcut indicating extension maybe present. More...

int	pcount_
	Shortcuts for calculating length of extension. More...

int	gcount_

double	bscale_
	Shortcuts to FITS keywords BSCALE and BZERO. More...

double	bzero_

off_t	data_offset_
	Offset to first element of data segment,. More...

off_t	data_length_
	Length of data segment in bytes. More...

string	filename_
	Filename associated with FitsIn/Out object. More...

unsigned char *	fitsinmemptr_
	Pointer to in-memory fits file image. More...

size_t	fitsinmemlength_
	Length of in-memory fits file. More...

unsigned char **	ptrfitsinmemptr_
	In-memory fits file image allocation data. More...

size_t *	ptrfitsinmemlength_

unsigned char *	fitsdataptr_
	Pointer to data segment map. More...

unsigned char *	fitsstreamptr_
	Pointer to actual byte in data segment for per pixel I/O. More...

size_t	fitsmaplength_
	Length of data segment map, multiple of page size. More...

util::Region *	regionptr_
	Pointer to Region (if set). More...

off_t	fitsregionoffset_
	Offset to determine first pixel of selected region. More...

bool	primary_

size_t	extno_

Static Protected Attributes
static const FitsPhysical	PH_C
	Structure holding physical FITS sizes. More...

static const FitsKnownList	KNOWN
	List of all known keywords and their types. More...

Related Functions
(Note that these are not member functions.)
template<class T >
FitsIn &	operator>> (FitsIn &fitsfile, T &a)

template<class T , int N>
FitsIn &	operator>> (FitsIn &fitsfile, MArray< T, N > &a)

template<>
FitsIn &	operator>> (FitsIn &infile, FitsOut &outfile)

FitsOut &	operator<< (FitsOut &outfile, FitsIn &infile)

FitsOut &	operator<< (FitsOut &outfile, FitsExtensionIn &infile)

FitsExtensionOut &	operator<< (FitsExtensionOut &outfile, const emptyData_ &)

FitsExtensionOut &	operator<< (FitsExtensionOut &outfile, FitsIn &infile)

Card Lists
Lists representing the FITS header structure.
MandatoryList	mandatory_
	List holding all mandatory cards. More...

NaxisList	naxis_i_
	List holding all NAXIS# cards. More...

ObserveList	observe_
	List holding reserved keywords cards which are not on other lists. More...

CommentList	comment_
	List holding the COMMENT cards. More...

HistoryList	history_
	List holding the HISTORY cards. More...

BlankList	blank_
	List holding the blank cards. More...

ArrayList	array_
	List holding array keywords cards. More...

OtherList	otherkeys_
	List holding all other cards. More...

JunkList	junk_
	List holding the cards not complying with FITS standard. More...

typedef std::list< FitsCard * >	MandatoryList

typedef MandatoryList::iterator	MandatoryIter

typedef std::list< FitsCard * >	NaxisList

typedef NaxisList::iterator	NaxisIter

typedef std::list< FitsCard * >	ExtensionList

typedef ExtensionList::iterator	ExtensionIter

typedef std::list< FitsCard * >	ObserveList

typedef ObserveList::iterator	ObserveIter

typedef std::list< FitsCard * >	CommentList

typedef CommentList::iterator	CommentIter

typedef std::list< FitsCard * >	HistoryList

typedef HistoryList::iterator	HistoryIter

typedef std::list< FitsCard * >	BlankList

typedef BlankList::iterator	BlankIter

typedef std::list< FitsCard * >	ArrayList

typedef ArrayList::iterator	ArrayIter

typedef std::list< FitsCard * >	OtherList

typedef OtherList::iterator	OtherIter

typedef std::list< FitsCard * >	JunkList

typedef JunkList::iterator	JunkIter

Detailed Description

Primary HDU and extensions in one object. Look into test/testfitsextensionio.cpp for examples.

Member Typedef Documentation

typedef std::list<FitsCard *> ltl::FitsHeader::MandatoryList

protectedinherited

typedef MandatoryList::iterator ltl::FitsHeader::MandatoryIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::NaxisList

protectedinherited

typedef NaxisList::iterator ltl::FitsHeader::NaxisIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::ExtensionList

protectedinherited

typedef ExtensionList::iterator ltl::FitsHeader::ExtensionIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::ObserveList

protectedinherited

typedef ObserveList::iterator ltl::FitsHeader::ObserveIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::CommentList

protectedinherited

typedef CommentList::iterator ltl::FitsHeader::CommentIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::HistoryList

protectedinherited

typedef HistoryList::iterator ltl::FitsHeader::HistoryIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::BlankList

protectedinherited

typedef BlankList::iterator ltl::FitsHeader::BlankIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::ArrayList

protectedinherited

typedef ArrayList::iterator ltl::FitsHeader::ArrayIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::OtherList

protectedinherited

typedef OtherList::iterator ltl::FitsHeader::OtherIter

protectedinherited

typedef std::list<FitsCard *> ltl::FitsHeader::JunkList

protectedinherited

typedef JunkList::iterator ltl::FitsHeader::JunkIter

protectedinherited

Constructor & Destructor Documentation

ltl::FitsExtensionIn::FitsExtensionIn	(	const char *	path,
		const bool	quiet_please = `false`,
		const bool	ignore_header = `false`
	)

Construct a FitsExtensionIn object from C string filename.

ltl::FitsExtensionIn::FitsExtensionIn	(	const string &	path,
		const bool	quiet_please = `false`,
		const bool	ignore_header = `false`
	)

Construct a FitsExtensionIn object from C++ string filename.

virtual ltl::FitsExtensionIn::~FitsExtensionIn ( )

virtual

Member Function Documentation

FitsIn ltl::FitsExtensionIn::getExtension	(	const string &	xtension,
		const string &	extname,
		const int	extver = `0`,
		const int	extlevel = `0`
	)

Return FitsIn object holding extension of type XTENSION with name EXTNAME and optional version EXTVER and level EXTLEVEL (get by name).

FitsIn ltl::FitsExtensionIn::getExtension ( const size_t extno )

Return FitsIn object holding extno 's extension (get by sequential number).

virtual FitsIn ltl::FitsExtensionIn::getNextExtension ( )

virtual

Return the next extension.

Reimplemented from ltl::FitsIn.

Referenced by ltl::FitsIO::operator<<().

void ltl::FitsIn::freeData ( )

inherited

Unmap data segment, free address space.

virtual void ltl::FitsIn::describeSelf ( std::ostream & os )

virtualinherited

Write FITS file geometry and class interna to out stream.

Reimplemented from ltl::FitsHeader.

unsigned char* ltl::FitsIn::begin ( )

inherited

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsBinTableIn::readColumn(), ltl::FitsIn::readDataArray(), ltl::FitsBinTableIn::readPColumn(), and ltl::FitsIn::readRegionArray().

unsigned char* ltl::FitsIn::end ( )

inherited

Referenced by ltl::FitsBinTableIn::readColumn().

void ltl::FitsIn::resetPosition ( )

inherited

Referenced by ltl::FitsIn::getNextPixel().

void ltl::FitsIn::setPosition ( off_t offset )

inherited

ptrdiff_t ltl::FitsIn::getPosition ( )

inherited

void ltl::FitsIn::setRegion	(	const util::Region &	fregion	)
throw	(	FitsException
	)

inherited

Select region of interest in data segment.

Referenced by ltl::FitsIn::getRegionArray(), ltl::insertFitsMArray(), and ltl::FitsIn::readRegionArray().

void ltl::FitsIn::resetRegion ( )

inherited

Reset region of interest in data segment to full region.

Referenced by ltl::FitsIn::getRegionArray(), ltl::insertFitsMArray(), and ltl::FitsIn::readRegionArray().

FitsHeader ltl::FitsIn::getHeader ( ) const

inherited

Return copy of FITS header.

template<class T >

T * ltl::FitsIn::getRegionArray ( const util::Region & reg )

inherited

Return array holding preselected region of data segment.

References ltl::FitsIn::resetRegion(), and ltl::FitsIn::setRegion().

template<class T >

void ltl::FitsIn::readRegionArray	(	T &	i,
		const util::Region &	reg
	)

inherited

Fill container via iterator i with region reg of data segment.

References ltl::FitsIn::resetRegion(), and ltl::FitsIn::setRegion().

Referenced by ltl::insertFitsMArray(), and ltl::FitsIn::readDataArray().

template<class T >

void ltl::FitsIn::readRegionArray ( T & i )

inherited

Fill container via iterator i with preselected region of data segment.

References ltl::FitsIn::begin(), ltl::FitsHeader::bitpix_, ltl::FitsHeader::getBscale(), ltl::FitsHeader::getBzero(), ltl::FitsHeader::getFullRegion(), and ltl::FitsIO::regionptr_.

template<class T >

void ltl::FitsIn::readDataArray ( T & i )

inherited

Fill container via iterator i with data segment.

References ltl::FitsIn::begin(), ltl::FitsHeader::bitpix_, ltl::FitsHeader::getBscale(), ltl::FitsHeader::getBzero(), ltl::FitsHeader::getDataLength(), ltl::FitsIn::readRegionArray(), and ltl::FitsIO::regionptr_.

Referenced by ltl::insertFitsMArray().

template<class T >

T * ltl::FitsIn::getDataArray ( const T )

inherited

Return array holding data segment.

References ltl::FitsIn::begin(), ltl::FitsHeader::bitpix_, ltl::FitsHeader::getBscale(), ltl::FitsHeader::getBzero(), ltl::FitsHeader::getDataLength(), ltl::FitsHeader::getFullRegion(), and ltl::FitsIO::regionptr_.

Referenced by ltl::getFitsMArray().

template<class T >

T ltl::FitsIn::getNextPixel ( const T )

inherited

Read next pixel of datasegment with per pixel read.

References ltl::FitsHeader::bitpix_, ltl::FitsHeader::bscale_, ltl::FitsHeader::bzero_, ltl::FitsIO::fitsstreamptr_, ltl::FitsIn::resetPosition(), and ltl::FitsIO::streampos().

Referenced by ltl::FitsIn::operator>>().

std::string ltl::FitsHeader::adjustKeyword ( std::string keyword ) const

inherited

Return keyword trimmed (or expanded) to a width of 8 chars.

Trailing blanks are significant for FITS keywords. If you want to add missing trailing blanks or simply trim too long keywords you may want to use this method.

void ltl::FitsHeader::addCommentCard	(	const std::string &	keyword,
		const std::string &	comment
	)

inherited

Add a commentary card.

void ltl::FitsHeader::addCommentCard	(	FitsCard *	cardptr	)
throw	(	FitsException
	)

protectedinherited

Add a commentary card to the correct list.

void ltl::FitsHeader::addHistory ( const std::string & history )

inherited

Add a history of arbitrary length.

void ltl::FitsHeader::addComment ( const std::string & comment )

inherited

Add a history of arbitrary length.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const std::string &	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add a string value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const char *	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add a char value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const bool	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add a boolean value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const int	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add an integer value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const long	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add an integer value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const float	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add a floating point value card.

void ltl::FitsHeader::addValueCard	(	const std::string &	keyword,
		const double	value,
		const std::string	comment = `""`,
		const bool	fixed = `true`
	)

inherited

Add a floating point value card.

void ltl::FitsHeader::addValueCard	(	FitsCard *	cardptr	)
throw	(	FitsException
	)

protectedinherited

Add a value holding card to its proper list.

If the card has a bad syntax it's put on the ltl::FitsHeader::junk_ list.

Exceptions

ltl::FitsException on error.

int ltl::FitsHeader::eraseCard	(	const std::string &	keyword	)
throw	(	FitsException
	)

inherited

Erase FITS card keyword.

Returns 0 on success, -1 on keyword not found.

Exceptions

ltl::FitsException on forbidden erasures.

off_t ltl::FitsHeader::getDataOffset ( ) const

inherited

Return the byte offset within the file to the data segment.

int ltl::FitsHeader::getBitpix ( ) const

inherited

Return BITPIX setting.

int ltl::FitsHeader::getBytpix ( ) const

inherited

Return bytes per pixel, i.e. abs( bitpix_ ) / 8.

int ltl::FitsHeader::getNaxis ( ) const

inherited

Return NAXIS setting.

Referenced by ltl::getFitsMArray(), and ltl::insertFitsMArray().

int ltl::FitsHeader::getNaxis ( const int i ) const

inherited

Return width of i NAXIS.

double ltl::FitsHeader::getBscale ( ) const

inherited

Return BSCALE setting.

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsIn::readDataArray(), and ltl::FitsIn::readRegionArray().

double ltl::FitsHeader::getBzero ( ) const

inherited

Return BZERO setting.

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsIn::readDataArray(), and ltl::FitsIn::readRegionArray().

void ltl::FitsHeader::setBscale ( const double value )

inherited

Set the BSCALE key to value.

void ltl::FitsHeader::setBzero ( const double value )

inherited

Set the BZERO key to value.

util::Region ltl::FitsHeader::getFullRegion ( ) const

inherited

Return a util::Region according to the NAXIS geometry.

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsIn::readRegionArray(), and ltl::FitsOut::writeRegionArray().

off_t ltl::FitsHeader::getDataLength ( ) const

inherited

Return the size of the data segment in bytes.

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsIn::readDataArray(), and ltl::FitsOut::writeDataArray().

std::string ltl::FitsHeader::getString ( const std::string & keyword ) const

inherited

Return string value of FITS key keyword.

bool ltl::FitsHeader::getBool ( const std::string & keyword ) const

inherited

Return boolean value of FITS key keyword.

long ltl::FitsHeader::getInt ( const std::string & keyword ) const

inherited

Return integer value of FITS key keyword.

double ltl::FitsHeader::getFloat ( const std::string & keyword ) const

inherited

Return floating point value of FITS key keyword.

bool ltl::FitsHeader::isFixed ( const std::string & keyword ) const

inherited

Indicate if value of FITS key keyword is of fixed type.

std::string ltl::FitsHeader::getComment ( const std::string & keyword ) const

inherited

Return comment of FITS key keyword.

std::string ltl::FitsHeader::getComment ( ) const

inherited

Return complete COMMENT.

std::string ltl::FitsHeader::getHistory ( ) const

inherited

Return complete HISTORY.

std::string ltl::FitsHeader::getValueAsString ( const std::string & keyword ) const

inherited

Return value of FITS key keyword as a string irrespective of its type.

std::string ltl::FitsHeader::writeHeader ( const bool with_junk = false )

inherited

Return a new valid FITS file format header.

void ltl::FitsHeader::readHeader	(	const std::string &	filename,
		const bool	alljunk = `false`,
		unsigned char *	inmemptr = `NULL`,
		size_t	inmemlen = `0`
	)
throw	(	FitsException
	)

protectedinherited

Read and parse a FITS header from file.

std::string::size_type ltl::FitsHeader::parseRecord	(	const std::string &	record,
		const bool	alljunk = `false`
	)
throw	(	FitsException
	)

protectedinherited

Parse a FITS record and assign the cards to their proper lists.

Returns the length of the record or 0 if "END" was found.

Exceptions

ltl::FitsException on error.

std::string::size_type ltl::FitsHeader::parseMandatory	(	const std::string &	record	)
throw	(	FitsException
	)

protectedinherited

Parse the mandatory keys of record.

Return offset to next non-mandatory card within record.

Exceptions

ltl::FitsException on error.

std::string::size_type ltl::FitsHeader::parseNaxis	(	const std::string &	record,
		std::string::size_type	card_of_record = `0`
	)

protectedinherited

Parse cards until Naxis parameter is matched, returns card offset in record.

void ltl::FitsHeader::checkNaxis	(		)
throw	(	FitsException
	)

protectedinherited

Check the Naxis list, ltl::FitsException on error.

FitsCard* ltl::FitsHeader::parseCard	(	const std::string &	card	)	const
throw	(	FitsException
	)

protectedinherited

Parse 80 char line into an ltl::FitsCard object.

std::string ltl::FitsHeader::getCardComment	(	const std::string &	teststring	)	const
throw	(	FitsException
	)

protectedinherited

Return the comment of a 80 char line card remainder.

void ltl::FitsHeader::parseCommentToCardList	(	const std::string &	keyword,
		const std::string &	comment
	)

protectedinherited

Parse and add a commentstring to its list.

Can be long, will be broken into lines)

void ltl::FitsHeader::addJunkCard ( const std::string & native_card )

protectedinherited

Just split 80 char card into keyword + rest and push it on the junk list.

void ltl::FitsHeader::addJunkCard	(	const std::string &	keyword,
		const std::string &	comment
	)

protectedinherited

Add a suitable trimmed junk card.

void ltl::FitsHeader::addJunkCard ( FitsCard * cardptr )

protectedinherited

Add a preexisting ltl::FitsCard to junk list.

void ltl::FitsHeader::clearCardList ( std::list< FitsCard * > & the_list )

protectedinherited

Clear a whole list of cards.

int ltl::FitsHeader::eraseCardFromList	(	const std::string &	keyword,
		std::list< FitsCard * > &	the_list
	)

protectedinherited

Erase first ltl::FitsCard mathcing keyword from the_list.

Return -1 if keyword not found, otherwise 0.

int ltl::FitsHeader::eraseCardsFromJunkList ( const std::string & keyword )

protectedinherited

Erase all cards matching keyword from the ltl::FitsHeader::junk_ list.

Return the number of erased cards.

FitsCard * ltl::FitsHeader::findCardInList	(	const std::string &	keyword,
		const std::list< FitsCard * > &	the_list
	)		const

protectedinherited

Return pointer to card matching keyword in the_list.

Return NULL if no card is found.

Referenced by ltl::FitsBinTableIn::readColumn().

FitsCard * ltl::FitsHeader::getValueCard	(	const std::string &	keyword	)	const
throw	(	FitsException
	)

protectedinherited

Return pointer to first card matching keyword on any non commentary list.

Exceptions

ltl::FitsException on error, i.e. no matching card found.

std::string ltl::FitsHeader::writeCommentsOfList ( const std::list< FitsCard * > & the_list ) const

protectedinherited

Return string holding new line broken comments of a whole list.

std::string ltl::FitsHeader::writeCardsOfList ( const std::list< FitsCard * > & the_list ) const

protectedinherited

Return string holding FITS formatted cards of a list.

void ltl::FitsHeader::copy ( const FitsHeader & other )

protectedinherited

Copy header from other.

void ltl::FitsHeader::copyCardList	(	std::list< FitsCard * > &	dest_list,
		const std::list< FitsCard * > &	src_list
	)

protectedinherited

Copy list of ltl::FitsCard.

void ltl::FitsHeader::testRegion	(	const util::Region &	testreg	)	const
throw	(	FitsException
	)

protectedinherited

Test if region complies with FITS file geometry.

string ltl::FitsIO::getFilename ( ) const

inlineinherited

Return ltl::FitsIO::filename_ .

References ltl::FitsIO::filename_.

unsigned char* ltl::FitsIO::streampos ( ) const

inlineinherited

Return ltl::FitsIO::fitsstreamptr_ .

References ltl::FitsIO::fitsstreamptr_.

Referenced by ltl::FitsIn::getNextPixel(), and ltl::FitsOut::setNextPixel().

size_t ltl::FitsIO::getRegionLength ( ) const

inherited

Get number of pixels in selected region.

Referenced by ltl::getFitsMArray(), and ltl::insertFitsMArray().

size_t ltl::FitsIO::getRegionLength ( const size_t dim ) const

inherited

Get length along dimension dim of selected region in pixels.

int ltl::FitsIO::getRegionStart ( const size_t dim ) const

inherited

Get start pixel coordinate in dimension dim of selected region.

int ltl::FitsIO::getRegionEnd ( const size_t dim ) const

inherited

Get end pixel coordinate in dimension dim of selected region.

Referenced by ltl::insertFitsMArray().

util::Region ltl::FitsIO::getRegion ( ) const

inherited

Return copy of selected region.

Referenced by ltl::insertFitsMArray().

size_t ltl::FitsExtension::getExtNo ( ) const

inherited

Return number of actual extension.

bool ltl::FitsExtension::getPrimary ( ) const

inherited

Return status of primary flag, i.e. reading or writing primary header / data.

Referenced by ltl::FitsIO::operator<<().

void ltl::FitsExtension::resetExtNo ( )

inherited

Reset Extension counter and raise primary flag.

Referenced by ltl::FitsIO::operator<<().

void ltl::FitsExtension::incExtNo ( )

inherited

Increment Extension counter and lower primary flag.

Referenced by ltl::FitsIO::operator<<().

void ltl::FitsExtension::unsetPrimary ( )

inherited

Lower primary flag.

Referenced by ltl::FitsIO::operator<<().

Member Data Documentation

bool ltl::FitsIn::ignore_hd_

protectedinherited

Boolean indicating if header is not parsed.

bool ltl::FitsIn::bint_

protectedinherited

Boolean indicating BSCALE and BZERO being integer.

bool ltl::FitsHeader::shutup_

protectedinherited

Boolean indicating if no error messages shall be written to stderr.

int ltl::FitsHeader::bitpix_

protectedinherited

Shortcuts to FITS keywords BITPIX, abs(BITPIX)/8 and NAXIS.

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsIn::getNextPixel(), ltl::FitsIn::readDataArray(), ltl::FitsIn::readRegionArray(), ltl::FitsOut::setNextPixel(), ltl::FitsOut::writeDataArray(), and ltl::FitsOut::writeRegionArray().

int ltl::FitsHeader::bytpix_

protectedinherited

int ltl::FitsHeader::naxis_

protectedinherited

int* ltl::FitsHeader::naxis_array_

protectedinherited

Pointer to array holding shortcuts to NAXIS keywords.

Referenced by ltl::FitsBinTableIn::readColumn(), and ltl::FitsBinTableIn::readPColumn().

bool ltl::FitsHeader::extended_

protectedinherited

Shortcut indicating extension maybe present.

int ltl::FitsHeader::pcount_

protectedinherited

Shortcuts for calculating length of extension.

int ltl::FitsHeader::gcount_

protectedinherited

double ltl::FitsHeader::bscale_

protectedinherited

Shortcuts to FITS keywords BSCALE and BZERO.

Referenced by ltl::FitsIn::getNextPixel().

double ltl::FitsHeader::bzero_

protectedinherited

Referenced by ltl::FitsIn::getNextPixel().

off_t ltl::FitsHeader::data_offset_

protectedinherited

Offset to first element of data segment,.

off_t ltl::FitsHeader::data_length_

protectedinherited

Length of data segment in bytes.

const FitsPhysical ltl::FitsHeader::PH_C

staticprotectedinherited

Structure holding physical FITS sizes.

const FitsKnownList ltl::FitsHeader::KNOWN

staticprotectedinherited

List of all known keywords and their types.

MandatoryList ltl::FitsHeader::mandatory_

protectedinherited

List holding all mandatory cards.

NaxisList ltl::FitsHeader::naxis_i_

protectedinherited

List holding all NAXIS# cards.

ltl::FitsHeader::ObserveList ltl::FitsHeader::observe_

protectedinherited

List holding reserved keywords cards which are not on other lists.

These are AUTHOR, BLOCKED, DATE, DATE-OBS, DATExxxx, EQUINOX, EPOCH, INSTRUME, OBJECT, OBSERVER, ORIGIN, REFERENC and TELESCOP. EPOCH will be copied to EQUINOX if EQUINOX not present.

CommentList ltl::FitsHeader::comment_

protectedinherited

List holding the COMMENT cards.

HistoryList ltl::FitsHeader::history_

protectedinherited

List holding the HISTORY cards.

BlankList ltl::FitsHeader::blank_

protectedinherited

List holding the blank cards.

ltl::FitsHeader::ArrayList ltl::FitsHeader::array_

protectedinherited

List holding array keywords cards.

These are BSCALE, BZERO, BUNIT, BLANK, CTYPEn, CRPIXn, CRVALn, CRDELTn, CROTAn, DATAMIN and DATAMAX.

OtherList ltl::FitsHeader::otherkeys_

protectedinherited

List holding all other cards.

JunkList ltl::FitsHeader::junk_

protectedinherited

List holding the cards not complying with FITS standard.

string ltl::FitsIO::filename_

protectedinherited

Filename associated with FitsIn/Out object.

Referenced by ltl::FitsIO::getFilename().

unsigned char* ltl::FitsIO::fitsinmemptr_

protectedinherited

Pointer to in-memory fits file image.

size_t ltl::FitsIO::fitsinmemlength_

protectedinherited

Length of in-memory fits file.

unsigned char** ltl::FitsIO::ptrfitsinmemptr_

protectedinherited

In-memory fits file image allocation data.

size_t* ltl::FitsIO::ptrfitsinmemlength_

protectedinherited

unsigned char* ltl::FitsIO::fitsdataptr_

protectedinherited

Pointer to data segment map.

unsigned char* ltl::FitsIO::fitsstreamptr_

protectedinherited

Pointer to actual byte in data segment for per pixel I/O.

Referenced by ltl::FitsIn::getNextPixel(), ltl::FitsOut::setNextPixel(), and ltl::FitsIO::streampos().

size_t ltl::FitsIO::fitsmaplength_

protectedinherited

Length of data segment map, multiple of page size.

util::Region* ltl::FitsIO::regionptr_

protectedinherited

Pointer to Region (if set).

Referenced by ltl::FitsIn::getDataArray(), ltl::FitsOut::isRegion(), ltl::FitsIn::readDataArray(), ltl::FitsIn::readRegionArray(), and ltl::FitsOut::writeRegionArray().

off_t ltl::FitsIO::fitsregionoffset_

protectedinherited

Offset to determine first pixel of selected region.

bool ltl::FitsExtension::primary_

protectedinherited

size_t ltl::FitsExtension::extno_

protectedinherited

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Related Functions

Card Lists

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation