Simplified interface to FITS tables with Casacore Look and Feel. More...

#include <FITSTable.h>

Inheritance diagram for casacore::FITSTabular:

Public Member Functions
virtual	~FITSTabular ()

virtual Bool	isValid () const =0
	isValid() returns False if this object isn't a valid Tabular data structure. More...

virtual const TableRecord &	keywords () const =0
	Returns keywords which are associated with the underlying FITS files. More...

virtual const RecordDesc &	description () const =0
	Returns the description of the underlying FITS table. More...

virtual const Record &	units () const =0
	Returns any TUNITnnn associated with a column (the field names are the column names, each field value is the TUNITnnn value for that field). More...

virtual const Record &	displayFormats () const =0
	Returns any TDISPnnn associated with a column (the field names are the column names, each field value is the TDISPnnn value for that field). More...

virtual const Record &	nulls () const =0
	Returns any TNULLnnn associated with a column (the field names are the column names, each field value is the TNULLnnn value for that field). More...

virtual Bool	pastEnd () const =0
	Returns True if we have advanced past the end of data. More...

virtual void	next ()=0
	Advance the row if possible (guaranteed harmless if pastEnd() is True. More...

virtual Bool	reopen (const String &)
	Reopen the table, default behavior is to do nothing, return False. More...

virtual const String &	name () const =0
	return the name More...

virtual Bool	hasChanged () const
	Has the description changed since construction, default is False. More...

virtual void	resetChangedFlag ()
	reset the changed flag, default do nothing More...

virtual const Record &	currentRow () const =0
	Return the currentRow. More...

Static Public Member Functions
static TableRecord	keywordsFromHDU (HeaderDataUnit &hdu, Bool allKeywords=False)
	Helper function for retrieving keywords from a native-FITS hdu. More...

static RecordDesc	descriptionFromHDU (BinaryTableExtension &hdu)
	Helper function for retrieving a description from a native-FITS hdu. More...

static Record	subStringShapeFromHDU (BinaryTableExtension &hdu)
	Help function for retrieving any shape information from String columns using the SubString convention. More...

static Record	unitsFromHDU (BinaryTableExtension &hdu)
	Helper function for retrieving the TUNITnnn from a native-FITS hdu. More...

static Record	displayFormatsFromHDU (BinaryTableExtension &hdu)
	Helper function for retrieving the TDISPnnn from a native-FITS hdu. More...

static Record	nullsFromHDU (BinaryTableExtension &hdu)
	Helper function for retrieving the TNULLnnn from a native-FITS hdu. More...

static TableDesc	tableDesc (const FITSTabular &fitstabular)
	Get a TableDesc appropriate to hold a FITSTabular the keywords, description, units, displayFormats, and nulls are all used. More...

Detailed Description

Simplified interface to FITS tables with Casacore Look and Feel.

Intended use:

Public interface

Review Status

Date Reviewed:: yyyy/mm/dd

Prerequisite

General knowledge of FITS binary and ASCII tables.

Etymology

Synopsis

FITSTablular is an obstract base class which is used for read-only access to tabular FITS-like data structures.

Example

Motivation

To Do

Eventually we'd like to be able to write the tables as well as read them.

Definition at line 80 of file FITSTable.h.

Constructor & Destructor Documentation

virtual casacore::FITSTabular::~FITSTabular ( )

virtual

Member Function Documentation

virtual const Record& casacore::FITSTabular::currentRow ( ) const

pure virtual

Return the currentRow.

This is guaranteed to be valid so long as only member functions of this base class are called (so you can safely attach RecordFieldPtr objects to it. The result is undefined if pastEnd() is True.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

virtual const RecordDesc& casacore::FITSTabular::description ( ) const

pure virtual

Returns the description of the underlying FITS table.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

static RecordDesc casacore::FITSTabular::descriptionFromHDU ( BinaryTableExtension & hdu )

static

Helper function for retrieving a description from a native-FITS hdu.

virtual const Record& casacore::FITSTabular::displayFormats ( ) const

pure virtual

Returns any TDISPnnn associated with a column (the field names are the column names, each field value is the TDISPnnn value for that field).

Note that only those columns with a non-empty TDISPnnn have an entry in the displayFormats() Record.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

static Record casacore::FITSTabular::displayFormatsFromHDU ( BinaryTableExtension & hdu )

static

Helper function for retrieving the TDISPnnn from a native-FITS hdu.

virtual Bool casacore::FITSTabular::hasChanged ( ) const

inlinevirtual

Has the description changed since construction, default is False.

Reimplemented in casacore::FITSMultiTable, and casacore::FITSTimedTable.

Definition at line 124 of file FITSTable.h.

References casacore::False.

virtual Bool casacore::FITSTabular::isValid ( ) const

pure virtual

isValid() returns False if this object isn't a valid Tabular data structure.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

virtual const TableRecord& casacore::FITSTabular::keywords ( ) const

pure virtual

Returns keywords which are associated with the underlying FITS files.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

static TableRecord casacore::FITSTabular::keywordsFromHDU	(	HeaderDataUnit &	hdu,
		Bool	allKeywords = `False`
	)

static

Helper function for retrieving keywords from a native-FITS hdu.

If allKeywords is not True, some keywords will be excluded from the list. Currently the list of excluded keywords includes TTYPEnnn, TFORMnnn, and TUNITnnn

virtual const String& casacore::FITSTabular::name ( ) const

pure virtual

return the name

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

Referenced by casacore::FITSMultiTable::name(), and casacore::FITSTimedTable::name().

virtual void casacore::FITSTabular::next ( )

pure virtual

Advance the row if possible (guaranteed harmless if pastEnd() is True.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

virtual const Record& casacore::FITSTabular::nulls ( ) const

pure virtual

Returns any TNULLnnn associated with a column (the field names are the column names, each field value is the TNULLnnn value for that field).

Note that only those columns with a specific entry for TNULLnnn and which have not been promoted to doubles due TSCAL and TZERO values will have an entry in the nulls() Record. The meaning of TNULL is only defined for integer and byte columns. When a column is promoted to a double because of scaling, any TNULL values will be assigned a value of NaN.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

static Record casacore::FITSTabular::nullsFromHDU ( BinaryTableExtension & hdu )

static

Helper function for retrieving the TNULLnnn from a native-FITS hdu.

virtual Bool casacore::FITSTabular::pastEnd ( ) const

pure virtual

Returns True if we have advanced past the end of data.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

virtual Bool casacore::FITSTabular::reopen ( const String & )

inlinevirtual

Reopen the table, default behavior is to do nothing, return False.

Reimplemented in casacore::FITSTable, and casacore::SDFITSTable.

Definition at line 118 of file FITSTable.h.

References casacore::False.

virtual void casacore::FITSTabular::resetChangedFlag ( )

inlinevirtual

reset the changed flag, default do nothing

Reimplemented in casacore::FITSMultiTable, and casacore::FITSTimedTable.

Definition at line 126 of file FITSTable.h.

static Record casacore::FITSTabular::subStringShapeFromHDU ( BinaryTableExtension & hdu )

static

Help function for retrieving any shape information from String columns using the SubString convention.

Information is returned in a Record having named fields = all String columns following those convention. Each of these fields is, in turn, a sub-record having these three fields: NCHAR, NELEM, DELIM. If NELEM == -1 then there must have been a DELIM specified and this field is a variable shaped string array where each element has at most NCHAR and they are separated by DELIM (which is a String field here). Otherwise, DELIM is not used and there are NCHAR per element for each of NELEM in each cell for this column.

static TableDesc casacore::FITSTabular::tableDesc ( const FITSTabular & fitstabular )

static

Get a TableDesc appropriate to hold a FITSTabular the keywords, description, units, displayFormats, and nulls are all used.

virtual const Record& casacore::FITSTabular::units ( ) const

pure virtual

Returns any TUNITnnn associated with a column (the field names are the column names, each field value is the TUNITnnn value for that field).

Note that only those columns with a non-empty TUNITnnn have an entry in the units() Record.

Implemented in casacore::FITSTable, casacore::FITSTimedTable, and casacore::FITSMultiTable.

static Record casacore::FITSTabular::unitsFromHDU ( BinaryTableExtension & hdu )

static

Helper function for retrieving the TUNITnnn from a native-FITS hdu.

The documentation for this class was generated from the following file:

fits/FITS/FITSTable.h

Public Member Functions

Static Public Member Functions

Detailed Description

Intended use:

Review Status

Prerequisite

Etymology

Synopsis

Example

Motivation

To Do

Constructor & Destructor Documentation

Member Function Documentation