casa::MSMetaData Class Reference

Abstract base class to hold metadata pertaining to a measurement set. More...

#include <MSMetaData.h>

Inheritance diagram for casa::MSMetaData:

List of all members.

Classes
struct	SpwProperties
Public Types
enum	CorrelationType {   AUTO,   CROSS,   BOTH }
	for retrieving stats More...
Public Member Functions
virtual	~MSMetaData ()
virtual uInt	nStates ()=0
	construct an object which loads metadata from the specified MS.
virtual std::set< Int >	getScanNumbers ()=0
	get unique scan numbers
virtual std::set< Int >	getScansForState (const Int stateID)=0
virtual std::set< String >	getIntentsForScan (const Int scan)=0
virtual std::set< String >	getIntents ()=0
	get all intents, in no particular (nor guaranteed) order.
virtual std::set< uInt >	getSpwsForIntent (const String &intent)=0
	get a set of spectral windows for which the specified intent applies.
virtual uInt	nSpw (Bool includewvr)=0
	get number of spectral windows
virtual uInt	nRows ()=0
	get the number of rows
virtual uInt	nRows (CorrelationType cType)=0
virtual uInt	nRows (CorrelationType cType, Int arrayID, Int observationID, Int scanNumber, Int fieldID)=0
virtual uInt	nRows (CorrelationType cType, Int fieldID)=0
virtual std::set< String >	getIntentsForSpw (const uInt spw)=0
	get a set of intents corresponding to the specified spectral window
virtual std::set< String >	getIntentsForField (Int fieldID)=0
	get a set of intents corresponding to a specified field
virtual uInt	nFields ()=0
	get the number of fields.
virtual std::set< uInt >	getSpwsForField (const Int fieldID)=0
	get a set of spectral windows corresponding to the specified fieldID
virtual std::set< uInt >	getSpwsForField (const String &fieldName)=0
	get a set of spectral windows corresponding to the specified field name
virtual std::set< Int >	getFieldIDsForSpw (const uInt spw)=0
	get the set of field IDs corresponding to the specified spectral window.
virtual std::set< String >	getFieldNamesForSpw (const uInt spw)=0
	get the set of field names corresponding to the specified spectral window.
virtual uInt	nScans ()=0
	get the number of scans in the dataset
virtual uInt	nObservations ()=0
	get the number of observations (from the OBSERVATIONS table) in the dataset
virtual uInt	nArrays ()=0
	get the number of arrays (from the ARRAY table) in the dataset
virtual std::set< uInt >	getSpwsForScan (const Int scan)=0
	get the set of spectral windows for the specified scan number.
virtual std::set< Int >	getScansForSpw (const uInt spw)=0
	get the set of scan numbers for the specified spectral window.
virtual uInt	nAntennas ()=0
	get the number of antennas in the ANTENNA table
virtual vector< String >	getAntennaNames (std::map< String, uInt > &namesToIDsMap, const vector< uInt > &antennaIDs=vector< uInt >(0))=0
	get the name of the antenna for the specified antenna ID
virtual vector< uInt >	getAntennaIDs (const vector< String > &antennaName)=0
	get the antenna ID for the antenna with the specified name.
virtual std::set< uInt >	getTDMSpw ()=0
	get set of spectral windows used for TDM.
virtual std::set< uInt >	getFDMSpw ()=0
	get set of spectral windows used for FDM.
virtual std::set< uInt >	getChannelAvgSpw ()=0
	get spectral windows that have been averaged.
virtual std::set< uInt >	getWVRSpw ()=0
	Get the spectral window set used for WVR measurements.
virtual std::set< Int >	getScansForTimes (const Double center, const Double tol)=0
	Get the scans which fail into the specified time range (center-tol to center+tol)
virtual std::set< Double >	getTimesForScans (const std::set< Int > &scans)=0
	Get the times for the specified scans.
std::set< Double >	getTimesForScan (const Int scan)
	get the times for the specified scan.
virtual std::vector< Double >	getTimeRangeForScan (Int scan)=0
	get the time range for the specified scan.
virtual std::set< Int >	getStatesForScan (const Int scan)=0
	get the stateIDs associated with the specified scan number.
virtual std::set< Int >	getScansForIntent (const String &intent)=0
	get the scans associated with the specified intent
