ltl::FitsBinTableIn Class Reference
[MArray FITS file I/O]

Class for binary table extensions. More...

Inherits ltl::FitsIn.

List of all members.

Public Member Functions

• FitsBinTableIn (const FitsIn &other)
• ~FitsBinTableIn ()
• template<class T , int N> MArray< T, N > readColumn (const string &ttype, const int startrow=1, const int endrow=0)
• template<class T , int N> MArray< T, N > readColumn (const int colno, const int startrow=1, const int endrow=0)
• template<class T , int N, int BITPIX> MArray< T, N > readColumn (const int colno, const int startrow=1, int endrow=0)
• template<class T , int N, int BITPIX> MArray< T, N > readPColumn (const int colno, const int rowno=1)
• int getTfields (const int colno) const
• char getTformt (const int colno) const
• size_t getTformr (const int colno) const
• void freeData ()

  Unmap data segment, free address space.
  

• virtual void describeSelf (std::ostream &os)

  Write FITS file geometry and class interna to out stream.
  

• FitsHeader getHeader () const

  Return copy of FITS header.
  

• virtual FitsIn getNextExtension ()

  Return input object for next FITS extension when present.
  

• std::string adjustKeyword (std::string keyword) const

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

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

  Erase FITS card keyword.
  

• off_t getDataOffset () const

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

• off_t getDataLength () const

  Return the size of the data segment in bytes.
  

• std::string writeHeader (const bool with_junk=false)

  Return a new valid FITS file format header.
  

• string getFilename () const

  Return ltl::FitsIO::filename_ .
  

• unsigned char * streampos () const

  Return ltl::FitsIO::fitsstreamptr_ .
  

• 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.
  

• void resetRegion ()

  Reset region of interest in data segment to full region.
  

• template<class T > T * getRegionArray (const util::Region &reg)

  Return array holding preselected region of data segment.
  

• template<class T > void readRegionArray (T &i, const util::Region &reg)

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

• template<class T > void readRegionArray (T &i)

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

• template<class T > void readDataArray (T &i)

  Fill container via iterator i with data segment.
  

• template<class T > T * getDataArray (const T)

  Return array holding data segment.
  

• template<class T > T getNextPixel (const T)

  Read next pixel of datasegment with per pixel read.
  

Adding new Cards

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

  Add a commentary card.
  

• void addHistory (const std::string &history)

  Add a history of arbitrary length.
  

• void addComment (const std::string &comment)

  Add a history of arbitrary length.
  

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

  Add a string value card.
  

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

  Add a char value card.
  

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

  Add a boolean value card.
  

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

  Add an integer value card.
  

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

  Add an integer value card.
  

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

  Add a floating point value card.
  

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

  Add a floating point value card.
  

Shortcuts

Get (and set) values of mandatories and array keys via shortcuts.

• int getBitpix () const

  Return BITPIX setting.
  

• int getBytpix () const

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

• int getNaxis () const

  Return NAXIS setting.
  

• int getNaxis (const int i) const

  Return width of i NAXIS.
  

• double getBscale () const

  Return BSCALE setting.
  

• double getBzero () const

  Return BZERO setting.
  

• void setBscale (const double value)

  Set the BSCALE key to value.
  

• void setBzero (const double value)

  Set the BZERO key to value.
  

• util::Region getFullRegion () const

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

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.
  

• bool getBool (const std::string &keyword) const

  Return boolean value of FITS key keyword.
  

• long getInt (const std::string &keyword) const

  Return integer value of FITS key keyword.
  

• double getFloat (const std::string &keyword) const

  Return floating point value of FITS key keyword.
  

• bool isFixed (const std::string &keyword) const

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

• std::string getComment (const std::string &keyword) const

  Return comment of FITS key keyword.
  

• std::string getComment () const

  Return complete COMMENT.
  

• std::string getHistory () const

  Return complete HISTORY.
  

• std::string getValueAsString (const std::string &keyword) const

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

• size_t getRegionLength () const

  Get number of pixels in selected region.
  

• size_t getRegionLength (const size_t dim) const

  Get length along dimension dim of selected region in pixels.
  

• int getRegionStart (const size_t dim) const

  Get start pixel coordinate in dimension dim of selected region.
  

• int getRegionEnd (const size_t dim) const

  Get end pixel coordinate in dimension dim of selected region.
  

• util::Region getRegion () const

  Return copy of selected region.
  

