casa::ROVisibilityIterator Class Reference

ROVisibilityIterator iterates through one or more readonly MeasurementSets. More...

#include <VisibilityIterator.h>

Inheritance diagram for casa::ROVisibilityIterator:
casa::ROVisIterator casa::VisibilityIterator casa::VisIterator

List of all members.

Classes

class  AsyncEnabler
class  Factory
 VLAT should not access private parts, especially variables. More...

Public Types

enum  PolFrame {
  Circular,
  Linear
}
enum  DataColumn {
  Observed,
  Model,
  Corrected
}
typedef enum
casa::ROVisibilityIterator::DataColumn 
DataColumn

Public Member Functions

 ROVisibilityIterator ()
 Default constructor - useful only to assign another iterator later.
 ROVisibilityIterator (const MeasurementSet &ms, const Block< Int > &sortColumns, Double timeInterval=0, const Factory &factory=Factory())
 Construct from an MS and a Block of MS column enums specifying the iteration order.
 ROVisibilityIterator (const MeasurementSet &ms, const Block< Int > &sortColumns, const Bool addDefaultSortCols, Double timeInterval=0)
 Same as above, but with the option of using the raw order of ms (addDefaultSortCols=false).
 ROVisibilityIterator (const Block< MeasurementSet > &mss, const Block< Int > &sortColumns, Double timeInterval=0)
 Same as previous constructors, but with multiple MSs to iterate over.
 ROVisibilityIterator (const Block< MeasurementSet > &mss, const Block< Int > &sortColumns, const Bool addDefaultSortCols, Double timeInterval=0)
 ROVisibilityIterator (const asyncio::PrefetchColumns *prefetchColumns, const MeasurementSet &ms, const Block< Int > &sortColumns, const Bool addDefaultSortCols=True, Double timeInterval=0)
 ROVisibilityIterator (const asyncio::PrefetchColumns *prefetchColumns, const Block< MeasurementSet > &mss, const Block< Int > &sortColumns, const Bool addDefaultSortCols=True, Double timeInterval=0)
 ROVisibilityIterator (const ROVisibilityIterator &other)
 Copy construct.
 ROVisibilityIterator (const asyncio::PrefetchColumns *prefetchColumns, const ROVisibilityIterator &other)
ROVisibilityIteratoroperator= (const ROVisibilityIterator &other)
 Assigment.
virtual ~ROVisibilityIterator ()
 Destructor.
Bool isAsynchronous () const
 static ROVisibilityIterator * create (const MeasurementSet & ms, const Block<Int>& sortColumns, const asyncio::PrefetchColumns * prefetchColumns = NULL, const Bool addDefaultSortCols = True, Double timeInterval=0);
Bool isAsyncEnabled () const
Bool isWritable () const
void origin ()
 Reset iterator to origin/start of data (of current chunk).
void originChunks ()
 Reset iterator to true start of data (first chunk).
Double getInterval () const
 Return the time interval (in seconds) used for iteration.
void setInterval (Double timeInterval)
 Set or reset the time interval (in seconds) to use for iteration.
void setRowBlocking (Int nRows=0)
 Set the 'blocking' size for returning data.
Bool more () const
 Return False if no more data (in current chunk).
SubChunkPair getSubchunkId () const
ROVisibilityIteratoroperator++ (int)
 Advance iterator through data.
ROVisibilityIteratoroperator++ ()
Bool moreChunks () const
 Return False if no more 'Chunks' of data left.
Bool newMS () const
 Check if ms has change since last iteration.
Int msId () const
VisBuffergetVisBuffer ()
const MeasurementSet & ms () const
 reference to actual ms in interator
ROVisibilityIteratornextChunk ()
 Advance to the next Chunk of data.
Vector< Int > & antenna1 (Vector< Int > &ant1) const
 Return antenna1.
Vector< Int > & antenna2 (Vector< Int > &ant2) const
 Return antenna2.
Vector< Int > & feed1 (Vector< Int > &fd1) const
 Return feed1.
Vector< Int > & feed2 (Vector< Int > &fd2) const
 Return feed2.
