casa::MSColumns Class Reference
[MeasurementSets]

#include <MSColumns.h>

Inheritance diagram for casa::MSColumns:

Inheritance graph
[legend]
Collaboration diagram for casa::MSColumns:

Collaboration graph
[legend]
List of all members.

Detailed Description

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

Intended use:

Part of API

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

Definition at line 216 of file MSColumns.h.

Public Member Functions

 MSColumns (MeasurementSet &ms)
 Create a columns object that accesses the data in the specified MS.
 ~MSColumns ()
 The destructor does nothing special.
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).
MSAntennaColumnsantenna ()
 Read-write access to required subtables.
MSDataDescColumnsdataDescription ()
MSFeedColumnsfeed ()
MSFieldColumnsfield ()
MSFlagCmdColumnsflagCmd ()
MSHistoryColumnshistory ()
MSObservationColumnsobservation ()
MSPointingColumnspointing ()
MSPolarizationColumnspolarization ()
MSProcessorColumnsprocessor ()
MSSpWindowColumnsspectralWindow ()
MSStateColumnsstate ()
MSDopplerColumnsdoppler ()
 Read-write access to optional subtables.
MSFreqOffsetColumnsfreqOffset ()
MSSourceColumnssource ()
MSSysCalColumnssysCal ()
MSWeatherColumnsweather ()
const ROMSAntennaColumnsantenna () const
 Read-only access to required subtables.
const ROMSDataDescColumnsdataDescription () const
const ROMSFeedColumnsfeed () const
const ROMSFieldColumnsfield () const
const ROMSFlagCmdColumnsflagCmd () const
const ROMSHistoryColumnshistory () const
const ROMSObservationColumnsobservation () const
const ROMSPointingColumnspointing () const
const ROMSPolarizationColumnspolarization () const
const ROMSProcessorColumnsprocessor () const
const ROMSSourceColumnssource () const
const ROMSSpWindowColumnsspectralWindow () const
const ROMSStateColumnsstate () const
const ROMSDopplerColumnsdoppler () const
 Read-only access to optional subtables.
const ROMSFreqOffsetColumnsfreqOffset () const
const ROMSSysCalColumnssysCal () const
const ROMSWeatherColumnsweather () const

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


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.

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

Definition at line 228 of file MSColumns.h.

References dataDesc_p.

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

Definition at line 229 of file MSColumns.h.

References feed_p.

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

Definition at line 230 of file MSColumns.h.

References field_p.

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

Definition at line 231 of file MSColumns.h.

References flagCmd_p.

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

Definition at line 232 of file MSColumns.h.

References history_p.

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

Definition at line 233 of file MSColumns.h.

References observation_p.

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

Definition at line 234 of file MSColumns.h.

References pointing_p.

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

Definition at line 235 of file MSColumns.h.

References polarization_p.

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

Definition at line 236 of file MSColumns.h.

References processor_p.

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

Definition at line 237 of file MSColumns.h.

References spectralWindow_p.

MSStateColumns& casa::MSColumns::state (  )  [inline]

Definition at line 238 of file MSColumns.h.

References state_p.

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

Read-write access to optional subtables.

Definition at line 243 of file MSColumns.h.

References doppler_p.

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

Definition at line 244 of file MSColumns.h.

References freqOffset_p.

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

Definition at line 245 of file MSColumns.h.

References source_p.

MSSysCalColumns& casa::MSColumns::sysCal (  )  [inline]

Definition at line 246 of file MSColumns.h.

References sysCal_p.

MSWeatherColumns& casa::MSColumns::weather (  )  [inline]

Definition at line 247 of file MSColumns.h.

References weather_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.

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

Definition at line 253 of file MSColumns.h.

References dataDesc_p.

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

Definition at line 254 of file MSColumns.h.

References feed_p.

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

Definition at line 255 of file MSColumns.h.

References field_p.

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

Definition at line 256 of file MSColumns.h.

References flagCmd_p.

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

Definition at line 257 of file MSColumns.h.

References history_p.

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

Definition at line 258 of file MSColumns.h.

References observation_p.

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

Definition at line 259 of file MSColumns.h.

References pointing_p.

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

Definition at line 260 of file MSColumns.h.

References polarization_p.

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

Definition at line 262 of file MSColumns.h.

References processor_p.

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

Definition at line 263 of file MSColumns.h.

References source_p.

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

Definition at line 264 of file MSColumns.h.

References spectralWindow_p.

const ROMSStateColumns& casa::MSColumns::state (  )  const [inline]

Definition at line 266 of file MSColumns.h.

References state_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.

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

Definition at line 272 of file MSColumns.h.

References freqOffset_p.

const ROMSSysCalColumns& casa::MSColumns::sysCal (  )  const [inline]

Definition at line 273 of file MSColumns.h.

References sysCal_p.

const ROMSWeatherColumns& casa::MSColumns::weather (  )  const [inline]

Definition at line 274 of file MSColumns.h.

References weather_p.

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.

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

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


Member Data Documentation

MSAntennaColumns casa::MSColumns::antenna_p [private]

Access to subtables.

Definition at line 295 of file MSColumns.h.

Referenced by antenna().

MSDataDescColumns casa::MSColumns::dataDesc_p [private]

Definition at line 296 of file MSColumns.h.

Referenced by dataDescription().

MSDopplerColumns casa::MSColumns::doppler_p [private]

Definition at line 297 of file MSColumns.h.

Referenced by doppler().

MSFeedColumns casa::MSColumns::feed_p [private]

Definition at line 298 of file MSColumns.h.

Referenced by feed().

MSFieldColumns casa::MSColumns::field_p [private]

Definition at line 299 of file MSColumns.h.

Referenced by field().

MSFlagCmdColumns casa::MSColumns::flagCmd_p [private]

Definition at line 300 of file MSColumns.h.

Referenced by flagCmd().

MSFreqOffsetColumns casa::MSColumns::freqOffset_p [private]

Definition at line 301 of file MSColumns.h.

Referenced by freqOffset().

MSHistoryColumns casa::MSColumns::history_p [private]

Definition at line 302 of file MSColumns.h.

Referenced by history().

MSObservationColumns casa::MSColumns::observation_p [private]

Definition at line 303 of file MSColumns.h.

Referenced by observation().

MSPointingColumns casa::MSColumns::pointing_p [private]

Definition at line 304 of file MSColumns.h.

Referenced by pointing().

MSPolarizationColumns casa::MSColumns::polarization_p [private]

Definition at line 305 of file MSColumns.h.

Referenced by polarization().

MSProcessorColumns casa::MSColumns::processor_p [private]

Definition at line 306 of file MSColumns.h.

Referenced by processor().

MSSourceColumns casa::MSColumns::source_p [private]

Definition at line 307 of file MSColumns.h.

Referenced by source().

MSSpWindowColumns casa::MSColumns::spectralWindow_p [private]

Definition at line 308 of file MSColumns.h.

Referenced by spectralWindow().

MSStateColumns casa::MSColumns::state_p [private]

Definition at line 309 of file MSColumns.h.

Referenced by state().

MSSysCalColumns casa::MSColumns::sysCal_p [private]

Definition at line 310 of file MSColumns.h.

Referenced by sysCal().

MSWeatherColumns casa::MSColumns::weather_p [private]

Definition at line 311 of file MSColumns.h.

Referenced by weather().


The documentation for this class was generated from the following file:
Generated on Mon Sep 1 22:46:48 2008 for NRAOCASA by  doxygen 1.5.1