virtual std::set< Int >	getScansForFieldID (const Int fieldID)=0
	get the scan numbers associated with the specified field ID.
virtual std::set< Int >	getFieldIDsForField (const String &field)=0
	get the field IDs for the specified field name.
std::set< Int >	getScansForField (const String &field)
	get the scan numbers associated with the specified field.
virtual std::set< Int >	getFieldsForScan (const Int scan)=0
	get field IDs associated with the specified scan number.
virtual std::set< Int >	getFieldsForScans (const std::set< Int > &scans)=0
	get the field IDs associated with the specified scans
virtual std::set< Int >	getFieldsForIntent (const String &intent)=0
	get the field IDs associated with the specified intent.
virtual vector< String >	getFieldNamesForFieldIDs (const vector< Int > &fieldIDs)=0
	get the field names associated with the specified field IDs.
virtual std::set< Int >	getFieldsForTimes (Double center, Double tol)=0
	Get the fields which fail into the specified time range (center-tol to center+tol)
virtual std::set< Double >	getTimesForField (Int fieldID)=0
	get the times for which the specified field was observed
virtual vector< String >	getObservatoryNames ()=0
	get telescope names in the order they are listed in the OBSERVATION table.
virtual MPosition	getObservatoryPosition (uInt which)=0
	get the position of the specified telescope (observatory).
virtual vector< MPosition >	getAntennaPositions (const vector< uInt > &which=vector< uInt >(0))=0
	get the position of the specified antennas.
virtual vector< MPosition >	getAntennaPositions (const vector< String > &names)=0
	names cannot be empty.
virtual Quantum< Vector< Double > >	getAntennaOffset (uInt which)=0
	get the position of the specified antenna relative to the observatory position.
virtual Quantum< Vector< Double > >	getAntennaOffset (const String &name)=0
virtual vector< Quantum < Vector< Double > > >	getAntennaOffsets (const vector< MPosition > &positions)=0
virtual Matrix< Bool >	getUniqueBaselines ()=0
	get a map relating time stamps to exposure times.
virtual uInt	nBaselines ()
	get the number of unique baselines represented in the main MS table which in theory can be less than n*(n-1)/2
virtual Quantity	getEffectiveTotalExposureTime ()=0
	get the effective total exposure time.
virtual Double	nUnflaggedRows ()=0
	get the number of unflagged rows
virtual Double	nUnflaggedRows (CorrelationType cType)=0
virtual Double	nUnflaggedRows (CorrelationType cType, Int arrayID, Int observationID, Int scanNumber, Int fieldID)=0
virtual Double	nUnflaggedRows (CorrelationType cType, Int fieldID)=0
virtual Float	getCache () const
virtual vector< Double >	getBandWidths ()=0
virtual vector< Quantum < Vector< Double > > >	getChanFreqs ()=0
virtual vector< vector< Double > >	getChanWidths ()=0
virtual vector< Int >	getNetSidebands ()=0
virtual vector< Quantity >	getMeanFreqs ()=0
virtual vector< uInt >	nChans ()=0
virtual vector< vector< Double > >	getEdgeChans ()=0
virtual vector< uInt >	getBBCNos ()=0
virtual vector< String >	getSpwNames ()=0
virtual std::map< uInt, Double >	getAverageIntervalsForScan (Int scan)=0
	the returned map are the average intervals for each spectral window for the specified scan
Static Public Member Functions
static Bool	hasBBCNo (const MeasurementSet &ms)
Protected Types
typedef std::map< Int, std::map< Int, std::map< Int, std::map< Int, uInt > > > >	AOSFMapI
	(array_id, observation_id, scan_number, field_id) -> stuff mappings
