A class to provide easy read-write access to MeasurementSet columns. More...

#include <MSColumns.h>

Inheritance diagram for casa::MSColumns:

Public Member Functions
	MSColumns (MeasurementSet &ms)
	Create a columns object that accesses the data in the specified MS.
	~MSColumns ()
	The destructor does nothing special.
MSAntennaColumns &	antenna ()
	Read-write access to required subtables.
MSDataDescColumns &	dataDescription ()
MSFeedColumns &	feed ()
MSFieldColumns &	field ()
MSFlagCmdColumns &	flagCmd ()
MSHistoryColumns &	history ()
MSObservationColumns &	observation ()
MSPointingColumns &	pointing ()
MSPolarizationColumns &	polarization ()
MSProcessorColumns &	processor ()
MSSpWindowColumns &	spectralWindow ()
MSStateColumns &	state ()
MSDopplerColumns &	doppler ()
	Read-write access to optional subtables.
MSFreqOffsetColumns &	freqOffset ()
MSSourceColumns &	source ()
MSSysCalColumns &	sysCal ()
MSWeatherColumns &	weather ()
const ROMSAntennaColumns &	antenna () const
	Read-only access to required subtables.
const ROMSDataDescColumns &	dataDescription () const
const ROMSFeedColumns &	feed () const
const ROMSFieldColumns &	field () const
const ROMSFlagCmdColumns &	flagCmd () const
const ROMSHistoryColumns &	history () const
const ROMSObservationColumns &	observation () const
const ROMSPointingColumns &	pointing () const
const ROMSPolarizationColumns &	polarization () const
const ROMSProcessorColumns &	processor () const
const ROMSSourceColumns &	source () const
const ROMSSpWindowColumns &	spectralWindow () const
const ROMSStateColumns &	state () const
const ROMSDopplerColumns &	doppler () const
	Read-only access to optional subtables.
const ROMSFreqOffsetColumns &	freqOffset () const
const ROMSSysCalColumns &	sysCal () const
const ROMSWeatherColumns &	weather () const
void	setEpochRef (MEpoch::Types ref, Bool tableMustBeEmpty=True)
	set the EPOCH reference type in all EPOCH columns in the MS.
void	setDirectionRef (MDirection::Types ref)
	set the DIRECTION reference type for FIELD, POINTING and SOURCE tables (except for antenna frame directions).
Private Attributes
MSAntennaColumns	antenna_p
	Access to subtables.
MSDataDescColumns	dataDesc_p
MSDopplerColumns	doppler_p
MSFeedColumns	feed_p
MSFieldColumns	field_p
MSFlagCmdColumns	flagCmd_p
MSFreqOffsetColumns	freqOffset_p
MSHistoryColumns	history_p
MSObservationColumns	observation_p
MSPointingColumns	pointing_p
MSPolarizationColumns	polarization_p
MSProcessorColumns	processor_p
MSSourceColumns	source_p
MSSpWindowColumns	spectralWindow_p
MSStateColumns	state_p
MSSysCalColumns	sysCal_p
MSWeatherColumns	weather_p

Detailed Description

A class to provide easy read-write access to MeasurementSet columns.

Intended use:

Public interface

Review Status

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

Prerequisite

Etymology

MSColumns stands for MeasurementSet Table columns.

Synopsis

This class provides access to all the subtables and direct access to all the columns in the MeasurementSet. It does the declaration of all the Scalar and ArrayColumns with the correct types, so the application programmer doesn't have to worry about getting those right. There is an access function for every predefined column. Access to non-predefined columns will still have to be done with explicit declarations.

Example

    // use as follows
    MeasurementSet ms("myMS",Table::Update); 
    MSColumns msc(ms);
    // show data from row 5
    cout << msc.data()(5);
    // change name of antenna on row 3 in antenna table
    msc.antenna().name().put(3,"NewAnt-3");

Motivation

Having to type long lists of Scalar and Array column declarations gets very tedious. This class attempts to relieve some of that tedium, while at the same time concentrating all the declarations in one place, making Type errors in the column declaration (only caught at run-time) less probable. Type errors in the use of the columns is caught at compile time.

To Do

We might decide to merge this class with the MeasurementSet

Definition at line 216 of file MSColumns.h.

Constructor & Destructor Documentation

casa::MSColumns::MSColumns ( MeasurementSet & ms )

Create a columns object that accesses the data in the specified MS.

casa::MSColumns::~MSColumns ( )

The destructor does nothing special.

Member Function Documentation

MSAntennaColumns& casa::MSColumns::antenna ( ) [inline]

Read-write access to required subtables.

Definition at line 227 of file MSColumns.h.

References antenna_p.

const ROMSAntennaColumns& casa::MSColumns::antenna ( ) const [inline]

Read-only access to required subtables.