Protected Member Functions

• void addCommentCard (FitsCard *cardptr) throw (FitsException)

  Add a commentary card to the correct list.
  

• void addValueCard (FitsCard *cardptr) throw (FitsException)

  Add a value holding card to its proper list.
  

• 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.
  

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

  Parse and add a commentstring to its list.
  

• void addJunkCard (const std::string &native_card)

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

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

  Add a suitable trimmed junk card.
  

• void addJunkCard (FitsCard *cardptr)

  Add a preexisting ltl::FitsCard to junk list.
  

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

  Clear a whole list of cards.
  

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

  Erase first ltl::FitsCard mathcing keyword from the_list.
  

• int eraseCardsFromJunkList (const std::string &keyword)

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

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

  Return pointer to card matching keyword in the_list.
  

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

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

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

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

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

  Return string holding FITS formatted cards of a list.
  

• void copy (const FitsHeader &other)

  Copy header from other.
  

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

  Copy list of ltl::FitsCard.
  

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

  Test if region complies with FITS file geometry.
  

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.
  

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

  Parse the mandatory keys of record.
  

• 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.
  

• void checkNaxis () throw (FitsException)

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

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.
  

• std::string getCardComment (const std::string &teststring) const throw (FitsException)

  Return the comment of a 80 char line card remainder.
  

Protected Attributes

• bool ignore_hd_

  Boolean indicating if header is not parsed.
  

• bool bint_

  Boolean indicating BSCALE and BZERO being integer.
  

• bool shutup_

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

• int bitpix_

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

• int bytpix_
• int naxis_
• int * naxis_array_

  Pointer to array holding shortcuts to NAXIS keywords.
  

• bool extended_

  Shortcut indicating extension maybe present.
  

• int pcount_

  Shortcuts for calculating length of extension.
  

• int gcount_
• double bscale_

  Shortcuts to FITS keywords BSCALE and BZERO.
  

• double bzero_
• off_t data_offset_

  Offset to first element of data segment,.
  

• off_t data_length_

  Length of data segment in bytes.
  

• string filename_

  Filename associated with FitsIn/Out object.
  

• unsigned char * fitsinmemptr_

  Pointer to in-memory fits file image.
  

• size_t fitsinmemlength_

  Length of in-memory fits file.
  

• unsigned char ** ptrfitsinmemptr_

  In-memory fits file image allocation data.
  

• size_t * ptrfitsinmemlength_
• unsigned char * fitsdataptr_

  Pointer to data segment map.
  

• unsigned char * fitsstreamptr_

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

• size_t fitsmaplength_

  Length of data segment map, multiple of page size.
  

• util::Region * regionptr_

  Pointer to Region (if set).
  

• off_t fitsregionoffset_

  Offset to determine first pixel of selected region.
  

Static Protected Attributes

• static const FitsPhysical PH_C

  Structure holding physical FITS sizes.
  

• static const FitsKnownList KNOWN

  List of all known keywords and their types.
  

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.
  

• NaxisList naxis_i_

  List holding all NAXIS# cards.
  

• ExtensionList extension_

  List holding EXTENSION cards.
  

• ObserveList observe_

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

• CommentList comment_

  List holding the COMMENT cards.
  

• HistoryList history_

  List holding the HISTORY cards.
  

• BlankList blank_

  List holding the blank cards.
  

• ArrayList array_

  List holding array keywords cards.
  

• OtherList otherkeys_

  List holding all other cards.
  

• JunkList junk_

  List holding the cards not complying with FITS standard.
  

• 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

Class for binary table extensions.

---

Member Typedef Documentation

typedef std::list<FitsCard *> ltl::FitsHeader::MandatoryList [protected, inherited]

typedef MandatoryList::iterator ltl::FitsHeader::MandatoryIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::NaxisList [protected, inherited]

typedef NaxisList::iterator ltl::FitsHeader::NaxisIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::ExtensionList [protected, inherited]

typedef ExtensionList::iterator ltl::FitsHeader::ExtensionIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::ObserveList [protected, inherited]

typedef ObserveList::iterator ltl::FitsHeader::ObserveIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::CommentList [protected, inherited]

typedef CommentList::iterator ltl::FitsHeader::CommentIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::HistoryList [protected, inherited]

typedef HistoryList::iterator ltl::FitsHeader::HistoryIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::BlankList [protected, inherited]

