MSObservation.h

Go to the documentation of this file.

// # MSObservation.h: The MeasurementSet OBSERVATION Table
// # Copyright (C) 1996,1999,2000
// # Associated Universities, Inc. Washington DC, USA.
// #
// # This library is free software; you can redistribute it and/or modify it
// # under the terms of the GNU Library General Public License as published by
// # the Free Software Foundation; either version 2 of the License, or (at your
// # option) any later version.
// #
// # This library is distributed in the hope that it will be useful, but WITHOUT
// # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
// # License for more details.
// #
// # You should have received a copy of the GNU Library General Public License
// # along with this library; if not, write to the Free Software Foundation,
// # Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
// #
// # Correspondence concerning AIPS++ should be addressed as follows:
// #        Internet email: casa-feedback@nrao.edu.
// #        Postal address: AIPS++ Project Office
// #                        National Radio Astronomy Observatory
// #                        520 Edgemont Road
// #                        Charlottesville, VA 22903-2475 USA
 
#ifndef MS_MSOBSERVATION_H
#define MS_MSOBSERVATION_H
 
#include <casacore/casa/aips.h>
#include <casacore/ms/MeasurementSets/MSTable.h>
#include <casacore/ms/MeasurementSets/MSObsEnums.h>
 
namespace casacore {  // # NAMESPACE CASACORE - BEGIN
 
// <summary>
// A Table intended to hold a MeasurementSet OBSERVATION table.
// </summary>
 
// <use visibility=export>
 
// <reviewed reviewer="Bob Garwood" date="1997/02/01" tests="" demos="">
 
// <prerequisite>
//   <li> <linkto class="MeasurementSet:description">MeasurementSet</linkto>
//   <li> <linkto class="MSTable">MSTable</linkto>
// </prerequisite>
//
// <etymology>
// MSObservation stands for the MeasurementSet Observation table.
// </etymology>
//
// <synopsis>
// An MSObservation is a table intended to hold the OBSERVATION 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.
// </synopsis>
//
// <example>
// See the MeasurementSet for an example of how to access and use this class.
// </example>
//
// <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.
// </motivation>
//
// <todo asof="1999/1/14">
// see MeasurementSet.
// </todo>
 
class MSObservation : public MSObservationEnums, public MSTable<MSObservationEnums> {
 public:
  // This constructs an empty MSObservation
  MSObservation();
 
  // These constructors mirror the Table ones with additional checking
  // on validity (verifying that the MSObservation will have the required columns
  // and keywords)
  // An exception is thrown if the constructed Table is not a valid MSObservation
  // <thrown>
  //   <li> AipsError
  // </thrown>
  // <group name=tableLikeConstructors>
  MSObservation(const String &tableName, TableOption = Table::Old);
  MSObservation(const String &tableName, const String &tableDescName, TableOption = Table::Old);
  MSObservation(SetupNewTable &newTab, rownr_t nrrow = 0, Bool initialize = False);
  MSObservation(const Table &table);
  MSObservation(const MSObservation &other);
  // </group>
 
  // 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>
  //   <li> AipsError
  // </thrown>
  ~MSObservation();
 
  //  Assignment operator, reference semantics
  MSObservation &operator=(const MSObservation &);
 
  // 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)..
  MSObservation referenceCopy(const String &newTableName,
                              const Block<String> &writableColumns) const;
 
  // Initialize the statics appropriately. This does not need to be
  // called by users, it is called by the implementation class
  // MSTableImpl.
  static MSTableMaps initMaps();
 
 private:
  // required by the need to throw an exception in the destructor
  Bool hasBeenDestroyed_p;
};
 
}  // namespace casacore
 
#endif