typedef std::map< Int, std::map< Int, std::map< Int, std::map< Int, Double > > > >	AOSFMapD
Protected Member Functions
Matrix< Bool >	_getUniqueBaselines (const Vector< Int > &antanna1, const Vector< Int > &antenna2)
Quantity	_getTotalExposureTime (const MeasurementSet &ms, const std::map< Double, Double > &timeToBWMap, const vector< SpwProperties > &spwProperties, const std::map< Int, uInt > &dataDescToSpwIdMap)
void	_getRowStats (uInt &nACRows, uInt &nXCRows, AOSFMapI *&scanToNACRowsMap, AOSFMapI *&scanToNXCRowsMap, std::map< Int, uInt > *&fieldToNACRowsMap, std::map< Int, uInt > *&fieldToNXCRowsMap, const Vector< Int > &ant1, const Vector< Int > &ant2, const Vector< Int > &scans, const Vector< Int > &fieldIDs, const Vector< Int > &obsIDs, const Vector< Int > &arIDs)
void	_getUnflaggedRowStats (Double &nACRows, Double &nXCRows, std::map< Int, Double > *&fieldNACRows, std::map< Int, Double > *&fieldNXCRows, AOSFMapD *&scanNACRows, AOSFMapD *&scanNXCRows, const Vector< Int > &ant1, const Vector< Int > &ant2, const Vector< Bool > &flagRow, const Vector< Int > &dataDescIDs, const std::map< Int, uInt > &dataDescIDToSpwMap, const vector< SpwProperties > &spwInfo, const ArrayColumn< Bool > &flags, const Vector< Int > &fieldIDs, const Vector< Int > &scan, const Vector< Int > &obsIDs, const Vector< Int > &arIDs)
Static Protected Member Functions
static uInt	_getNStates (const MeasurementSet &ms)
static void	_getStateToIntentsMap (vector< std::set< String > > &statesToIntentsMap, std::set< String > &uniqueIntents, const MeasurementSet &ms)
static Vector< Int >	_getScans (const MeasurementSet &ms)
static std::map< Int, std::set < Int > >	_getScanToStatesMap (const Vector< Int > &scans, const Vector< Int > &states)
	state IDs can be < 0
static vector< SpwProperties >	_getSpwInfo (std::set< uInt > &avgSpw, std::set< uInt > &tdmSpw, std::set< uInt > &fdmSpw, std::set< uInt > &wvrSpw, const MeasurementSet &ms)
static Vector< Int >	_getDataDescIDs (const MeasurementSet &ms)
static Vector< Int >	_getStates (const MeasurementSet &ms)
static Vector< Int >	_getObservationIDs (const MeasurementSet &ms)
static Vector< Int >	_getArrayIDs (const MeasurementSet &ms)
static std::map< Int, uInt >	_getDataDescIDToSpwMap (const MeasurementSet &ms)
static Vector< Int >	_getFieldIDs (const MeasurementSet &ms)
static vector< String >	_getFieldNames (const MeasurementSet &ms)
static void	_checkTolerance (const Double tol)
static Vector< Double >	_getTimes (const MeasurementSet &ms)
static Vector< Double >	_getTimeCentroids (const MeasurementSet &ms)
static Vector< Double >	_getIntervals (const MeasurementSet &ms)
static Vector< Bool >	_getFlagRows (const MeasurementSet &ms)
static ArrayColumn< Bool > *	_getFlags (const MeasurementSet &ms)
static std::map< Int, std::set < Double > >	_getScanToTimesMap (const Vector< Int > &scans, const Vector< Double > &times)
static vector< MPosition >	_getObservatoryPositions (vector< String > &names, const MeasurementSet &ms)
static vector< String >	_getAntennaNames (std::map< String, uInt > &namesToIDs, const MeasurementSet &ms)
static vector< MPosition >	_getAntennaPositions (vector< String > &antennaNames, const MeasurementSet &ms)
	get all antenna positions.
static vector< MPosition >	_getAntennaPositions (const MeasurementSet &ms)
static vector< Quantum< Vector < Double > > >	_getAntennaOffsets (const vector< MPosition > &antennaPositions, const MPosition &observatoryPosition)
static std::map< Int, uInt >	_toUIntMap (const Vector< Int > &v)
static std::map< Double, Double >	_getTimeToAggregateExposureMap (const vector< Double > &times, const vector< Double > &exposures)
static std::map< Double, Double >	_getTimeToTotalBWMap (const Vector< Double > &times, const Vector< Int > &ddIDs, const std::map< Int, uInt > &dataDescIDToSpwMap, const vector< MSMetaData::SpwProperties > &spwInfo)
static void	_getAntennas (Vector< Int > &ant1, Vector< Int > &ant2, const MeasurementSet &ms)
static std::map< Int, vector < Double > >	_getScanToTimeRangeMap (std::map< Int, std::map< uInt, Double > > &scanSpwToAverageIntervalMap, const Vector< Int > &scans, const Vector< Double > &timeCentroids, const Vector< Double > &intervals, const Vector< Int > &dataDescIDs, const std::map< Int, uInt > &dataDesIDToSpwMap, const std::set< Int > &uniqueScans)
Private Member Functions
void	_setNumberOfPolarizations (const MeasurementSet &ms)
	This comment from thunter in the original ValueMapping python class Determine the number of polarizations for the first OBSERVE_TARGET intent.