typedef BlankList::iterator ltl::FitsHeader::BlankIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::ArrayList [protected, inherited]

typedef ArrayList::iterator ltl::FitsHeader::ArrayIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::OtherList [protected, inherited]

typedef OtherList::iterator ltl::FitsHeader::OtherIter [protected, inherited]

typedef std::list<FitsCard *> ltl::FitsHeader::JunkList [protected, inherited]

typedef JunkList::iterator ltl::FitsHeader::JunkIter [protected, inherited]

---

Constructor & Destructor Documentation

ltl::FitsBinTableIn::FitsBinTableIn

(

const FitsIn &

other

)

ltl::FitsBinTableIn::~FitsBinTableIn

(

)

---

Member Function Documentation

template<class T , int N>

MArray< T, N > ltl::FitsBinTableIn::readColumn	(	const string &	ttype,
		const int	startrow = 1,
		const int	endrow = 0
	)			[inline]

References ltl::FitsHeader::extension_, and ltl::FitsHeader::findCardInList().

template<class T , int N, int BITPIX>

MArray< T, N > ltl::FitsBinTableIn::readColumn	(	const int	colno,
		const int	startrow = 1,
		const int	endrow = 0
	)			[inline]

References ltl::MArray< T, N >::makeReference().

template<class T , int N, int BITPIX>

MArray<T, N> ltl::FitsBinTableIn::readColumn	(	const int	colno,
		const int	startrow = 1,
		int	endrow = 0
	)			[inline]

template<class T , int N, int BITPIX>

MArray< T, N > ltl::FitsBinTableIn::readPColumn	(	const int	colno,
		const int	rowno = 1
	)			[inline]

References ltl::FitsIn::begin(), and ltl::FitsHeader::naxis_array_.

int ltl::FitsBinTableIn::getTfields

(

const int

colno

)

const

char ltl::FitsBinTableIn::getTformt

(

const int

colno

)

const

size_t ltl::FitsBinTableIn::getTformr

(

const int

colno

)

const

void ltl::FitsIn::freeData

(

)

[inherited]

Unmap data segment, free address space.

virtual void ltl::FitsIn::describeSelf

(

std::ostream &

os

)

[virtual, inherited]

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::FitsIn::readDataArray(), readPColumn(), and ltl::FitsIn::readRegionArray().

unsigned char* ltl::FitsIn::end

(

)

[inherited]

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.

virtual FitsIn ltl::FitsIn::getNextExtension

(

)

[virtual, inherited]

Return input object for next FITS extension when present.

Reimplemented in ltl::FitsExtensionIn.

template<class T >

T * ltl::FitsIn::getRegionArray

(

const util::Region &

reg

)

[inline, 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
	)			[inline, 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

)

[inline, 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

)

[inline, 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

)

[inline, 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

)

[inline, 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) [protected, inherited]

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) [protected, inherited]

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) [protected, inherited]

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) [protected, inherited]

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) [protected, inherited]

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
	)			[protected, inherited]

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

void ltl::FitsHeader::checkNaxis

(

)

throw (FitsException) [protected, inherited]

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

FitsCard* ltl::FitsHeader::parseCard

(

const std::string &

card

)

const throw (FitsException) [protected, inherited]

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

std::string ltl::FitsHeader::getCardComment

(

const std::string &

teststring

)

const throw (FitsException) [protected, inherited]

Return the comment of a 80 char line card remainder.

void ltl::FitsHeader::parseCommentToCardList	(	const std::string &	keyword,
		const std::string &	comment
	)			[protected, inherited]

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

)

[protected, inherited]

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
	)			[protected, inherited]

Add a suitable trimmed junk card.

void ltl::FitsHeader::addJunkCard

(

FitsCard *

cardptr

)

[protected, inherited]

Add a preexisting ltl::FitsCard to junk list.

void ltl::FitsHeader::clearCardList

(

std::list< FitsCard * > &

the_list

)

[protected, inherited]

Clear a whole list of cards.

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

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

)

[protected, inherited]

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 [protected, inherited]

Return pointer to card matching keyword in the_list.

Return NULL if no card is found.

Referenced by readColumn().

FitsCard * ltl::FitsHeader::getValueCard

(

const std::string &

keyword

)

const throw (FitsException) [protected, inherited]

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 [protected, inherited]

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

std::string ltl::FitsHeader::writeCardsOfList

