FITSIDItoMS converts a FITS-IDI file to a CASA Measurement Set. More...

#include <FitsIDItoMS.h>

Inheritance diagram for casa::FITSIDItoMS1:

Public Member Functions
	FITSIDItoMS1 (FitsInput &in, const Int &obsType=0, const Bool &initFirstMain=True)
	The only constructor is from a FitsInput.
	~FITSIDItoMS1 ()
Table	oldfullTable (const String &tabName)
	Get the full table, using the supplied arguments to construct the table.
void	fillObsTables ()
	Fill the Observation and ObsLog tables.
void	fillAntennaTable ()
	Read a binary table extension of type ANTENNA and create an antenna table void fillAntennaTable(BinaryTable& bt);.
void	fillFeedTable ()
	fill the Feed table with minimal info needed for synthesis processing
void	fillFieldTable ()
	fill the Field table void fillFieldTable(Int nField);
void	fillSpectralWindowTable ()
	fill the Spectral Window table
void	fixEpochReferences ()
	fix up the EPOCH MEASURE_REFERENCE keywords
void	updateTables (const String &tabName)
	update the Polarization table
const TableDesc &	getDescriptor ()
	Get an appropriate TableDesc (this is the same TableDesc used to construct any Table objects returned by this class.
TableRecord &	getKeywords ()
	Return the Table keywords (this is the same TableRecord used in any Table objects returned by this class.
const Table &	thisRow ()
	Get a Table with a single row, the current row of the FITS table.
const Table &	nextRow ()
	Get a Table with a single row, the next row of the FITS table.
Float	msVersion () const
	Get the version of the archived MS.
Bool	readFitsFile (const String &msFile)
	Read all the data from the FITS file and create the MeasurementSet.
Bool	isfirstMain ()
	is this the first UV_DATA extension
Protected Member Functions
void	getAxisInfo ()
	Read the axis info, throws an exception if required axes are missing.
void	setupMeasurementSet (const String &MSFileName, Bool useTSM=True, Bool mainTbl=False)
	Set up the MeasurementSet, including StorageManagers and fixed columns.
void	fillMSMainTable (const String &MSFileName, Int &nField, Int &nSpW)
	Fill the main table from the Primary group data.
Private Member Functions
void	fillRow ()
	Fill in each row as needed.
void	convertKeywords ()
	Build part of the keywords of the itsCurRowTab.
void	describeColumns ()
	Convert FITS field descriptions to TableColumn descriptions.
void	convertMSKeywords ()
	Convert the MS-specific keywords in the FITS binary table.
Private Attributes
Table	itsCurRowTab
	The scratch table containing the current row.
Vector< Int >	itsNelem
	The number of elements for each column of the BinaryTableExtension.
Vector< Bool >	itsIsArray
	For each column: is it an array?
TableRecord	itsKwSet
	Table keyword set.
TableDesc	itsTableDesc
	Table descriptor for construction.
TableInfo	itsTableInfo
	Table info.
Float	itsVersion
	The MS version.
uInt	itsNrMSKs
	Buffer for storing the MSK's, MS-specific FITS keywords.
Vector< String >	itsMSKC
Vector< String >	itsMSKN
Vector< String >	itsMSKV
Vector< Bool >	itsgotMSK
FitsInput &	infile_p
String	msFile_p
Vector< Int >	nPixel_p
Vector< Int >	corrType_p
Block< Int >	corrIndex_p
Matrix< Int >	corrProduct_p
Vector< String >	coordType_p
Vector< Double >	refVal_p
Vector< Double >	refPix_p
Vector< Double >	delta_p
String	object_p
String	timsys_p
Double	epoch_p
Int	nAnt_p
Vector< Double >	receptorAngle_p
MFrequency::Types	freqsys_p
Double	restfreq_p
LogIO *	itsLog
Int	nIF_p
Double	startTime_p
Double	lastTime_p
Int	itsObsType
MeasurementSet	ms_p
MSColumns *	msc_p
Bool	uv_data_hasWeights_p
Bool	weightKwPresent_p
Bool	weightypKwPresent_p
String	weightyp_p
Matrix< Float >	weightsFromKW_p
Static Private Attributes
static String	array_p
static Double	rdate
static Bool	firstMain
static SimpleOrderedMap< Int, Int >	antIdFromNo

Detailed Description

FITSIDItoMS converts a FITS-IDI file to a CASA Measurement Set.

Intended use:

Public interface

Prerequisite

Etymology

FITSIDItoMS inherits from the FITS BinaryTableExtension class and its primary use is to convert such an object to a CASA Table. This explains it's use but not its name. A better name should be found.

Synopsis

The class starts with an already existing FitsInput object, which should be set at a BinaryTableExtension HDU. Member functions provide a TableDesc appropriate for the FITS data (to help in constructing a CASA Table compatible with the BinaryTableExtension), a Table containing the current row of FITS data and a Table containing the next row of FITS data (which can be used to step through the FitsInput, copying each row using the RowCopier class), and a Table containin the entire FITS binary table from the current row to the end of the table.

Motivation

We need a way to get FITS-IDI data (typically from VLBI observations) into CASA.

Example

Open a FitsInput from a disk file, if the HDU is a BinaryTableExtension, then instantiate a MSBinaryTable object and get the entire table. A fair amount of error checking has been eliminated from this example.

       FitsInput infits("myFITSFile", FITS::Disk);
       switch (infits.hdutype()) {
          case FITS::BinaryTableHDU:
             MSBinaryTable bintab(infits);
             Table tab = bintab.fullTable("myTable");
             break;
       }

There would obviously be other cases to the switch to deal with any other HDUs (e.g. skip them via infits.skip_hdu()). The Table destructor would write "myTable" to disk.

Definition at line 116 of file FitsIDItoMS.h.

Constructor & Destructor Documentation

casa::FITSIDItoMS1::FITSIDItoMS1	(	FitsInput &	in,
		const Int &	obsType = `0`,
		const Bool &	initFirstMain = `True`
	)

The only constructor is from a FitsInput.

casa::FITSIDItoMS1::~FITSIDItoMS1 ( )

Member Function Documentation

void casa::FITSIDItoMS1::convertKeywords ( ) [private]

Build part of the keywords of the itsCurRowTab.

void casa::FITSIDItoMS1::convertMSKeywords ( ) [private]

Convert the MS-specific keywords in the FITS binary table.

void casa::FITSIDItoMS1::describeColumns ( ) [private]

Convert FITS field descriptions to TableColumn descriptions.

void casa::FITSIDItoMS1::fillAntennaTable ( )

Read a binary table extension of type ANTENNA and create an antenna table void fillAntennaTable(BinaryTable& bt);.

void casa::FITSIDItoMS1::fillFeedTable ( )

fill the Feed table with minimal info needed for synthesis processing

void casa::FITSIDItoMS1::fillFieldTable ( )

fill the Field table void fillFieldTable(Int nField);

void casa::FITSIDItoMS1::fillMSMainTable	(	const String &	MSFileName,
		Int &	nField,
		Int &	nSpW
	)		`[protected]`

Fill the main table from the Primary group data.

void casa::FITSIDItoMS1::fillObsTables ( )

Fill the Observation and ObsLog tables.

void casa::FITSIDItoMS1::fillRow ( ) [private]

Fill in each row as needed.

void casa::FITSIDItoMS1::fillSpectralWindowTable ( )

fill the Spectral Window table

void casa::FITSIDItoMS1::fixEpochReferences ( )

fix up the EPOCH MEASURE_REFERENCE keywords

void casa::FITSIDItoMS1::getAxisInfo ( ) [protected]

Read the axis info, throws an exception if required axes are missing.

const TableDesc& casa::FITSIDItoMS1::getDescriptor ( )

Get an appropriate TableDesc (this is the same TableDesc used to construct any Table objects returned by this class.

TableRecord& casa::FITSIDItoMS1::getKeywords ( )

Return the Table keywords (this is the same TableRecord used in any Table objects returned by this class.

Bool casa::FITSIDItoMS1::isfirstMain ( ) [inline]

is this the first UV_DATA extension

Definition at line 199 of file FitsIDItoMS.h.

References firstMain.

Float casa::FITSIDItoMS1::msVersion ( ) const [inline]

Get the version of the archived MS.

Definition at line 190 of file FitsIDItoMS.h.

References itsVersion.

const Table& casa::FITSIDItoMS1::nextRow ( )

Get a Table with a single row, the next row of the FITS table.

The returned Table is a Scratch table. The FITS input is positioned to the next row and the values translated and returned in a Table object.

Table casa::FITSIDItoMS1::oldfullTable ( const String & tabName )

Get the full table, using the supplied arguments to construct the table.

The table will contain all data from the current row to the end of the BinarTableExtension.

Bool casa::FITSIDItoMS1::readFitsFile ( const String & msFile )

Read all the data from the FITS file and create the MeasurementSet.

Throws an exception when it has severe trouble interpreting the FITS file. Returns False if it encounters an unsupported extension.

void casa::FITSIDItoMS1::setupMeasurementSet	(	const String &	MSFileName,
		Bool	useTSM = `True`,
		Bool	mainTbl = `False`
	)		`[protected]`

Set up the MeasurementSet, including StorageManagers and fixed columns.

If useTSM is True, the Tiled Storage Manager will be used to store DATA, FLAG and WEIGHT_SPECTRUM

const Table& casa::FITSIDItoMS1::thisRow ( )

Get a Table with a single row, the current row of the FITS table.

The returned Table is a Scratch table. The standard BinaryTableExtension manipulation functions are available to position the FITS input at the desired location.

void casa::FITSIDItoMS1::updateTables ( const String & tabName )

update the Polarization table