void	_setObservation (const MeasurementSet &ms)
	set metadata from OBSERVATION table

---

Detailed Description

Abstract base class to hold metadata pertaining to a measurement set.

Definition at line 54 of file MSMetaData.h.

---

Member Typedef Documentation

typedef std::map<Int, std::map<Int, std::map<Int, std::map<Int, Double> > > > casa::MSMetaData::AOSFMapD [protected]

Definition at line 309 of file MSMetaData.h.

typedef std::map<Int, std::map<Int, std::map<Int, std::map<Int, uInt> > > > casa::MSMetaData::AOSFMapI [protected]

(array_id, observation_id, scan_number, field_id) -> stuff mappings

Definition at line 308 of file MSMetaData.h.

---

Member Enumeration Documentation

enum casa::MSMetaData::CorrelationType

for retrieving stats

Enumerator:

AUTO
CROSS
BOTH

Definition at line 58 of file MSMetaData.h.

---

Constructor & Destructor Documentation

virtual casa::MSMetaData::~MSMetaData

(

)

[virtual]

---

Member Function Documentation

static void casa::MSMetaData::_checkTolerance

(

const Double

tol

)

[static, protected]

static vector<String> casa::MSMetaData::_getAntennaNames	(	std::map< String, uInt > &	namesToIDs,
		const MeasurementSet &	ms
	)		[static, protected]

static vector<Quantum<Vector<Double> > > casa::MSMetaData::_getAntennaOffsets	(	const vector< MPosition > &	antennaPositions,
		const MPosition &	observatoryPosition
	)		[static, protected]

static vector<MPosition> casa::MSMetaData::_getAntennaPositions	(	vector< String > &	antennaNames,
		const MeasurementSet &	ms
	)		[static, protected]

get all antenna positions.

A vector of antenna names is also returned.

static vector<MPosition> casa::MSMetaData::_getAntennaPositions

(

const MeasurementSet &

ms

)

[static, protected]

static void casa::MSMetaData::_getAntennas	(	Vector< Int > &	ant1,
		Vector< Int > &	ant2,
		const MeasurementSet &	ms
	)		[static, protected]

static Vector<Int> casa::MSMetaData::_getArrayIDs

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Int> casa::MSMetaData::_getDataDescIDs

(

const MeasurementSet &

ms

)

[static, protected]

static std::map<Int, uInt> casa::MSMetaData::_getDataDescIDToSpwMap

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Int> casa::MSMetaData::_getFieldIDs

(

const MeasurementSet &

ms

)

[static, protected]

static vector<String> casa::MSMetaData::_getFieldNames

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Bool> casa::MSMetaData::_getFlagRows

(

const MeasurementSet &

ms

)

[static, protected]

static ArrayColumn<Bool>* casa::MSMetaData::_getFlags

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Double> casa::MSMetaData::_getIntervals

(

const MeasurementSet &

ms

)

[static, protected]

static uInt casa::MSMetaData::_getNStates

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Int> casa::MSMetaData::_getObservationIDs

(

const MeasurementSet &

ms

)

[static, protected]

static vector<MPosition> casa::MSMetaData::_getObservatoryPositions	(	vector< String > &	names,
		const MeasurementSet &	ms
	)		[static, protected]

void casa::MSMetaData::_getRowStats	(	uInt &	nACRows,
		uInt &	nXCRows,
		AOSFMapI *&	scanToNACRowsMap,
		AOSFMapI *&	scanToNXCRowsMap,
		std::map< Int, uInt > *&	fieldToNACRowsMap,
		std::map< Int, uInt > *&	fieldToNXCRowsMap,
		const Vector< Int > &	ant1,
		const Vector< Int > &	ant2,
		const Vector< Int > &	scans,
		const Vector< Int > &	fieldIDs,
		const Vector< Int > &	obsIDs,
		const Vector< Int > &	arIDs
	)		[protected]

