ROCTIter: Read-only iterating interface to New Calibration tables. More...

#include <CTIter.h>

Inheritance diagram for casa::ROCTIter:

Public Member Functions
	ROCTIter (NewCalTable tab, const Block< String > &sortcol)
	Constructor/Destructor.
virtual	~ROCTIter ()
void	reset ()
	Iteration operators.
Bool	pastEnd ()
void	next ()
void	next0 ()
NewCalTable	table () const
	Return the current table iteration.
Int	nrow () const
Double	thisTime () const
	Column accessors Those methods that return scalars for data coordinates (e.g., thisTime(), thisField(), etc.) return the first element of the corresponding vector of values in the current iteration.
Vector< Double >	time () const
void	time (Vector< Double > &v) const
Int	thisField () const
Vector< Int >	field () const
void	field (Vector< Int > &v) const
Int	thisSpw () const
Vector< Int >	spw () const
void	spw (Vector< Int > &v) const
Int	thisScan () const
Vector< Int >	scan () const
void	scan (Vector< Int > &v) const
Int	thisObs () const
Vector< Int >	obs () const
void	obs (Vector< Int > &v) const
Int	thisAntenna1 () const
Vector< Int >	antenna1 () const
void	antenna1 (Vector< Int > &v) const
Int	thisAntenna2 () const
Vector< Int >	antenna2 () const
void	antenna2 (Vector< Int > &v) const
Cube< Complex >	cparam () const
void	cparam (Cube< Complex > &c) const
Cube< Float >	fparam () const
void	fparam (Cube< Float > &c) const
Cube< Float >	casfparam (String what="") const
void	casfparam (Cube< Float > &casf, String what="") const
Cube< Float >	paramErr () const
void	paramErr (Cube< Float > &c) const
Cube< Float >	snr () const
void	snr (Cube< Float > &c) const
Cube< Float >	wt () const
void	wt (Cube< Float > &c) const
Cube< Bool >	flag () const
void	flag (Cube< Bool > &c) const
Int	nchan () const
Vector< Int >	chan () const
void	chan (Vector< Int > &v) const
Vector< Double >	freq () const
void	freq (Vector< Double > &v) const
Protected Member Functions
virtual void	attach ()
	Attach accessors.
Private Member Functions
	ROCTIter (const ROCTIter &other)
	Prohibit public use of copy, assignment.
ROCTIter &	operator= (const ROCTIter &other)
Private Attributes
Vector< String >	sortCols_
	Data:
Bool	singleSpw_
	If true, spw is unique per iteration, and it is safe to access channel axis info.
NewCalTable	parentNCT_
	The parent NewCalTable (Table) object (stays in scope for the life of the CTIter)
ROCTColumns	calCol_
	Access to subtables (e.g., for frequencies)
TableIterator *	ti_
	The underlying TableIterator.
NewCalTable *	inct_
	Per-iteration table.
ROCTMainColumns *	iROCTMainCols_
	Per-iteration columns.

Detailed Description

ROCTIter: Read-only iterating interface to New Calibration tables.

Prerequisite

NewCalTable module

Etymology

From "calibration", "table", and "iteration".

Synopsis

The ROCTIter class provide basic iterated access to the contents of a NewCalTable. The iteration is initialized according to sort columns specified in the constructor, and access to the contents of each iteration is provided via a NewCalTable object (referencing the iterated subset of the original NewCalTable) or methods that return Vectors or Arrays of the contents of specific columns. For the latter, the Vectors/Arrays are generated only on-demand.

Example

Motivation

This class is used by calibration table clients to access calibration tables in a piecemeal fashion, e.g., for plotting, interpolation, etc.

Definition at line 76 of file CTIter.h.

Constructor & Destructor Documentation

casa::ROCTIter::ROCTIter	(	NewCalTable	tab,
		const Block< String > &	sortcol
	)

Constructor/Destructor.

virtual casa::ROCTIter::~ROCTIter ( ) [virtual]

casa::ROCTIter::ROCTIter ( const ROCTIter & other ) [private]

