MSDataDescription.h

Classes

MSDataDescription -- A Table intended to hold a MeasurementSet DATADESCRIPTION table. (full description)

class MSDataDescription:public MSDataDescriptionEnums, public MSTable<MSDataDescriptionEnums::PredefinedColumns, MSDataDescriptionEnums::PredefinedKeywords>

Interface

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

MSDataDescription stands for the MeasurementSet Datadescription table.

Synopsis

An MSDataDescription is a table intended to hold the DATADESCRIPTION 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

MSDataDescription ()

This constructs an empty MSDataDescription

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

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

Thrown Exceptions

~MSDataDescription()

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

MSDataDescription& operator=(const MSDataDescription&)

Assignment operator, reference semantics

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