static Vector<Int> casa::MSMetaData::_getScans

(

const MeasurementSet &

ms

)

[static, protected]

static std::map<Int, std::set<Int> > casa::MSMetaData::_getScanToStatesMap	(	const Vector< Int > &	scans,
		const Vector< Int > &	states
	)		[static, protected]

state IDs can be < 0

static std::map<Int, vector<Double> > casa::MSMetaData::_getScanToTimeRangeMap	(	std::map< Int, std::map< uInt, Double > > &	scanSpwToAverageIntervalMap,
		const Vector< Int > &	scans,
		const Vector< Double > &	timeCentroids,
		const Vector< Double > &	intervals,
		const Vector< Int > &	dataDescIDs,
		const std::map< Int, uInt > &	dataDesIDToSpwMap,
		const std::set< Int > &	uniqueScans
	)		[static, protected]

static std::map<Int, std::set<Double> > casa::MSMetaData::_getScanToTimesMap	(	const Vector< Int > &	scans,
		const Vector< Double > &	times
	)		[static, protected]

static vector<SpwProperties> casa::MSMetaData::_getSpwInfo	(	std::set< uInt > &	avgSpw,
		std::set< uInt > &	tdmSpw,
		std::set< uInt > &	fdmSpw,
		std::set< uInt > &	wvrSpw,
		const MeasurementSet &	ms
	)		[static, protected]

static Vector<Int> casa::MSMetaData::_getStates

(

const MeasurementSet &

ms

)

[static, protected]

static void casa::MSMetaData::_getStateToIntentsMap	(	vector< std::set< String > > &	statesToIntentsMap,
		std::set< String > &	uniqueIntents,
		const MeasurementSet &	ms
	)		[static, protected]

static Vector<Double> casa::MSMetaData::_getTimeCentroids

(

const MeasurementSet &

ms

)

[static, protected]

static Vector<Double> casa::MSMetaData::_getTimes

(

const MeasurementSet &

ms

)

[static, protected]

static std::map<Double, Double> casa::MSMetaData::_getTimeToAggregateExposureMap	(	const vector< Double > &	times,
		const vector< Double > &	exposures
	)		[static, protected]

static std::map<Double, Double> casa::MSMetaData::_getTimeToTotalBWMap	(	const Vector< Double > &	times,
		const Vector< Int > &	ddIDs,
		const std::map< Int, uInt > &	dataDescIDToSpwMap,
		const vector< MSMetaData::SpwProperties > &	spwInfo
	)		[static, protected]

Quantity casa::MSMetaData::_getTotalExposureTime	(	const MeasurementSet &	ms,
		const std::map< Double, Double > &	timeToBWMap,
		const vector< SpwProperties > &	spwProperties,
		const std::map< Int, uInt > &	dataDescToSpwIdMap
	)		[protected]

void casa::MSMetaData::_getUnflaggedRowStats	(	Double &	nACRows,
		Double &	nXCRows,
		std::map< Int, Double > *&	fieldNACRows,
		std::map< Int, Double > *&	fieldNXCRows,
		AOSFMapD *&	scanNACRows,
		AOSFMapD *&	scanNXCRows,
		const Vector< Int > &	ant1,
		const Vector< Int > &	ant2,
		const Vector< Bool > &	flagRow,
		const Vector< Int > &	dataDescIDs,
		const std::map< Int, uInt > &	dataDescIDToSpwMap,
		const vector< SpwProperties > &	spwInfo,
		const ArrayColumn< Bool > &	flags,
		const Vector< Int > &	fieldIDs,
		const Vector< Int > &	scan,
		const Vector< Int > &	obsIDs,
		const Vector< Int > &	arIDs
	)		[protected]

Matrix<Bool> casa::MSMetaData::_getUniqueBaselines	(	const Vector< Int > &	antanna1,
		const Vector< Int > &	antenna2
	)		[protected]

void casa::MSMetaData::_setNumberOfPolarizations

(

const MeasurementSet &

ms

)

[private]

This comment from thunter in the original ValueMapping python class

