MSSource.h

Classes

MSSource -- A Table intended to hold a MeasurementSet SOURCE table. (full description)

class MSSource:public MSSourceEnums, public MSTable<MSSourceEnums::PredefinedColumns, MSSourceEnums::PredefinedKeywords>

Interface

Public Members
MSSource ()
MSSource (const String &tableName, TableOption = Table::Old)
MSSource (const String &tableName, const String &tableDescName, TableOption = Table::Old)
MSSource (SetupNewTable &newTab, uInt nrrow = 0, Bool initialize = False)
MSSource (const Table &table)
MSSource (const MSSource &other)
~MSSource()
MSSource& operator=(const MSSource&)
MSSource referenceCopy(const String& newTableName, const Block<String>& writableColumns) const
static void init()

Description

Review Status

Reviewed By:
Bob Garwood
Date Reviewed:
1997/02/01

Prerequisite

Etymology

MSSource stands for the MeasurementSet Source table.

Synopsis

An MSSource is a table intended to hold the SOURCE table for the MeasurementSet. It has an identical set of member functions as the main MeasurementSet class. For further info and examples see the MeasurementSet class.

Example

See the MeasurementSet for an example of how to access and use this class.

Motivation

It was found that subtables and the main table of the MeasurementSet have a lot in common, therefore they derive their interface from the same base class. Each subtable has its own class to keep the enum definitions and conversion functions in separate scopes.

To Do

Member Description

MSSource ()

This constructs an empty MSSource.

MSSource (const String &tableName, TableOption = Table::Old)
MSSource (const String &tableName, const String &tableDescName, TableOption = Table::Old)
MSSource (SetupNewTable &newTab, uInt nrrow = 0, Bool initialize = False)
MSSource (const Table &table)
MSSource (const MSSource &other)

These constructors mirror the Table ones with additional checking on validity (verifying that the MSSource will have the required columns and keywords) An exception is thrown if the constructed Table is not a valid MSSource

Thrown Exceptions

~MSSource()

As with tables, the destructor writes the table if necessary. Additional checking is done here to verify that all required columns are still present. If it is NOT valid, it will write the table and then throw an exception.

Thrown Exceptions

MSSource& operator=(const MSSource&)

Assignment operator, reference semantics

MSSource referenceCopy(const String& newTableName, const Block<String>& writableColumns) const

Make a special copy of this Table which references all columns from this Table except those mentioned; those are empty and writable. Each forwarded column has the same writable status as the underlying column. The mentioned columns all use the AipsIO storage manager. This function is inherited from MSTable and unlikely to be of use, except in the class MeasurementSet (see comment there)..

static void init()

Initialize the statics appropriately. This does not need to be called by users, it is called by the implementation class MSTableImpl.