Prohibit public use of copy, assignment.

Member Function Documentation

Vector<Int> casa::ROCTIter::antenna1 ( ) const

void casa::ROCTIter::antenna1 ( Vector< Int > & v ) const

Vector<Int> casa::ROCTIter::antenna2 ( ) const

void casa::ROCTIter::antenna2 ( Vector< Int > & v ) const

virtual void casa::ROCTIter::attach ( ) [protected, virtual]

Attach accessors.

Reimplemented in casa::CTIter.

Referenced by reset().

Cube<Float> casa::ROCTIter::casfparam ( String what = "" ) const

void casa::ROCTIter::casfparam	(	Cube< Float > &	casf,
		String	what = `""`
	)		const

Vector<Int> casa::ROCTIter::chan ( ) const

void casa::ROCTIter::chan ( Vector< Int > & v ) const

Cube<Complex> casa::ROCTIter::cparam ( ) const

void casa::ROCTIter::cparam ( Cube< Complex > & c ) const

Vector<Int> casa::ROCTIter::field ( ) const

void casa::ROCTIter::field ( Vector< Int > & v ) const

Cube<Bool> casa::ROCTIter::flag ( ) const

void casa::ROCTIter::flag ( Cube< Bool > & c ) const

Cube<Float> casa::ROCTIter::fparam ( ) const

void casa::ROCTIter::fparam ( Cube< Float > & c ) const

Vector<Double> casa::ROCTIter::freq ( ) const

void casa::ROCTIter::freq ( Vector< Double > & v ) const

Int casa::ROCTIter::nchan ( ) const

void casa::ROCTIter::next ( )

void casa::ROCTIter::next0 ( )

Int casa::ROCTIter::nrow ( ) const [inline]

Definition at line 92 of file CTIter.h.

References casa::Table::nrow(), casa::TableIterator::table(), and ti_.

Vector<Int> casa::ROCTIter::obs ( ) const

void casa::ROCTIter::obs ( Vector< Int > & v ) const

ROCTIter& casa::ROCTIter::operator= ( const ROCTIter & other ) [private]

Cube<Float> casa::ROCTIter::paramErr ( ) const

void casa::ROCTIter::paramErr ( Cube< Float > & c ) const

Bool casa::ROCTIter::pastEnd ( ) [inline]

Definition at line 85 of file CTIter.h.

References casa::TableIterator::pastEnd(), and ti_.

void casa::ROCTIter::reset ( ) [inline]

Iteration operators.

Definition at line 84 of file CTIter.h.

References attach(), casa::TableIterator::reset(), and ti_.

Vector<Int> casa::ROCTIter::scan ( ) const

void casa::ROCTIter::scan ( Vector< Int > & v ) const

Cube<Float> casa::ROCTIter::snr ( ) const

void casa::ROCTIter::snr ( Cube< Float > & c ) const

Vector<Int> casa::ROCTIter::spw ( ) const

void casa::ROCTIter::spw ( Vector< Int > & v ) const

NewCalTable casa::ROCTIter::table ( ) const [inline]

Return the current table iteration.

Definition at line 90 of file CTIter.h.

References casa::TableIterator::table(), and ti_.

Int casa::ROCTIter::thisAntenna1 ( ) const

Int casa::ROCTIter::thisAntenna2 ( ) const

Int casa::ROCTIter::thisField ( ) const

Int casa::ROCTIter::thisObs ( ) const

Int casa::ROCTIter::thisScan ( ) const

Int casa::ROCTIter::thisSpw ( ) const

Double casa::ROCTIter::thisTime ( ) const

Column accessors Those methods that return scalars for data coordinates (e.g., thisTime(), thisField(), etc.) return the first element of the corresponding vector of values in the current iteration.

This makes the most sense when the corresponding column is a sort column in the iteration, such that the contents of the vector is in fact a unique value. (TBD: return -1 from scalar methods when column is not unique?)

Vector<Double> casa::ROCTIter::time ( ) const