Determine the number of polarizations for the first OBSERVE_TARGET intent.

Used by plotbandpass for BPOLY plots since the number of pols cannot be inferred

correctly from the caltable alone. You cannot not simply use the first row, because

it may be a pointing scan which may have different number of polarizations than what

the TARGET and BANDPASS calibrator will have.

-- T. Hunter

void casa::MSMetaData::_setObservation

(

const MeasurementSet &

ms

)

[private]

set metadata from OBSERVATION table

Reimplemented in casa::MSMetaDataOnDemand.

static std::map<Int, uInt> casa::MSMetaData::_toUIntMap

(

const Vector< Int > &

v

)

[static, protected]

virtual vector<uInt> casa::MSMetaData::getAntennaIDs

(

const vector< String > &

antennaName

)

[pure virtual]

get the antenna ID for the antenna with the specified name.

Implemented in casa::MSMetaDataOnDemand.

virtual vector<String> casa::MSMetaData::getAntennaNames	(	std::map< String, uInt > &	namesToIDsMap,
		const vector< uInt > &	antennaIDs = vector< uInt >(0)
	)		[pure virtual]

get the name of the antenna for the specified antenna ID

Implemented in casa::MSMetaDataOnDemand.

virtual Quantum<Vector<Double> > casa::MSMetaData::getAntennaOffset

(

uInt

which

)

[pure virtual]

get the position of the specified antenna relative to the observatory position.

the three vector returned represents the longitudinal, latitudinal, and elevation offsets (elements 0, 1, and 2 respectively). The longitude and latitude offsets are measured along the surface of a sphere centered at the earth's center and whose surface intersects the position of the observatory.

Implemented in casa::MSMetaDataOnDemand.

virtual Quantum<Vector<Double> > casa::MSMetaData::getAntennaOffset