virtual Vector< Int > & channel (Vector< Int > &chan) const
 Return channel numbers in selected VisSet spectrum (i.e.
Vector< SquareMatrix< Complex, 2 > > & CJones (Vector< SquareMatrix< Complex, 2 > > &cjones) const
 Return feed configuration matrix for specified antenna.
const Cube< Double > & receptorAngles () const
 Return receptor angles for all antennae and feeds First axis of the cube is a receptor number, 2nd is antennaId, 3rd is feedId Note: the method is intended to provide an access to MSIter::receptorAngles for VisBuffer in the multi-feed case.
const Vector< String > & antennaMounts () const
 return a string mount identifier for each antenna
const Cube< RigidVector
< Double, 2 > > & 
getBeamOffsets () const
 Return a cube containing pairs of coordinate offsets for each receptor of each feed (values are in radians, coordinate system is fixed with antenna and is the same one as used to define the BEAM_OFFSET parameter in the feed table).
Bool allBeamOffsetsZero () const
 True if all elements of the cube returned by getBeamOffsets are zero.
Vector< Float > feed_pa (Double time) const
 Return feed parallactic angles Vector(nant) (1 feed/ant).
const Float & parang0 (Double time) const
 Return nominal parallactic angle at specified time (does not include feed position angle offset--see feed_pa) A global value for all antennas (e.g., small array).
Vector< Float > parang (Double time) const
 Per antenna:.
MDirection azel0 (Double time) const
 Return the antenna AZ/EL Vector(nant).
Vector< MDirection > azel (Double time) const
Double hourang (Double time) const
 Return the hour angle for the specified time.
Int fieldId () const
 Return the current FieldId.
Int arrayId () const
 Return the current ArrayId.
String fieldName () const
 Return the current Field Name.
String sourceName () const
 Return the current Source Name.
virtual Cube< Bool > & flag (Cube< Bool > &flags) const
 Return flag for each polarization, channel and row.
Matrix< Bool > & flag (Matrix< Bool > &flags) const
 Return flag for each channel & row.
Bool existsFlagCategory () const
 Determine whether FLAG_CATEGORY is valid.
Array< Bool > & flagCategory (Array< Bool > &flagCategories) const
 Return flags for each polarization, channel, category, and row.
Vector< Bool > & flagRow (Vector< Bool > &rowflags) const
 Return row flag.
Vector< Int > & scan (Vector< Int > &scans) const
 Return scan number.
Vector< Int > & observationId (Vector< Int > &obsids) const
 Return the OBSERVATION_IDs.
Vector< Int > & processorId (Vector< Int > &procids) const
 Return the PROCESSOR_IDs.
Vector< Int > & stateId (Vector< Int > &stateids) const
 Return the STATE_IDs.
virtual Vector< Double > & frequency (Vector< Double > &freq) const
 Return current frequencies (in Hz, acc.
Vector< Double > & lsrFrequency (Vector< Double > &freq) const
 Return frequencies (in Hz, acc.
const MDirection & phaseCenter () const
 Return the current phase center as an MDirection.
Int polFrame () const
 Return frame for polarization (returns PolFrame enum).
virtual Vector< Int > & corrType (Vector< Int > &corrTypes) const
 Return the correlation type (returns Stokes enums).
Vector< Float > & sigma (Vector< Float > &sig) const
 Return sigma.
virtual Matrix< Float > & sigmaMat (Matrix< Float > &sigmat) const
 Return sigma matrix (pol-dep).
Int spectralWindow () const
 Return current SpectralWindow.
Int polarizationId () const
 Return current Polarization Id.
Int dataDescriptionId () const
 Return current DataDescription Id.
Vector< Double > & time (Vector< Double > &t) const
 Return MJD midpoint of interval.
Vector< Double > & timeCentroid (Vector< Double > &t) const
 Return MJD centroid of interval.
Vector< Double > & timeInterval (Vector< Double > &ti) const
 Return nominal time interval.
Vector< Double > & exposure (Vector< Double > &expo) const
 Return actual time interval.
virtual Cube< Complex > & visibility (Cube< Complex > &vis, DataColumn whichOne) const
 Return the visibilities as found in the MS, Cube(npol,nchan,nrow).
Cube< Float > & floatData (Cube< Float > &fcube) const
 Return FLOAT_DATA as a Cube(npol, nchan, nrow) if found in the MS.
Matrix< CStokesVector > & visibility (Matrix< CStokesVector > &vis, DataColumn whichOne) const
 Return the visibility 4-vector of polarizations for each channel.
IPosition visibilityShape () const
 Return the shape of the visibility Cube.
virtual Vector< RigidVector
< Double, 3 > > & 
uvw (Vector< RigidVector< Double, 3 > > &uvwvec) const
 Return u,v and w (in meters).
Matrix< Double > & uvwMat (Matrix< Double > &uvwmat) const
Vector< Float > & weight (Vector< Float > &wt) const
 Return weight.
virtual Matrix< Float > & weightMat (Matrix< Float > &wtmat) const
 Returns the nPol_p x curNumRow_p weight matrix.
Bool existsWeightSpectrum () const
 Determine whether WEIGHT_SPECTRUM exists.
Cube< Float > & weightSpectrum (Cube< Float > &wtsp) const
 Return weightspectrum (a weight for each channel).
Bool newFieldId () const
 Return imaging weight (a weight for each channel) Matrix<Float>& imagingWeight(Matrix<Float>& wt) const; Return True if FieldId/Source has changed since last iteration.
Bool newArrayId () const
 Return True if arrayID has changed since last iteration.
Bool newSpectralWindow () const
 Return True if SpectralWindow has changed since last iteration.
Int channelIndex () const
 Return the index of the first channel of the current channel group in the total (selected) spectrum.
Int channelGroupSize () const
 Return the width of the current group of channels, i.e., the number of channels returned by visibility() and frequency().
Int nCorr () const
 Return the number of correlations in the current iteration.
Int nRow () const
 Return the number of rows in the current iteration.
virtual Vector< uInt > & rowIds (Vector< uInt > &rowids) const
 Return the row ids as from the original root table.
Int nRowChunk () const
 Return the numbers of rows in the current chunk.
Int nSubInterval () const
 Return the number of sub-intervals in the current chunk.
void slurp () const
 Call to use the slurp i/o method for all scalar columns.
ROVisibilityIteratorselectVelocity (Int nChan, const MVRadialVelocity &vStart, const MVRadialVelocity &vInc, MRadialVelocity::Types rvType=MRadialVelocity::LSR, MDoppler::Types dType=MDoppler::RADIO, Bool precise=False)
 Velocity selection - specify the output channels in velocity: nChan - number of output channels, vStart - start velocity, vInc - velocity increment.
ROVisibilityIteratorvelInterpolation (const String &type)
 Select the velocity interpolation scheme.
ROVisibilityIteratorselectChannel (Int nGroup=1, Int start=0, Int width=0, Int increment=1, Int spectralWindow=-1)
 Channel selection - only the selected channels will be returned by the access functions.
ROVisibilityIteratorselectChannel (Block< Vector< Int > > &blockNGroup, Block< Vector< Int > > &blockStart, Block< Vector< Int > > &blockWidth, Block< Vector< Int > > &blockIncr, Block< Vector< Int > > &blockSpw)
 Same as above except when multiple ms's are to be accessed.
void getChannelSelection (Block< Vector< Int > > &blockNGroup, Block< Vector< Int > > &blockStart, Block< Vector< Int > > &blockWidth, Block< Vector< Int > > &blockIncr, Block< Vector< Int > > &blockSpw)
 get the channel selection ...the block over the number of ms's associated with this iterator
void slicesToMatrices (Vector< Matrix< Int > > &matv, const Vector< Vector< Slice > > &slicesv, const Vector< Int > &widthsv) const
 Translate slicesv from the form returned by MSSelection::getChanSlices() to matv as used by setChanAveBounds().
void getSpwInFreqRange (Block< Vector< Int > > &spw, Block< Vector< Int > > &start, Block< Vector< Int > > &nchan, Double freqStart, Double freqEnd, Double freqStep, MFrequency::Types freqFrame=MFrequency::LSRK)
 Get the spw, start and nchan for all the ms's is this Visiter that match the frequecy "freqstart-freqStep" and "freqEnd+freqStep" range Can help in doing channel selection above.
void getFreqInSpwRange (Double &freqStart, Double &freqEnd, MFrequency::Types freqframe=MFrequency::LSRK)
 Get the frequency range of the data selection.
void attachVisBuffer (VisBuffer &vb)
 Attach a VisBuffer object.
void detachVisBuffer (VisBuffer &vb)
 Detach a VisBuffer object.
const ROMSColumns & msColumns () const
 Access the current ROMSColumns object in MSIter.
void allSelectedSpectralWindows (Vector< Int > &spws, Vector< Int > &nvischan)
 get back the selected spectral windows and spectral channels for current ms
void lsrFrequency (const Int &spw, Vector< Double > &freq, Bool &convert, const Bool ignoreconv=False)
 Convert the frequency from the observe frame to lsr frame.
void useImagingWeight (const VisImagingWeight &imWgt)
 assign a VisImagingWeight object to this iterator
const VisImagingWeightgetImagingWeightGenerator () const
Int numberAnt ()
 return number of Ant
Int numberCoh ()
 Return number of rows in all selected ms's.
Int numberSpw ()
 Return number of spws, polids, ddids.
Int numberPol ()
Int numberDDId ()
Int getDataDescriptionId () const
 ROArrayColumn <Double> & getChannelFrequency () const; Block<Int> getChannelGroupNumber () const; Block<Int> getChannelIncrement () const; Block<Int> getChannelStart () const; Block<Int> getChannelWidth () const;.
const MeasurementSet & getMeasurementSet () const
Int getMeasurementSetId () const
Int getNAntennas () const
MEpoch getEpoch () const
Vector< Float > getReceptor0Angle ()
Vector< uInt > getRowIds () const
const Block< Int > & getSortColumns () const
 Returns the columns that the VisibilityIterator is sorting by.

Static Public Member Functions

static Bool isAsynchronousIoEnabled ()
static Vector< Float > feed_paCalculate (Double time, MSDerivedValues &msd, Int nAntennas, const MEpoch &mEpoch0, const Vector< Float > &receptor0Angle)
static Float parang0Calculate (Double time, MSDerivedValues &msd, const MEpoch &epoch0)
static Vector< Float > parangCalculate (Double time, MSDerivedValues &msd, int nAntennas, const MEpoch mEpoch0)
static void azel0Calculate (Double time, MSDerivedValues &msd, MDirection &azel0, const MEpoch &mEpoch0)
static void azelCalculate (Double time, MSDerivedValues &msd, Vector< MDirection > &azel, Int nAnt, const MEpoch &mEpoch0)
static Double hourangCalculate (Double time, MSDerivedValues &msd, const MEpoch &mEpoch0)
static void lsrFrequency (const Int &spw, Vector< Double > &freq, Bool &convert, const Block< Int > &chanStart, const Block< Int > &chanWidth, const Block< Int > &chanInc, const Block< Int > &numChanGroup, const ROArrayColumn< Double > &chanFreqs, const ROScalarColumn< Int > &obsMFreqTypes, const MEpoch &ep, const MPosition &obsPos, const MDirection &dir)
static String getAipsRcBase ()
static String getAsyncRcBase ()

Protected Member Functions

 ROVisibilityIterator (const asyncio::PrefetchColumns *prefetchColumns, const Block< MeasurementSet > &mss, const Block< Int > &sortColumns, const Bool addDefaultSortCols, Double timeInterval, Bool writable)
void construct (const asyncio::PrefetchColumns *prefetchColumns, const Block< MeasurementSet > &mss, const Block< Int > &sortColumns, const Bool addDefaultSortCols, Double timeInterval, Bool writable, const Factory &factory)
VisibilityIteratorReadImplgetReadImpl () const
bool existsColumn (VisBufferComponents::EnumType id) const
virtual void advance ()
 advance the iteration
virtual void setSelTable ()
 set the currently selected table
void setState ()
 set the iteration state
void getTopoFreqs ()
 get the TOPO frequencies from the selected velocities and the obs.
void getTopoFreqs (Vector< Double > &lsrFreq, Vector< Double > &selFreq)
void getLsrInfo (Block< Int > &channelGroupNumber, Block< Int > &channelIncrement, Block< Int > &channelStart, Block< Int > &channelWidth, MPosition &observatoryPositon, MDirection &phaseCenter, Bool &velocitySelection) const
std::vector< MeasurementSet > getMeasurementSets () const
const MSDerivedValues & getMSD () const
virtual void updateSlicer ()
 update the DATA slicer
virtual void attachColumns (const Table &t)
 attach the column objects to the currently selected table
virtual const Table attachTable () const
 returns the table, to which columns are attached, can be overridden in derived classes
void getDataColumn (DataColumn whichOne, const Slicer &slicer, Cube< Complex > &data) const
 get the (velocity selected) interpolated visibilities, flags and weights.
void getDataColumn (DataColumn whichOne, Cube< Complex > &data) const
void getFloatDataColumn (const Slicer &slicer, Cube< Float > &data) const
 get FLOAT_DATA as real Floats.
void getFloatDataColumn (Cube< Float > &data) const
void originChunks (Bool forceRewind)
void doChannelSelection ()
 Re-Do the channel selection in multi ms case.
virtual void setTileCache ()
 Set the tile cache size....when using slice access if tile cache size is not set memory usage can go wild.
Bool isInSelectedSPW (const Int &spw)
 Check if spw is in selected SPW for actual ms.
void update_rowIds () const
 Updates, if necessary, rowIds_p member for the current chunk.
void setAsyncEnabled (Bool enable)
template<class T >
void getColScalar (const ROScalarColumn< T > &column, Vector< T > &array, Bool resize) const
template<class T >
void getColArray (const ROArrayColumn< T > &column, Array< T > &array, Bool resize) const
virtual void getCol (const ROScalarColumn< Bool > &column, Vector< Bool > &array, Bool resize=False) const
 column access functions, can be overridden in derived classes
virtual void getCol (const ROScalarColumn< Int > &column, Vector< Int > &array, Bool resize=False) const
virtual void getCol (const ROScalarColumn< Double > &column, Vector< Double > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Bool > &column, Array< Bool > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Float > &column, Array< Float > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Double > &column, Array< Double > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Complex > &column, Array< Complex > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Bool > &column, const Slicer &slicer, Array< Bool > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Float > &column, const Slicer &slicer, Array< Float > &array, Bool resize=False) const
virtual void getCol (const ROArrayColumn< Complex > &column, const Slicer &slicer, Array< Complex > &array, Bool resize=False) const
template<class T >
void swapyz (Cube< T > &out, const Cube< T > &in) const
 void getCol(const String &colName, Array<Double> &array, Array<Double> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Bool> &array, Vector<Bool> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Int> &array, Vector<Int> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Double> &array, Vector<Double> &all, Bool resize = False) const;

Protected Attributes

VisibilityIteratorReadImplreadImpl_p

Friends

class AsyncEnabler
class VisibilityIteratorReadImpl
class ViReadImplAsync
class asyncio::VLAT

Detailed Description

ROVisibilityIterator iterates through one or more readonly MeasurementSets.

Intended use:

Public interface

Review Status

Date Reviewed:
yyyy/mm/dd

Prerequisite

Etymology

The ROVisibilityIterator is a readonly iterator returning visibilities

Synopsis

ROVisibilityIterator provides iteration with various sort orders for one or more MSs. It has member functions to retrieve the fields commonly needed in synthesis calibration and imaging.

One should use VisBuffer to access chunks of data.

ROVisibilityIterators can be either synchronous or asynchronous, depending on the constructor used to create them as well as the current value of a CASARC file setting. A synchronous instance is works the same as this class ever worked; an asynchronous instance uses a second thread (the Visibility Lookahead Thread or VLAT) to fill the VisBuffers in advance of their use by the original thread.

To create an asynchronous instance of ROVI you must use one of the two constructors which have a pointer to a PrefetchColumns object as the first argument. This object specifies which table columns should be prefetched by the VLAT; accessing columns not specified in the PrefetchColumns object will result in an exception containing an error message indicating that a the VisBuffer does not contain the requested column. In addition to using the appropriate constructor, the CASARC file setting VisibilityIterator.

+-------------------+ | | | *** Nota Bene *** | | | +-------------------+

Because of the multithreaded nature of asynchronous I/O, the user needs to be a bit more careful in the use of the VI and it's attached VisBuffer. Data access operations need to be directed to the VisBuffer. Additionally the user must not attempt to access the data using a separate VI since the underlying casacore objects are not threadsafe and bizarre errors will likely occur.

CASARC Settings ===============

Normal settings ---------------

VisibilityIterator.async.enabled - Boolean value that enables or disables async I/O. The default value is currently False (i.e., disabled). VisibilityIterator.async.nBuffers - The number of lookahead buffers. This defaults to 2.

Debug settings --------------

VisibilityIterator.async.doStats: true VisibilityIterator.async.debug.logFile: stderr VisibilityIterator.async.debug.logLevel: 1

Example

Motivation

For imaging and calibration you need to access an MS in some consistent order (by field, spectralwindow, time interval etc.). This class provides that access.

Thrown Exceptions

To Do

Definition at line 283 of file VisibilityIterator.h.


Member Typedef Documentation


Member Enumeration Documentation

Enumerator:
Observed 
Model 
Corrected 

Definition at line 318 of file VisibilityIterator.h.

Enumerator:
Circular 

Circular polarization.

Linear 

Linear polarization.

Definition at line 311 of file VisibilityIterator.h.


Constructor & Destructor Documentation

casa::ROVisibilityIterator::ROVisibilityIterator (  ) 

Default constructor - useful only to assign another iterator later.

casa::ROVisibilityIterator::ROVisibilityIterator ( const MeasurementSet &  ms,
const Block< Int > &  sortColumns,
Double  timeInterval = 0,
const Factory factory = Factory() 
)

Construct from an MS and a Block of MS column enums specifying the iteration order.

If no order is specified, it uses the default sort order of MSIter, which is not necessarily the raw order of ms! The default ordering is ARRAY_ID, FIELD_ID, DATA_DESC_ID, and TIME, but check MSIter.h to be sure. These columns will be added first if they are not specified.

An optional timeInterval (in seconds) can be given to iterate through chunks of time. The default interval of 0 groups all times together. Every 'chunk' of data contains all data within a certain time interval and with identical values of the other iteration columns (e.g. DATA_DESC_ID and FIELD_ID). Using selectChannel(), a number of groups of channels can be requested. At present the channel group iteration will always occur before the interval iteration.

casa::ROVisibilityIterator::ROVisibilityIterator ( const MeasurementSet &  ms,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols,
Double  timeInterval = 0 
)

Same as above, but with the option of using the raw order of ms (addDefaultSortCols=false).

casa::ROVisibilityIterator::ROVisibilityIterator ( const Block< MeasurementSet > &  mss,
const Block< Int > &  sortColumns,
Double  timeInterval = 0 
)

Same as previous constructors, but with multiple MSs to iterate over.

casa::ROVisibilityIterator::ROVisibilityIterator ( const Block< MeasurementSet > &  mss,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols,
Double  timeInterval = 0 
)
casa::ROVisibilityIterator::ROVisibilityIterator ( const asyncio::PrefetchColumns prefetchColumns,
const MeasurementSet &  ms,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols = True,
Double  timeInterval = 0 
)
casa::ROVisibilityIterator::ROVisibilityIterator ( const asyncio::PrefetchColumns prefetchColumns,
const Block< MeasurementSet > &  mss,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols = True,
Double  timeInterval = 0 
)
casa::ROVisibilityIterator::ROVisibilityIterator ( const ROVisibilityIterator other  ) 

Copy construct.

This calls the assigment operator.

casa::ROVisibilityIterator::ROVisibilityIterator ( const asyncio::PrefetchColumns prefetchColumns,
const ROVisibilityIterator other 
)
virtual casa::ROVisibilityIterator::~ROVisibilityIterator (  )  [virtual]

Destructor.

casa::ROVisibilityIterator::ROVisibilityIterator ( const asyncio::PrefetchColumns prefetchColumns,
const Block< MeasurementSet > &  mss,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols,
Double  timeInterval,
Bool  writable 
) [protected]

Member Function Documentation

virtual void casa::ROVisibilityIterator::advance (  )  [protected, virtual]

advance the iteration

Bool casa::ROVisibilityIterator::allBeamOffsetsZero (  )  const

True if all elements of the cube returned by getBeamOffsets are zero.

void casa::ROVisibilityIterator::allSelectedSpectralWindows ( Vector< Int > &  spws,
Vector< Int > &  nvischan 
)

get back the selected spectral windows and spectral channels for current ms

Reimplemented in casa::ROVisIterator.

Referenced by casa::VisBuffer::allSelectedSpectralWindows().

Vector<Int>& casa::ROVisibilityIterator::antenna1 ( Vector< Int > &  ant1  )  const

Return antenna1.

Vector<Int>& casa::ROVisibilityIterator::antenna2 ( Vector< Int > &  ant2  )  const

Return antenna2.

const Vector<String>& casa::ROVisibilityIterator::antennaMounts (  )  const

return a string mount identifier for each antenna

Int casa::ROVisibilityIterator::arrayId (  )  const

Return the current ArrayId.

virtual void casa::ROVisibilityIterator::attachColumns ( const Table &  t  )  [protected, virtual]

attach the column objects to the currently selected table

Reimplemented in casa::VisibilityIterator, and casa::VisIterator.

virtual const Table casa::ROVisibilityIterator::attachTable (  )  const [protected, virtual]

returns the table, to which columns are attached, can be overridden in derived classes

void casa::ROVisibilityIterator::attachVisBuffer ( VisBuffer vb  ) 

Attach a VisBuffer object.

Note that while more than one VisBuffer may be attached, only the last one is actively updated. A Stack is kept internally, so after a detach, the previous VisBuffer becomes active again.

Vector<MDirection> casa::ROVisibilityIterator::azel ( Double  time  )  const
MDirection casa::ROVisibilityIterator::azel0 ( Double  time  )  const

Return the antenna AZ/EL Vector(nant).

static void casa::ROVisibilityIterator::azel0Calculate ( Double  time,
MSDerivedValues &  msd,
MDirection &  azel0,
const MEpoch &  mEpoch0 
) [static]
static void casa::ROVisibilityIterator::azelCalculate ( Double  time,
MSDerivedValues &  msd,
Vector< MDirection > &  azel,
Int  nAnt,
const MEpoch &  mEpoch0 
) [static]
virtual Vector<Int>& casa::ROVisibilityIterator::channel ( Vector< Int > &  chan  )  const [virtual]

Return channel numbers in selected VisSet spectrum (i.e.

disregarding possible selection on the iterator, but including the selection set when creating the VisSet)

Int casa::ROVisibilityIterator::channelGroupSize (  )  const

Return the width of the current group of channels, i.e., the number of channels returned by visibility() and frequency().

Int casa::ROVisibilityIterator::channelIndex (  )  const

Return the index of the first channel of the current channel group in the total (selected) spectrum.

Vector<SquareMatrix<Complex,2> >& casa::ROVisibilityIterator::CJones ( Vector< SquareMatrix< Complex, 2 > > &  cjones  )  const

Return feed configuration matrix for specified antenna.

void casa::ROVisibilityIterator::construct ( const asyncio::PrefetchColumns prefetchColumns,
const Block< MeasurementSet > &  mss,
const Block< Int > &  sortColumns,
const Bool  addDefaultSortCols,
Double  timeInterval,
Bool  writable,
const Factory factory 
) [protected]
virtual Vector<Int>& casa::ROVisibilityIterator::corrType ( Vector< Int > &  corrTypes  )  const [virtual]

Return the correlation type (returns Stokes enums).

Reimplemented in casa::ROVisIterator.

Int casa::ROVisibilityIterator::dataDescriptionId (  )  const

Return current DataDescription Id.

void casa::ROVisibilityIterator::detachVisBuffer ( VisBuffer vb  ) 

Detach a VisBuffer object.

If the object detached is not the last one attached an exception is thrown.

void casa::ROVisibilityIterator::doChannelSelection (  )  [protected]

Re-Do the channel selection in multi ms case.

bool casa::ROVisibilityIterator::existsColumn ( VisBufferComponents::EnumType  id  )  const [protected]
Bool casa::ROVisibilityIterator::existsFlagCategory (  )  const

Determine whether FLAG_CATEGORY is valid.

Bool casa::ROVisibilityIterator::existsWeightSpectrum (  )  const

Determine whether WEIGHT_SPECTRUM exists.

Referenced by casa::VisBuffer::existsWeightSpectrum().

Vector<Double>& casa::ROVisibilityIterator::exposure ( Vector< Double > &  expo  )  const

Return actual time interval.

Vector<Int>& casa::ROVisibilityIterator::feed1 ( Vector< Int > &  fd1  )  const

Return feed1.

Vector<Int>& casa::ROVisibilityIterator::feed2 ( Vector< Int > &  fd2  )  const

Return feed2.

Vector<Float> casa::ROVisibilityIterator::feed_pa ( Double  time  )  const

Return feed parallactic angles Vector(nant) (1 feed/ant).

static Vector<Float> casa::ROVisibilityIterator::feed_paCalculate ( Double  time,
MSDerivedValues &  msd,
Int  nAntennas,
const MEpoch &  mEpoch0,
const Vector< Float > &  receptor0Angle 
) [static]
Int casa::ROVisibilityIterator::fieldId (  )  const

Return the current FieldId.

String casa::ROVisibilityIterator::fieldName (  )  const

Return the current Field Name.

Matrix<Bool>& casa::ROVisibilityIterator::flag ( Matrix< Bool > &  flags  )  const

Return flag for each channel & row.

virtual Cube<Bool>& casa::ROVisibilityIterator::flag ( Cube< Bool > &  flags  )  const [virtual]

Return flag for each polarization, channel and row.

Array<Bool>& casa::ROVisibilityIterator::flagCategory ( Array< Bool > &  flagCategories  )  const

Return flags for each polarization, channel, category, and row.

Vector<Bool>& casa::ROVisibilityIterator::flagRow ( Vector< Bool > &  rowflags  )  const

Return row flag.

Cube<Float>& casa::ROVisibilityIterator::floatData ( Cube< Float > &  fcube  )  const

Return FLOAT_DATA as a Cube(npol, nchan, nrow) if found in the MS.

virtual Vector<Double>& casa::ROVisibilityIterator::frequency ( Vector< Double > &  freq  )  const [virtual]

Return current frequencies (in Hz, acc.

to the MS def'n v.2)

static String casa::ROVisibilityIterator::getAipsRcBase (  )  [inline, static]

Definition at line 750 of file VisibilityIterator.h.

Referenced by getAsyncRcBase().

static String casa::ROVisibilityIterator::getAsyncRcBase (  )  [inline, static]

Definition at line 751 of file VisibilityIterator.h.

References getAipsRcBase().

const Cube<RigidVector<Double, 2> >& casa::ROVisibilityIterator::getBeamOffsets (  )  const

Return a cube containing pairs of coordinate offsets for each receptor of each feed (values are in radians, coordinate system is fixed with antenna and is the same one as used to define the BEAM_OFFSET parameter in the feed table).

The cube axes are receptor, antenna, feed.

void casa::ROVisibilityIterator::getChannelSelection ( Block< Vector< Int > > &  blockNGroup,
Block< Vector< Int > > &  blockStart,
Block< Vector< Int > > &  blockWidth,
Block< Vector< Int > > &  blockIncr,
Block< Vector< Int > > &  blockSpw 
)

get the channel selection ...the block over the number of ms's associated with this iterator

Reimplemented in casa::ROVisIterator.

Referenced by casa::VisBuffer::getChannelSelection().

virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Complex > &  column,
const Slicer &  slicer,
Array< Complex > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Float > &  column,
const Slicer &  slicer,
Array< Float > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Bool > &  column,
const Slicer &  slicer,
Array< Bool > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Complex > &  column,
Array< Complex > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Double > &  column,
Array< Double > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Float > &  column,
Array< Float > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROArrayColumn< Bool > &  column,
Array< Bool > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROScalarColumn< Double > &  column,
Vector< Double > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROScalarColumn< Int > &  column,
Vector< Int > &  array,
Bool  resize = False 
) const [protected, virtual]
virtual void casa::ROVisibilityIterator::getCol ( const ROScalarColumn< Bool > &  column,
Vector< Bool > &  array,
Bool  resize = False 
) const [protected, virtual]

column access functions, can be overridden in derived classes

template<class T >
void casa::ROVisibilityIterator::getColArray ( const ROArrayColumn< T > &  column,
Array< T > &  array,
Bool  resize 
) const [inline, protected]
template<class T >
void casa::ROVisibilityIterator::getColScalar ( const ROScalarColumn< T > &  column,
Vector< T > &  array,
Bool  resize 
) const [inline, protected]
void casa::ROVisibilityIterator::getDataColumn ( DataColumn  whichOne,
Cube< Complex > &  data 
) const [protected]
void casa::ROVisibilityIterator::getDataColumn ( DataColumn  whichOne,
const Slicer &  slicer,
Cube< Complex > &  data 
) const [protected]

get the (velocity selected) interpolated visibilities, flags and weights.

It is not really const at all (it seems to use This-> trickery so callers like flag() can be declared const). void getInterpolatedVisFlagWeight(DataColumn whichOne) const; get the (velocity selected) interpolated FLOAT_DATA (as real Floats), flags and weights. void getInterpolatedFloatDataFlagWeight() const; get the visibility data (observed, corrected or model); deals with Float and Complex observed data (DATA or FLOAT_DATA)

Int casa::ROVisibilityIterator::getDataDescriptionId (  )  const

ROArrayColumn <Double> & getChannelFrequency () const; Block<Int> getChannelGroupNumber () const; Block<Int> getChannelIncrement () const; Block<Int> getChannelStart () const; Block<Int> getChannelWidth () const;.

MEpoch casa::ROVisibilityIterator::getEpoch (  )  const
void casa::ROVisibilityIterator::getFloatDataColumn ( Cube< Float > &  data  )  const [protected]
void casa::ROVisibilityIterator::getFloatDataColumn ( const Slicer &  slicer,
Cube< Float > &  data 
) const [protected]

get FLOAT_DATA as real Floats.

void casa::ROVisibilityIterator::getFreqInSpwRange ( Double &  freqStart,
Double &  freqEnd,
MFrequency::Types  freqframe = MFrequency::LSRK 
)

Get the frequency range of the data selection.

const VisImagingWeight& casa::ROVisibilityIterator::getImagingWeightGenerator (  )  const
Double casa::ROVisibilityIterator::getInterval (  )  const

Return the time interval (in seconds) used for iteration.

This is not the same as the INTERVAL column.

void casa::ROVisibilityIterator::getLsrInfo ( Block< Int > &  channelGroupNumber,
Block< Int > &  channelIncrement,
Block< Int > &  channelStart,
Block< Int > &  channelWidth,
MPosition &  observatoryPositon,
MDirection &  phaseCenter,
Bool &  velocitySelection 
) const [protected]
const MeasurementSet& casa::ROVisibilityIterator::getMeasurementSet (  )  const
Int casa::ROVisibilityIterator::getMeasurementSetId (  )  const
std::vector<MeasurementSet> casa::ROVisibilityIterator::getMeasurementSets (  )  const [protected]
const MSDerivedValues& casa::ROVisibilityIterator::getMSD (  )  const [protected]
Int casa::ROVisibilityIterator::getNAntennas (  )  const
VisibilityIteratorReadImpl* casa::ROVisibilityIterator::getReadImpl (  )  const [protected]

Reimplemented in casa::ROVisIterator.

Vector<Float> casa::ROVisibilityIterator::getReceptor0Angle (  ) 
Vector<uInt> casa::ROVisibilityIterator::getRowIds (  )  const
const Block<Int>& casa::ROVisibilityIterator::getSortColumns (  )  const

Returns the columns that the VisibilityIterator is sorting by.

void casa::ROVisibilityIterator::getSpwInFreqRange ( Block< Vector< Int > > &  spw,
Block< Vector< Int > > &  start,
Block< Vector< Int > > &  nchan,
Double  freqStart,
Double  freqEnd,
Double  freqStep,
MFrequency::Types  freqFrame = MFrequency::LSRK 
)

Get the spw, start and nchan for all the ms's is this Visiter that match the frequecy "freqstart-freqStep" and "freqEnd+freqStep" range Can help in doing channel selection above.

\. freqFrame is the frame the caller frequency values are in (freqStart and freqEnd) These will be converted to the frame of the selected spw to match

SubChunkPair casa::ROVisibilityIterator::getSubchunkId (  )  const
void casa::ROVisibilityIterator::getTopoFreqs ( Vector< Double > &  lsrFreq,
Vector< Double > &  selFreq 
) [protected]
void casa::ROVisibilityIterator::getTopoFreqs (  )  [protected]

get the TOPO frequencies from the selected velocities and the obs.

vel.

VisBuffer* casa::ROVisibilityIterator::getVisBuffer (  ) 
Double casa::ROVisibilityIterator::hourang ( Double  time  )  const

Return the hour angle for the specified time.

static Double casa::ROVisibilityIterator::hourangCalculate ( Double  time,
MSDerivedValues &  msd,
const MEpoch &  mEpoch0 
) [static]
Bool casa::ROVisibilityIterator::isAsyncEnabled (  )  const
Bool casa::ROVisibilityIterator::isAsynchronous (  )  const

static ROVisibilityIterator * create (const MeasurementSet & ms, const Block<Int>& sortColumns, const asyncio::PrefetchColumns * prefetchColumns = NULL, const Bool addDefaultSortCols = True, Double timeInterval=0);

static ROVisibilityIterator * create (const Block<MeasurementSet>& mss, const Block<Int>& sortColumns, const asyncio::PrefetchColumns * prefetchColumns = NULL, const Bool addDefaultSortCols = True, Double timeInterval=0);

static ROVisibilityIterator * create (const ROVisibilityIterator & rovi, const asyncio::PrefetchColumns * prefetchColumns, Int nReadAheadBuffers = 2);

Members

static Bool casa::ROVisibilityIterator::isAsynchronousIoEnabled (  )  [static]
Bool casa::ROVisibilityIterator::isInSelectedSPW ( const Int &  spw  )  [protected]

Check if spw is in selected SPW for actual ms.

Bool casa::ROVisibilityIterator::isWritable (  )  const

Reimplemented in casa::VisibilityIterator.

static void casa::ROVisibilityIterator::lsrFrequency ( const Int &  spw,
Vector< Double > &  freq,
Bool &  convert,
const Block< Int > &  chanStart,
const Block< Int > &  chanWidth,
const Block< Int > &  chanInc,
const Block< Int > &  numChanGroup,
const ROArrayColumn< Double > &  chanFreqs,
const ROScalarColumn< Int > &  obsMFreqTypes,
const MEpoch &  ep,
const MPosition &  obsPos,
const MDirection &  dir 
) [static]
void casa::ROVisibilityIterator::lsrFrequency ( const Int &  spw,
Vector< Double > &  freq,
Bool &  convert,
const Bool  ignoreconv = False 
)

Convert the frequency from the observe frame to lsr frame.

Returns True in convert if given spw was not observed in the LSRK frame when ignoreconv=True...no conversion is done from data frame frequency is served as is

Reimplemented in casa::ROVisIterator.

Vector<Double>& casa::ROVisibilityIterator::lsrFrequency ( Vector< Double > &  freq  )  const

Return frequencies (in Hz, acc.

to the MS def'n v.2) in selected velocity frame, returns the same as frequency() if there is no vel selection active.

Bool casa::ROVisibilityIterator::more (  )  const

Return False if no more data (in current chunk).

Bool casa::ROVisibilityIterator::moreChunks (  )  const

Return False if no more 'Chunks' of data left.

const MeasurementSet& casa::ROVisibilityIterator::ms (  )  const

reference to actual ms in interator

const ROMSColumns& casa::ROVisibilityIterator::msColumns (  )  const

Access the current ROMSColumns object in MSIter.

Referenced by casa::VisBuffer::msColumns().

Int casa::ROVisibilityIterator::msId (  )  const
Int casa::ROVisibilityIterator::nCorr (  )  const

Return the number of correlations in the current iteration.

Bool casa::ROVisibilityIterator::newArrayId (  )  const

Return True if arrayID has changed since last iteration.

Bool casa::ROVisibilityIterator::newFieldId (  )  const

Return imaging weight (a weight for each channel) Matrix<Float>& imagingWeight(Matrix<Float>& wt) const; Return True if FieldId/Source has changed since last iteration.

Bool casa::ROVisibilityIterator::newMS (  )  const

Check if ms has change since last iteration.

Bool casa::ROVisibilityIterator::newSpectralWindow (  )  const

Return True if SpectralWindow has changed since last iteration.

ROVisibilityIterator& casa::ROVisibilityIterator::nextChunk (  ) 

Advance to the next Chunk of data.

Int casa::ROVisibilityIterator::nRow (  )  const

Return the number of rows in the current iteration.

Int casa::ROVisibilityIterator::nRowChunk (  )  const

Return the numbers of rows in the current chunk.

Int casa::ROVisibilityIterator::nSubInterval (  )  const

Return the number of sub-intervals in the current chunk.

Int casa::ROVisibilityIterator::numberAnt (  ) 

return number of Ant

Int casa::ROVisibilityIterator::numberCoh (  ) 

Return number of rows in all selected ms's.

Int casa::ROVisibilityIterator::numberDDId (  ) 
Int casa::ROVisibilityIterator::numberPol (  ) 
Int casa::ROVisibilityIterator::numberSpw (  ) 

Return number of spws, polids, ddids.

Vector<Int>& casa::ROVisibilityIterator::observationId ( Vector< Int > &  obsids  )  const

Return the OBSERVATION_IDs.

ROVisibilityIterator& casa::ROVisibilityIterator::operator++ (  ) 
ROVisibilityIterator& casa::ROVisibilityIterator::operator++ ( int   ) 

Advance iterator through data.

Reimplemented in casa::VisibilityIterator, casa::ROVisIterator, and casa::VisIterator.

ROVisibilityIterator& casa::ROVisibilityIterator::operator= ( const ROVisibilityIterator other  ) 

Assigment.

Any attached VisBuffers are lost in the assign.

Reimplemented in casa::VisibilityIterator, casa::ROVisIterator, and casa::VisIterator.

void casa::ROVisibilityIterator::origin (  ) 

Reset iterator to origin/start of data (of current chunk).

void casa::ROVisibilityIterator::originChunks ( Bool  forceRewind  )  [protected]
void casa::ROVisibilityIterator::originChunks (  ) 

Reset iterator to true start of data (first chunk).

Vector<Float> casa::ROVisibilityIterator::parang ( Double  time  )  const

Per antenna:.

const Float& casa::ROVisibilityIterator::parang0 ( Double  time  )  const

Return nominal parallactic angle at specified time (does not include feed position angle offset--see feed_pa) A global value for all antennas (e.g., small array).

static Float casa::ROVisibilityIterator::parang0Calculate ( Double  time,
MSDerivedValues &  msd,
const MEpoch &  epoch0 
) [static]
static Vector<Float> casa::ROVisibilityIterator::parangCalculate ( Double  time,
MSDerivedValues &  msd,
int  nAntennas,
const MEpoch  mEpoch0 
) [static]
const MDirection& casa::ROVisibilityIterator::phaseCenter (  )  const

Return the current phase center as an MDirection.

Int casa::ROVisibilityIterator::polarizationId (  )  const

Return current Polarization Id.

Referenced by casa::VisBuffer::polarizationId().

Int casa::ROVisibilityIterator::polFrame (  )  const

Return frame for polarization (returns PolFrame enum).

Vector<Int>& casa::ROVisibilityIterator::processorId ( Vector< Int > &  procids  )  const

Return the PROCESSOR_IDs.

const Cube<Double>& casa::ROVisibilityIterator::receptorAngles (  )  const

Return receptor angles for all antennae and feeds First axis of the cube is a receptor number, 2nd is antennaId, 3rd is feedId Note: the method is intended to provide an access to MSIter::receptorAngles for VisBuffer in the multi-feed case.

It may be worth to change the interface of feed_pa to return the information for all feeds.

virtual Vector<uInt>& casa::ROVisibilityIterator::rowIds ( Vector< uInt > &  rowids  )  const [virtual]

Return the row ids as from the original root table.

This is useful to find correspondance between a given row in this iteration to the original ms row

Vector<Int>& casa::ROVisibilityIterator::scan ( Vector< Int > &  scans  )  const

Return scan number.

ROVisibilityIterator& casa::ROVisibilityIterator::selectChannel ( Block< Vector< Int > > &  blockNGroup,
Block< Vector< Int > > &  blockStart,
Block< Vector< Int > > &  blockWidth,
Block< Vector< Int > > &  blockIncr,
Block< Vector< Int > > &  blockSpw 
)

Same as above except when multiple ms's are to be accessed.

ROVisibilityIterator& casa::ROVisibilityIterator::selectChannel ( Int  nGroup = 1,
Int  start = 0,
Int  width = 0,
Int  increment = 1,
Int  spectralWindow = -1 
)

Channel selection - only the selected channels will be returned by the access functions.

The default spectralWindow is the current one (or 0) This allows selection of the input channels, producing nGroup groups of width output channels. Default is to return all channels in a single group.

ROVisibilityIterator& casa::ROVisibilityIterator::selectVelocity ( Int  nChan,
const MVRadialVelocity &  vStart,
const MVRadialVelocity &  vInc,
MRadialVelocity::Types  rvType = MRadialVelocity::LSR,
MDoppler::Types  dType = MDoppler::RADIO,
Bool  precise = False 
)

Velocity selection - specify the output channels in velocity: nChan - number of output channels, vStart - start velocity, vInc - velocity increment.

So channel i will have velocity vStart + i*vInc (i=0,nChan-1). Specify velocities as in e.g., MVRadialVelocity(Quantity(2001.,"km/s")). The reference type and velocity definition are specified separately. Note that no averaging is performed, the visibilities will be interpolated and sampled at the specified velocities, it's up to you to choose a vInc appropriate to the channel width. The REST_FREQUENCY column in the SPECTRAL_WINDOW subtable is used to determine the velocity-frequency conversion. By default calculations are done for a single velocity with offsets applied for the others (ok for non-rel velocities with RADIO defn), set precise to True to do a full conversion for each output channel.(NYI)

void casa::ROVisibilityIterator::setAsyncEnabled ( Bool  enable  )  [protected]
void casa::ROVisibilityIterator::setInterval ( Double  timeInterval  ) 

Set or reset the time interval (in seconds) to use for iteration.

You should call originChunks() to reset the iteration after calling this.

void casa::ROVisibilityIterator::setRowBlocking ( Int  nRows = 0  ) 

Set the 'blocking' size for returning data.

With the default (0) only a single integration is returned at a time, this is what is currently required for the calibration software. With blocking set, up to nRows can be returned in one go. The chunk size determines the actual maximum.

virtual void casa::ROVisibilityIterator::setSelTable (  )  [protected, virtual]

set the currently selected table

void casa::ROVisibilityIterator::setState (  )  [protected]

set the iteration state

virtual void casa::ROVisibilityIterator::setTileCache (  )  [protected, virtual]

Set the tile cache size....when using slice access if tile cache size is not set memory usage can go wild.

Specifically, the caching scheme is ephemeral and lives for that instance of setting the caching scheme.

If you don't set any then the defaults come into play and caches a few tiles along every axis at the tile you requested...which is a waste when say you know you want to proceed along the row axis for example...and in fact now VisIter just reads one tile (thus the commenting in setTileCache) and lets the OS do the caching rather than than having the table system cache extra tiles.

Vector<Float>& casa::ROVisibilityIterator::sigma ( Vector< Float > &  sig  )  const

Return sigma.

virtual Matrix<Float>& casa::ROVisibilityIterator::sigmaMat ( Matrix< Float > &  sigmat  )  const [virtual]

Return sigma matrix (pol-dep).

void casa::ROVisibilityIterator::slicesToMatrices ( Vector< Matrix< Int > > &  matv,
const Vector< Vector< Slice > > &  slicesv,
const Vector< Int > &  widthsv 
) const

Translate slicesv from the form returned by MSSelection::getChanSlices() to matv as used by setChanAveBounds().

widthsv is the channel averaging width for each _selected_ spw.

void casa::ROVisibilityIterator::slurp (  )  const

Call to use the slurp i/o method for all scalar columns.

This will set the BucketCache cache size to the full column length and cause the full column to be cached in memory, if any value of the column is used. In case of out-of-memory, it will automatically fall-back on the smaller cache size. Slurping the column is to be considered as a work-around for the Table i/o code, which uses BucketCache and performs extremely bad for random access. Slurping is useful when iterating non-sequentially an MS or parts of an MS, it is not tested with multiple MSs.

String casa::ROVisibilityIterator::sourceName (  )  const

Return the current Source Name.

Int casa::ROVisibilityIterator::spectralWindow (  )  const

Return current SpectralWindow.

Vector<Int>& casa::ROVisibilityIterator::stateId ( Vector< Int > &  stateids  )  const

Return the STATE_IDs.

template<class T >
void casa::ROVisibilityIterator::swapyz ( Cube< T > &  out,
const Cube< T > &  in 
) const [inline, protected]

void getCol(const String &colName, Array<Double> &array, Array<Double> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Bool> &array, Vector<Bool> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Int> &array, Vector<Int> &all, Bool resize = False) const; void getCol(const String &colName, Vector<Double> &array, Vector<Double> &all, Bool resize = False) const;

Vector<Double>& casa::ROVisibilityIterator::time ( Vector< Double > &  t  )  const

Return MJD midpoint of interval.

Vector<Double>& casa::ROVisibilityIterator::timeCentroid ( Vector< Double > &  t  )  const

Return MJD centroid of interval.

Vector<Double>& casa::ROVisibilityIterator::timeInterval ( Vector< Double > &  ti  )  const

Return nominal time interval.

void casa::ROVisibilityIterator::update_rowIds (  )  const [protected]

Updates, if necessary, rowIds_p member for the current chunk.

virtual void casa::ROVisibilityIterator::updateSlicer (  )  [protected, virtual]

update the DATA slicer

void casa::ROVisibilityIterator::useImagingWeight ( const VisImagingWeight imWgt  ) 

assign a VisImagingWeight object to this iterator

virtual Vector<RigidVector<Double,3> >& casa::ROVisibilityIterator::uvw ( Vector< RigidVector< Double, 3 > > &  uvwvec  )  const [virtual]

Return u,v and w (in meters).

Matrix<Double>& casa::ROVisibilityIterator::uvwMat ( Matrix< Double > &  uvwmat  )  const
ROVisibilityIterator& casa::ROVisibilityIterator::velInterpolation ( const String &  type  ) 

Select the velocity interpolation scheme.

At present the choice is limited to : nearest and linear, linear is the default. TODO: add cubic, spline and possibly FFT

Matrix<CStokesVector>& casa::ROVisibilityIterator::visibility ( Matrix< CStokesVector > &  vis,
DataColumn  whichOne 
) const

Return the visibility 4-vector of polarizations for each channel.

If the MS doesn't contain all polarizations, it is assumed it contains one or two parallel hand polarizations.

virtual Cube<Complex>& casa::ROVisibilityIterator::visibility ( Cube< Complex > &  vis,
DataColumn  whichOne 
) const [virtual]

Return the visibilities as found in the MS, Cube(npol,nchan,nrow).

IPosition casa::ROVisibilityIterator::visibilityShape (  )  const

Return the shape of the visibility Cube.

Vector<Float>& casa::ROVisibilityIterator::weight ( Vector< Float > &  wt  )  const

Return weight.

virtual Matrix<Float>& casa::ROVisibilityIterator::weightMat ( Matrix< Float > &  wtmat  )  const [virtual]

Returns the nPol_p x curNumRow_p weight matrix.

Cube<Float>& casa::ROVisibilityIterator::weightSpectrum ( Cube< Float > &  wtsp  )  const

Return weightspectrum (a weight for each channel).


Friends And Related Function Documentation

friend class AsyncEnabler [friend]

Definition at line 285 of file VisibilityIterator.h.

friend class asyncio::VLAT [friend]

Definition at line 288 of file VisibilityIterator.h.

friend class ViReadImplAsync [friend]

Definition at line 287 of file VisibilityIterator.h.

friend class VisibilityIteratorReadImpl [friend]

Definition at line 286 of file VisibilityIterator.h.


Member Data Documentation

Definition at line 859 of file VisibilityIterator.h.


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines

Generated on 31 Aug 2016 for casa by  doxygen 1.6.1