MSField.h

Classes

MSField -- A Table intended to hold a MeasurementSet FIELD table. (full description)

class MSField:public MSFieldEnums, public MSTable<MSFieldEnums::PredefinedColumns, MSFieldEnums::PredefinedKeywords>

Interface

Public Members
MSField ()
MSField (const String &tableName, TableOption = Table::Old)
MSField (const String &tableName, const String &tableDescName, TableOption = Table::Old)
MSField (SetupNewTable &newTab, uInt nrrow = 0, Bool initialize = False)
MSField (const Table &table)
MSField (const MSField &other)
~MSField()
MSField& operator=(const MSField&)
MSField 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

MSField stands for the MeasurementSet Field table.

Synopsis

An MSField is a table intended to hold the FIELD table for the MeasurementSet. It has an identical set of member functions as the main MeasurementSet class, except (currently) for the default calibration members. 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

MSField ()

This constructs an empty MSField.

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

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

Thrown Exceptions

~MSField()

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

MSField& operator=(const MSField&)

Assignment operator, reference semantics

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