(

const String &

name

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<Quantum<Vector<Double> > > casa::MSMetaData::getAntennaOffsets

(

const vector< MPosition > &

positions

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<MPosition> casa::MSMetaData::getAntennaPositions

(

const vector< uInt > &

which = vector< uInt >(0)

)

[pure virtual]

get the position of the specified antennas.

If which is empty, all antenna positions will be returned.

Implemented in casa::MSMetaDataOnDemand.

virtual vector<MPosition> casa::MSMetaData::getAntennaPositions

(

const vector< String > &

names

)

[pure virtual]

names cannot be empty.

Implemented in casa::MSMetaDataOnDemand.

virtual std::map<uInt, Double> casa::MSMetaData::getAverageIntervalsForScan

(

Int

scan

)

[pure virtual]

the returned map are the average intervals for each spectral window for the specified scan

Implemented in casa::MSMetaDataOnDemand.

virtual vector<Double> casa::MSMetaData::getBandWidths

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<uInt> casa::MSMetaData::getBBCNos

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual Float casa::MSMetaData::getCache

(

)

const [inline, virtual]

Reimplemented in casa::MSMetaDataOnDemand.

Definition at line 279 of file MSMetaData.h.

virtual vector<Quantum<Vector<Double> > > casa::MSMetaData::getChanFreqs

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getChannelAvgSpw

(

)

[pure virtual]

get spectral windows that have been averaged.

These are windows with 1 channel.

Implemented in casa::MSMetaDataOnDemand.

virtual vector<vector<Double> > casa::MSMetaData::getChanWidths

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<vector<Double> > casa::MSMetaData::getEdgeChans

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual Quantity casa::MSMetaData::getEffectiveTotalExposureTime

(

)

[pure virtual]

get the effective total exposure time.

This is the effective time spent collecting unflagged data.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getFDMSpw

(

)

[pure virtual]

get set of spectral windows used for FDM.

These are windows that do not have 1, 4, 64, 128, or 256 channels.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldIDsForField

(

const String &

field

)

[pure virtual]

get the field IDs for the specified field name.

Case insensitive.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldIDsForSpw

(

const uInt

spw

)

[pure virtual]

get the set of field IDs corresponding to the specified spectral window.

Implemented in casa::MSMetaDataOnDemand.

virtual vector<String> casa::MSMetaData::getFieldNamesForFieldIDs

(

const vector< Int > &

fieldIDs

)

[pure virtual]

get the field names associated with the specified field IDs.

If fieldIDs is empty, a list of all field names will be returned.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<String> casa::MSMetaData::getFieldNamesForSpw

(

const uInt

spw

)

[pure virtual]

get the set of field names corresponding to the specified spectral window.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldsForIntent

(

const String &

intent

)

[pure virtual]

get the field IDs associated with the specified intent.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldsForScan

(

const Int

scan

)

[pure virtual]

get field IDs associated with the specified scan number.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldsForScans

(

const std::set< Int > &

scans

)

[pure virtual]

get the field IDs associated with the specified scans

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getFieldsForTimes	(	Double	center,
		Double	tol
	)		[pure virtual]

Get the fields which fail into the specified time range (center-tol to center+tol)

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<String> casa::MSMetaData::getIntents

(

)

[pure virtual]

get all intents, in no particular (nor guaranteed) order.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<String> casa::MSMetaData::getIntentsForField

(

Int

fieldID

)

[pure virtual]

get a set of intents corresponding to a specified field

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<String> casa::MSMetaData::getIntentsForScan

(

const Int

scan

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<String> casa::MSMetaData::getIntentsForSpw

(

const uInt

spw

)

[pure virtual]

get a set of intents corresponding to the specified spectral window

Implemented in casa::MSMetaDataOnDemand.

virtual vector<Quantity> casa::MSMetaData::getMeanFreqs

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<Int> casa::MSMetaData::getNetSidebands

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual vector<String> casa::MSMetaData::getObservatoryNames

(

)

[pure virtual]

get telescope names in the order they are listed in the OBSERVATION table.

These are the telescopes (observatories), not the antenna names.

Implemented in casa::MSMetaDataOnDemand.

virtual MPosition casa::MSMetaData::getObservatoryPosition

(

uInt

which

)

[pure virtual]

get the position of the specified telescope (observatory).

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getScanNumbers

(

)

[pure virtual]

get unique scan numbers

Implemented in casa::MSMetaDataOnDemand.

std::set<Int> casa::MSMetaData::getScansForField

(

const String &

field

)

get the scan numbers associated with the specified field.

Subclasses should not implement or override.

virtual std::set<Int> casa::MSMetaData::getScansForFieldID

(

const Int

fieldID

)

[pure virtual]

get the scan numbers associated with the specified field ID.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getScansForIntent

(

const String &

intent

)

[pure virtual]

get the scans associated with the specified intent

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getScansForSpw

(

const uInt

spw

)

[pure virtual]

get the set of scan numbers for the specified spectral window.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getScansForState

(

const Int

stateID

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getScansForTimes	(	const Double	center,
		const Double	tol
	)		[pure virtual]

Get the scans which fail into the specified time range (center-tol to center+tol)

Implemented in casa::MSMetaDataOnDemand.

virtual vector<String> casa::MSMetaData::getSpwNames

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getSpwsForField

(

const Int

fieldID

)

[pure virtual]

get a set of spectral windows corresponding to the specified fieldID

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getSpwsForField

(

const String &

fieldName

)

[pure virtual]

get a set of spectral windows corresponding to the specified field name

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getSpwsForIntent

(

const String &

intent

)

[pure virtual]

get a set of spectral windows for which the specified intent applies.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getSpwsForScan

(

const Int

scan

)

[pure virtual]

get the set of spectral windows for the specified scan number.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Int> casa::MSMetaData::getStatesForScan

(

const Int

scan

)

[pure virtual]

get the stateIDs associated with the specified scan number.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getTDMSpw

(

)

[pure virtual]

get set of spectral windows used for TDM.

These are windows that have 64, 128, or 256 channels

Implemented in casa::MSMetaDataOnDemand.

virtual std::vector<Double> casa::MSMetaData::getTimeRangeForScan

(

Int

scan

)

[pure virtual]

get the time range for the specified scan.

The vector returned will contain two elements, the start and stop time of the scan, determined from min(TIME_CENTROID(x)-0.5*INTERVAL(x)) and max(TIME_CENTROID(x)-0.5*INTERVAL(x))

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<Double> casa::MSMetaData::getTimesForField

(

Int

fieldID

)

[pure virtual]

get the times for which the specified field was observed

Implemented in casa::MSMetaDataOnDemand.

std::set<Double> casa::MSMetaData::getTimesForScan

(

const Int

scan

)

get the times for the specified scan.

No need to be implemented or overridden in subclasses. The return values come from the TIME column.

virtual std::set<Double> casa::MSMetaData::getTimesForScans

(

const std::set< Int > &

scans

)

[pure virtual]

Get the times for the specified scans.

Implemented in casa::MSMetaDataOnDemand.

virtual Matrix<Bool> casa::MSMetaData::getUniqueBaselines

(

)

[pure virtual]

get a map relating time stamps to exposure times.

An exception is thrown if there are different exposure lengths for records with the same time stamp virtual std::map<Double, Double> getExposuresForTimes() const = 0;

get the unique baselines in the MS. These are not necessarily every combination of the n(n-1)/2 possible antenna pairs, but rather the number of unique baselines represented in the main MS table, which in theory can be less than n(n-1)/2 (for example if samples for certain antenna pairs are not recorded. The returned Matrix is nAnts x nAnts in size. Pairs that are true represent baselines represented in the main MS table.

Implemented in casa::MSMetaDataOnDemand.

virtual std::set<uInt> casa::MSMetaData::getWVRSpw

(

)

[pure virtual]

Get the spectral window set used for WVR measurements.

These have 4 channels each.

Implemented in casa::MSMetaDataOnDemand.

static Bool casa::MSMetaData::hasBBCNo

(

const MeasurementSet &

ms

)

[static]

virtual uInt casa::MSMetaData::nAntennas

(

)

[pure virtual]

get the number of antennas in the ANTENNA table

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nArrays

(

)

[pure virtual]

get the number of arrays (from the ARRAY table) in the dataset

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nBaselines

(

)

[virtual]

get the number of unique baselines represented in the main MS table which in theory can be less than n*(n-1)/2

virtual vector<uInt> casa::MSMetaData::nChans

(

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nFields

(

)

[pure virtual]

get the number of fields.

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nObservations

(

)

[pure virtual]

get the number of observations (from the OBSERVATIONS table) in the dataset

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nRows

(

)

[pure virtual]

get the number of rows

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nRows

(

CorrelationType

cType

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nRows	(	CorrelationType	cType,
		Int	arrayID,
		Int	observationID,
		Int	scanNumber,
		Int	fieldID
	)		[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nRows	(	CorrelationType	cType,
		Int	fieldID
	)		[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nScans

(

)

[pure virtual]

get the number of scans in the dataset

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nSpw

(

Bool

includewvr

)

[pure virtual]

get number of spectral windows

Implemented in casa::MSMetaDataOnDemand.

virtual uInt casa::MSMetaData::nStates

(

)

[pure virtual]

construct an object which loads metadata from the specified MS.

If onDemand=False, the MS is interrogated at construction time, so this operation can take some time for a large MS, the benefit being that all metadata are immediately accessible. If onDemand=True, a pointer to the MS is maintained internally, and portions of the MS are queried only when necessary. The benefit being that construction time is short. However, queries may take longer than if onDemand=False and because the MS is interrogated only when the query is run and the query results are not stored (which allows query methods to be const). The MS object cannot go out of scope in the calling code while the MSMetaData object exists or seg faults will likely occur. Use onDemand=True if MS is large and/or only a small number of queries are needed. MSMetaData(const MeasurementSet& ms, Bool onDemand);

number of unique states (number of rows from the STATE table)

Implemented in casa::MSMetaDataOnDemand.

virtual Double casa::MSMetaData::nUnflaggedRows

(

)

[pure virtual]

get the number of unflagged rows

Implemented in casa::MSMetaDataOnDemand.

virtual Double casa::MSMetaData::nUnflaggedRows

(

CorrelationType

cType

)

[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual Double casa::MSMetaData::nUnflaggedRows	(	CorrelationType	cType,
		Int	arrayID,
		Int	observationID,
		Int	scanNumber,
		Int	fieldID
	)		[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

virtual Double casa::MSMetaData::nUnflaggedRows	(	CorrelationType	cType,
		Int	fieldID
	)		[pure virtual]

Implemented in casa::MSMetaDataOnDemand.

---

The documentation for this class was generated from the following file:

• casacore/ms/MeasurementSets/MSMetaData.h