(

const std::list< FitsCard * > &

the_list

)

const [protected, inherited]

Return string holding FITS formatted cards of a list.

void ltl::FitsHeader::copy

(

const FitsHeader &

other

)

[protected, inherited]

Copy header from other.

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

Copy list of ltl::FitsCard.

void ltl::FitsHeader::testRegion

(

const util::Region &

testreg

)

const throw (FitsException) [protected, inherited]

Test if region complies with FITS file geometry.

string ltl::FitsIO::getFilename

(

)

const [inline, inherited]

Return ltl::FitsIO::filename_ .

References ltl::FitsIO::filename_.

unsigned char* ltl::FitsIO::streampos

(

)

const [inline, inherited]

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().

---

Member Data Documentation

bool ltl::FitsIn::ignore_hd_ [protected, inherited]

Boolean indicating if header is not parsed.

bool ltl::FitsIn::bint_ [protected, inherited]

Boolean indicating BSCALE and BZERO being integer.

bool ltl::FitsHeader::shutup_ [protected, inherited]

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

int ltl::FitsHeader::bitpix_ [protected, inherited]

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_ [protected, inherited]

int ltl::FitsHeader::naxis_ [protected, inherited]

int* ltl::FitsHeader::naxis_array_ [protected, inherited]

Pointer to array holding shortcuts to NAXIS keywords.

Referenced by readPColumn().

bool ltl::FitsHeader::extended_ [protected, inherited]

Shortcut indicating extension maybe present.

int ltl::FitsHeader::pcount_ [protected, inherited]

Shortcuts for calculating length of extension.

int ltl::FitsHeader::gcount_ [protected, inherited]

double ltl::FitsHeader::bscale_ [protected, inherited]

Shortcuts to FITS keywords BSCALE and BZERO.

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

double ltl::FitsHeader::bzero_ [protected, inherited]

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

off_t ltl::FitsHeader::data_offset_ [protected, inherited]

Offset to first element of data segment,.

off_t ltl::FitsHeader::data_length_ [protected, inherited]

Length of data segment in bytes.

const FitsPhysical ltl::FitsHeader::PH_C [static, protected, inherited]

Structure holding physical FITS sizes.

const FitsKnownList ltl::FitsHeader::KNOWN [static, protected, inherited]

List of all known keywords and their types.

MandatoryList ltl::FitsHeader::mandatory_ [protected, inherited]

List holding all mandatory cards.

NaxisList ltl::FitsHeader::naxis_i_ [protected, inherited]

List holding all NAXIS# cards.

ExtensionList ltl::FitsHeader::extension_ [protected, inherited]

List holding EXTENSION cards.

Referenced by readColumn().

ltl::FitsHeader::ObserveList ltl::FitsHeader::observe_ [protected, inherited]

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_ [protected, inherited]

List holding the COMMENT cards.

HistoryList ltl::FitsHeader::history_ [protected, inherited]

List holding the HISTORY cards.

BlankList ltl::FitsHeader::blank_ [protected, inherited]

List holding the blank cards.

ltl::FitsHeader::ArrayList ltl::FitsHeader::array_ [protected, inherited]

List holding array keywords cards.

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

OtherList ltl::FitsHeader::otherkeys_ [protected, inherited]

List holding all other cards.

JunkList ltl::FitsHeader::junk_ [protected, inherited]

List holding the cards not complying with FITS standard.

string ltl::FitsIO::filename_ [protected, inherited]

Filename associated with FitsIn/Out object.

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

unsigned char* ltl::FitsIO::fitsinmemptr_ [protected, inherited]

Pointer to in-memory fits file image.

size_t ltl::FitsIO::fitsinmemlength_ [protected, inherited]

Length of in-memory fits file.

unsigned char** ltl::FitsIO::ptrfitsinmemptr_ [protected, inherited]

In-memory fits file image allocation data.

size_t* ltl::FitsIO::ptrfitsinmemlength_ [protected, inherited]

unsigned char* ltl::FitsIO::fitsdataptr_ [protected, inherited]

Pointer to data segment map.

unsigned char* ltl::FitsIO::fitsstreamptr_ [protected, inherited]

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_ [protected, inherited]

Length of data segment map, multiple of page size.

util::Region* ltl::FitsIO::regionptr_ [protected, inherited]

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_ [protected, inherited]

Offset to determine first pixel of selected region.