Definition at line 252 of file MSColumns.h.

References antenna_p.

MSDataDescColumns& casa::MSColumns::dataDescription ( ) [inline]

Definition at line 228 of file MSColumns.h.

References dataDesc_p.

const ROMSDataDescColumns& casa::MSColumns::dataDescription ( ) const [inline]

Definition at line 253 of file MSColumns.h.

References dataDesc_p.

MSDopplerColumns& casa::MSColumns::doppler ( ) [inline]

Read-write access to optional subtables.

Definition at line 243 of file MSColumns.h.

References doppler_p.

const ROMSDopplerColumns& casa::MSColumns::doppler ( ) const [inline]

Read-only access to optional subtables.

Definition at line 271 of file MSColumns.h.

References doppler_p.

MSFeedColumns& casa::MSColumns::feed ( ) [inline]

Definition at line 229 of file MSColumns.h.

References feed_p.

const ROMSFeedColumns& casa::MSColumns::feed ( ) const [inline]

Definition at line 254 of file MSColumns.h.

References feed_p.

MSFieldColumns& casa::MSColumns::field ( ) [inline]

Definition at line 230 of file MSColumns.h.

References field_p.

const ROMSFieldColumns& casa::MSColumns::field ( ) const [inline]

Definition at line 255 of file MSColumns.h.

References field_p.

MSFlagCmdColumns& casa::MSColumns::flagCmd ( ) [inline]

Definition at line 231 of file MSColumns.h.

References flagCmd_p.

const ROMSFlagCmdColumns& casa::MSColumns::flagCmd ( ) const [inline]

Definition at line 256 of file MSColumns.h.

References flagCmd_p.

MSFreqOffsetColumns& casa::MSColumns::freqOffset ( ) [inline]

Definition at line 244 of file MSColumns.h.

References freqOffset_p.

const ROMSFreqOffsetColumns& casa::MSColumns::freqOffset ( ) const [inline]

Definition at line 272 of file MSColumns.h.

References freqOffset_p.

MSHistoryColumns& casa::MSColumns::history ( ) [inline]

Definition at line 232 of file MSColumns.h.

References history_p.

const ROMSHistoryColumns& casa::MSColumns::history ( ) const [inline]

Definition at line 257 of file MSColumns.h.

References history_p.

MSObservationColumns& casa::MSColumns::observation ( ) [inline]

Definition at line 233 of file MSColumns.h.

References observation_p.

const ROMSObservationColumns& casa::MSColumns::observation ( ) const [inline]

Definition at line 258 of file MSColumns.h.

References observation_p.

MSPointingColumns& casa::MSColumns::pointing ( ) [inline]

Definition at line 234 of file MSColumns.h.

References pointing_p.

const ROMSPointingColumns& casa::MSColumns::pointing ( ) const [inline]

Definition at line 259 of file MSColumns.h.

References pointing_p.

MSPolarizationColumns& casa::MSColumns::polarization ( ) [inline]

Definition at line 235 of file MSColumns.h.

References polarization_p.

const ROMSPolarizationColumns& casa::MSColumns::polarization ( ) const [inline]

Definition at line 260 of file MSColumns.h.

References polarization_p.

MSProcessorColumns& casa::MSColumns::processor ( ) [inline]

Definition at line 236 of file MSColumns.h.

References processor_p.

const ROMSProcessorColumns& casa::MSColumns::processor ( ) const [inline]

Definition at line 262 of file MSColumns.h.

References processor_p.

void casa::MSColumns::setDirectionRef ( MDirection::Types ref )

set the DIRECTION reference type for FIELD, POINTING and SOURCE tables (except for antenna frame directions).

void casa::MSColumns::setEpochRef	(	MEpoch::Types	ref,
		Bool	tableMustBeEmpty = `True`
	)

set the EPOCH reference type in all EPOCH columns in the MS.

Note that only a single EPOCH reference is allowed in the MS. This
Tip: In principle this function can only be used if the table is empty, otherwise already written values may thereafter have an incorrect reference, offset, or unit; However, it is possible that part of the table gets written before these values are known; In that case the reference, offset, or units can be set by using a False tableMustBeEmpty argument;

Reimplemented from casa::MSMainColumns.

MSSourceColumns& casa::MSColumns::source ( ) [inline]

Definition at line 245 of file MSColumns.h.

References source_p.

const ROMSSourceColumns& casa::MSColumns::source ( ) const [inline]

Definition at line 263 of file MSColumns.h.

References source_p.

MSSpWindowColumns& casa::MSColumns::spectralWindow ( ) [inline]

Definition at line 237 of file MSColumns.h.

References spectralWindow_p.

const ROMSSpWindowColumns& casa::MSColumns::spectralWindow ( ) const [inline]

Definition at line 264 of file MSColumns.h.