casacore
|
#include <MSSource.h>
Public Member Functions | |
MSSource () | |
This constructs an empty MSSource. More... | |
MSSource (const String &tableName, TableOption=Table::Old) | |
These constructors mirror the Table ones with additional checking on validity (verifying that the MSSource will have the required columns and keywords) An exception is thrown if the constructed Table is not a valid MSSource. More... | |
MSSource (const String &tableName, const String &tableDescName, TableOption=Table::Old) | |
MSSource (SetupNewTable &newTab, rownr_t nrrow=0, Bool initialize=False) | |
MSSource (const Table &table) | |
MSSource (const MSSource &other) | |
~MSSource () | |
As with tables, the destructor writes the table if necessary. More... | |
MSSource & | operator= (const MSSource &) |
Assignment operator, reference semantics. More... | |
MSSource | referenceCopy (const String &newTableName, const Block< String > &writableColumns) const |
Make a special copy of this Table which references all columns from this Table except those mentioned; those are empty and writable. More... | |
Public Member Functions inherited from casacore::MSTable< MSSourceEnums > | |
Bool | isColumn (ColEnum which) const |
ColEnum convenience functions More... | |
Bool | isColumnWritable (ColEnum which) const |
check to see if a column is writable More... | |
Bool | isColumnWritable (const String &columnName) const |
Bool | isColumnWritable (uInt columnIndex) const |
Bool | isScalar (ColEnum which) const |
Information about scalar vs array of a column. More... | |
Bool | isArray (ColEnum which) const |
const String & | unit (const String &which) const |
Return the UNIT keyword value associated with the specified column. More... | |
const String & | unit (ColEnum which) const |
Bool | isKeyword (KeyEnum which) const |
check to see if a keyword exists More... | |
Bool | validate () const |
validate self (make sure that this MS is valid) More... | |
Public Member Functions inherited from casacore::Table | |
Table () | |
Create a null Table object (i.e. More... | |
Table (const String &tableName, TableOption=Table::Old, const TSMOption &=TSMOption()) | |
Create a table object for an existing table. More... | |
Table (const String &tableName, const TableLock &lockOptions, TableOption=Table::Old, const TSMOption &=TSMOption()) | |
Table (const String &tableName, const String &tableDescName, TableOption=Table::Old, const TSMOption &=TSMOption()) | |
Table (const String &tableName, const String &tableDescName, const TableLock &lockOptions, TableOption=Table::Old, const TSMOption &=TSMOption()) | |
Table (TableType, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Make a new empty table (plain (scratch) or memory type). More... | |
Table (SetupNewTable &, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Make a table object for a new table, which can thereafter be used for reading and writing. More... | |
Table (SetupNewTable &, TableType, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (SetupNewTable &, TableType, const TableLock &lockOptions, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (SetupNewTable &, TableLock::LockOption, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (SetupNewTable &, const TableLock &lockOptions, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, TableType, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, SetupNewTable &, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, SetupNewTable &, TableType, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, SetupNewTable &, TableType, const TableLock &lockOptions, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, SetupNewTable &, TableLock::LockOption, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (MPI_Comm mpiComm, SetupNewTable &, const TableLock &lockOptions, rownr_t nrrow=0, Bool initialize=False, EndianFormat=Table::AipsrcEndian, const TSMOption &=TSMOption()) | |
Table (const Block< Table > &tables, const Block< String > &subTables=Block< String >(), const String &subDirName=String()) | |
Create a table object as the virtual concatenation of one or more of existing tables. More... | |
Table (const Block< String > &tableNames, const Block< String > &subTables=Block< String >(), TableOption=Table::Old, const TSMOption &=TSMOption(), const String &subDirName=String()) | |
Table (const Block< String > &tableNames, const Block< String > &subTables, const TableLock &lockOptions, TableOption=Table::Old, const TSMOption &=TSMOption()) | |
Table (const Table &) | |
Copy constructor (reference semantics). More... | |
virtual | ~Table () |
The destructor flushes (i.e. More... | |
Table & | operator= (const Table &) |
Assignment (reference semantics). More... | |
Block< String > | getPartNames (Bool recursive=False) const |
Get the names of the tables this table consists of. More... | |
Bool | isSameRoot (const Table &other) const |
Is the root table of this table the same as that of the other one? More... | |
void | closeSubTables () const |
Close all open subtables. More... | |
void | reopenRW () |
Try to reopen the table for read/write access. More... | |
Table::EndianFormat | endianFormat () const |
Get the endian format in which the table is stored. More... | |
const StorageOption & | storageOption () const |
Get the storage option used for the table. More... | |
Bool | isMultiUsed (Bool checkSubTables=False) const |
Is the table used (i.e. More... | |
const TableLock & | lockOptions () const |
Get the locking options. More... | |
Bool | hasLock (FileLocker::LockType=FileLocker::Write) const |
Has this process the read or write lock, thus can the table be read or written safely? More... | |
Bool | hasLock (Bool write) const |
Bool | lock (FileLocker::LockType=FileLocker::Write, uInt nattempts=0) |
Try to lock the table for read or write access (default is write). More... | |
Bool | lock (Bool write, uInt nattempts=0) |
void | unlock () |
Unlock the table. More... | |
Bool | hasDataChanged () |
Determine if column or keyword table data have changed (or is being changed) since the last time this function was called. More... | |
void | flush (Bool fsync=False, Bool recursive=False) |
Flush the table, i.e. More... | |
void | resync () |
Resynchronize the Table object with the table file. More... | |
Bool | isNull () const |
Test if the object is null, i.e. More... | |
void | throwIfNull () const |
Throw an exception if the object is null, i.e. More... | |
void | showStructure (std::ostream &, Bool showDataMans=True, Bool showColumns=True, Bool showSubTables=False, Bool sortColumns=False, Bool cOrder=False) const |
Show the structure of the table. More... | |
void | showKeywords (std::ostream &, Bool showSubTables=False, Bool showTabKey=True, Bool showColKey=False, Int maxVal=25) const |
Show the table and/or column keywords, possibly also of all subtables. More... | |
void | showKeywordSets (std::ostream &, Bool showTabKey, Bool showColKey, Int maxVal) const |
Show the table and/or column keywords of this table. More... | |
Bool | isRootTable () const |
Test if this table is the root table (ie. More... | |
Bool | isWritable () const |
Test if this table is opened as writable. More... | |
Bool | isColumnWritable (const String &columnName) const |
Test if the given column is writable. More... | |
Bool | isColumnWritable (uInt columnIndex) const |
Bool | isColumnStored (const String &columnName) const |
Test if the given column is stored (otherwise it is virtual). More... | |
Bool | isColumnStored (uInt columnIndex) const |
const TableRecord & | keywordSet () const |
Get readonly access to the table keyword set. More... | |
TableRecord & | rwKeywordSet () |
Get read/write access to the table keyword set. More... | |
const TableInfo & | tableInfo () const |
Get access to the TableInfo object. More... | |
TableInfo & | tableInfo () |
void | flushTableInfo () const |
Write the TableInfo object. More... | |
const TableDesc & | tableDesc () const |
Get the table description. More... | |
TableDesc | actualTableDesc () const |
Record | dataManagerInfo () const |
Return all data managers used and the columns served by them. More... | |
const String & | tableName () const |
Get the table name. More... | |
void | rename (const String &newName, TableOption) |
Rename the table and all its subtables. More... | |
void | copy (const String &newName, TableOption, Bool noRows=False) const |
Copy the table and all its subtables. More... | |
void | deepCopy (const String &newName, TableOption, Bool valueCopy=False, EndianFormat=AipsrcEndian, Bool noRows=False) const |
void | deepCopy (const String &newName, const Record &dataManagerInfo, TableOption, Bool valueCopy=False, EndianFormat=AipsrcEndian, Bool noRows=False) const |
void | deepCopy (const String &newName, const Record &dataManagerInfo, const StorageOption &, TableOption, Bool valueCopy=False, EndianFormat=AipsrcEndian, Bool noRows=False) const |
Table | copyToMemoryTable (const String &name, Bool noRows=False) const |
Make a copy of a table to a MemoryTable object. More... | |
TableType | tableType () const |
Get the table type. More... | |
int | tableOption () const |
Get the table option. More... | |
void | markForDelete () |
Mark the table for delete. More... | |
void | unmarkForDelete () |
Unmark the table for delete. More... | |
Bool | isMarkedForDelete () const |
Test if the table is marked for delete. More... | |
rownr_t | nrow () const |
Get the number of rows. More... | |
Bool | canAddRow () const |
Test if it is possible to add a row to this table. More... | |
void | addRow (rownr_t nrrow=1, Bool initialize=False) |
Add one or more rows at the end of the table. More... | |
Bool | canRemoveRow () const |
Test if it is possible to remove a row from this table. More... | |
void | removeRow (rownr_t rownr) |
Remove the given row(s). More... | |
void | removeRow (const RowNumbers &rownrs) |
TableExprNode | key (const String &keywordName) const |
Create a TableExprNode object for a column or for a keyword in the table keyword set. More... | |
TableExprNode | key (const Vector< String > &fieldNames) const |
TableExprNode | col (const String &columnName) const |
TableExprNode | col (const String &columnName, const Vector< String > &fieldNames) const |
TableExprNode | keyCol (const String &name, const Vector< String > &fieldNames) const |
TableExprNode | nodeRownr (rownr_t origin=0) const |
Create a TableExprNode object for the rownumber function. More... | |
TableExprNode | nodeRandom () const |
Create a TableExprNode object for the rand function. More... | |
Table | operator() (const TableExprNode &, rownr_t maxRow=0, rownr_t offset=0) const |
Select rows from a table using an select expression consisting of TableExprNode objects. More... | |
Table | operator() (const RowNumbers &rownrs) const |
Select rows using a vector of row numbers. More... | |
Table | operator() (const Block< Bool > &mask) const |
Select rows using a mask block. More... | |
Table | project (const Block< String > &columnNames) const |
Project the given columns (i.e. More... | |
Table | operator& (const Table &) const |
Do logical operations on a table. More... | |
Table | operator| (const Table &) const |
Union with another table. More... | |
Table | operator- (const Table &) const |
Subtract another table. More... | |
Table | operator^ (const Table &) const |
Xor with another table. More... | |
Table | operator! () const |
Take complement. More... | |
Table | sort (const String &columnName, int=Sort::Ascending, int=Sort::ParSort) const |
Sort a table on one or more columns of scalars. More... | |
Table | sort (const Block< String > &columnNames, int=Sort::Ascending, int=Sort::ParSort) const |
Sort on multiple columns. More... | |
Table | sort (const Block< String > &columnNames, const Block< Int > &sortOrders, int=Sort::ParSort) const |
Sort on multiple columns. More... | |
Table | sort (const Block< String > &columnNames, const Block< CountedPtr< BaseCompare > > &compareObjects, const Block< Int > &sortOrders, int=Sort::ParSort) const |
Sort on multiple columns. More... | |
RowNumbers | rowNumbers () const |
Get a vector of row numbers in the root table of rows in this table. More... | |
RowNumbers | rowNumbers (const Table &that, Bool tryFast=False) const |
Get a vector of row numbers in that table of rows in this table. More... | |
void | addColumn (const ColumnDesc &columnDesc, Bool addToParent=True) |
Add a column to the table. More... | |
void | addColumn (const ColumnDesc &columnDesc, const String &dataManager, Bool byName, Bool addToParent=True) |
Use an existing data manager with the given name or type. More... | |
void | addColumn (const ColumnDesc &columnDesc, const DataManager &dataManager, Bool addToParent=True) |
Use the given data manager (which is a new one). More... | |
void | addColumn (const TableDesc &tableDesc, const DataManager &dataManager, Bool addToParent=True) |
Add a bunch of columns using the given new data manager. More... | |
void | addColumn (const TableDesc &tableDesc, const Record &dataManagerInfo, Bool addToParent=True) |
Bool | canRemoveColumn (const String &columnName) const |
Test if columns can be removed. More... | |
Bool | canRemoveColumn (const Vector< String > &columnNames) const |
void | removeColumn (const String &columnName) |
Remove columns. More... | |
void | removeColumn (const Vector< String > &columnName) |
Bool | canRenameColumn (const String &columnName) const |
Test if a column can be renamed. More... | |
void | renameColumn (const String &newName, const String &oldName) |
Rename a column. More... | |
void | renameHypercolumn (const String &newName, const String &oldName) |
void | getTableKeyword (AipsIO &, Bool openWritable) |
Read a table from AipsIO (for TableKeywords ). More... | |
DataManager * | findDataManager (const String &name, Bool byColumn=False) const |
Find the data manager with the given name or for the given column name. More... | |
Static Public Member Functions | |
static MSTableMaps | initMaps () |
Initialize the statics appropriately. More... | |
Static Public Member Functions inherited from casacore::MSTable< MSSourceEnums > | |
static const String & | columnName (ColEnum which) |
Convert a ColEnum to the actual column name. More... | |
static ColEnum | columnType (const String &name) |
Convert a name to a ColEnum. More... | |
static DataType | columnDataType (ColEnum which) |
return the data type for a given ColEnum More... | |
static const String & | columnStandardComment (ColEnum which) |
return the standard comment for a given ColEnum More... | |
static const String & | columnUnit (ColEnum which) |
return the UNIT string for a given ColEnum More... | |
static const String & | columnMeasureType (ColEnum which) |
return the MEASURE_TYPE string for a given ColEnum More... | |
static void | addColumnToDesc (TableDesc &tabDesc, ColEnum which, Int ndim=-1, const String &refCol="") |
add a column to a TableDesc An exception is thrown for an invalid data type. More... | |
static void | addColumnToDesc (TableDesc &tabDesc, ColEnum which, const IPosition &shape, ColumnDesc::Option option, const String &refCol="") |
add a column to a TableDesc, defining the shape and setting the ColumnDesc option (Fixed, Undefined, Direct) For Measure columns you can define a variable reference column. More... | |
static void | addColumnToDesc (MSTableMaps &, ColEnum which, Int ndim=-1, const String &refCol="") |
static void | addColumnToDesc (MSTableMaps &, ColEnum which, const IPosition &shape, ColumnDesc::Option option, const String &refCol="") |
add a column to a TableDesc, defining the shape and setting the ColumnDesc option (Fixed, Undefined, Direct) For Measure columns you can define a variable reference column. More... | |
static const String & | keywordName (KeyEnum which) |
KeyEnum convenience functions More... | |
static KeyEnum | keywordType (const String &name) |
static DataType | keywordDataType (KeyEnum which) |
static const String & | keywordStandardComment (KeyEnum which) |
static void | addKeyToDesc (TableDesc &, KeyEnum key) |
add a keyword to a TableDesc An exception is thrown for an invalid data type. More... | |
static void | addKeyToDesc (MSTableMaps &, KeyEnum key) |
static Bool | validate (const TableDesc &tabDesc) |
tableDesc convenience functions More... | |
static Bool | validate (const TableRecord &tabKeySet) |
check that the keyword set is valid More... | |
static const TableDesc & | requiredTableDesc () |
return the required table description More... | |
static void | addColumnCompression (TableDesc &td, ColEnum which, Bool autoScale=True, const String &type=String()) |
Add the compress option for the given column to the TableDesc. More... | |
Static Public Member Functions inherited from casacore::Table | |
static ScratchCallback * | setScratchCallback (ScratchCallback *) |
Set the pointer to the ScratchCallback function. More... | |
static Bool | isOpened (const String &tableName) |
Is the table used (i.e. More... | |
static uInt | nAutoLocks () |
Determine the number of locked tables opened with the AutoLock option (Locked table means locked for read and/or write). More... | |
static void | relinquishAutoLocks (Bool all=False) |
Unlock locked tables opened with the AutoLock option. More... | |
static Vector< String > | getLockedTables (FileLocker::LockType=FileLocker::Read, int lockOption=-1) |
Get the names of tables locked in this process. More... | |
static Bool | isNativeDataType (DataType dtype) |
Test if the given data type is native to the table system. More... | |
static String | fileName (const String &tableName) |
Make the table file name. More... | |
static Bool | isReadable (const String &tableName, bool throwIf=False) |
Test if a table with the given name exists and is readable. More... | |
static Bool | isWritable (const String &tableName, bool throwIf=False) |
Test if a table with the given name exists and is writable. More... | |
static Vector< String > | nonWritableFiles (const String &tableName) |
Find the non-writable files in a table. More... | |
Private Attributes | |
Bool | hasBeenDestroyed_p |
required by the need to throw an exception in the destructor More... | |
Additional Inherited Members | |
Public Types inherited from casacore::MSSourceEnums | |
enum | PredefinedColumns { UNDEFINED_COLUMN , CALIBRATION_GROUP , CODE , DIRECTION , INTERVAL , NAME , NUM_LINES , PROPER_MOTION , SOURCE_ID , SPECTRAL_WINDOW_ID , TIME , NUMBER_REQUIRED_COLUMNS , POSITION , PULSAR_ID , REST_FREQUENCY , SOURCE_MODEL , SYSVEL , TRANSITION , NUMBER_PREDEFINED_COLUMNS } |
The Antenna table colums with predefined meaning. More... | |
enum | PredefinedKeywords { UNDEFINED_KEYWORD , NUMBER_PREDEFINED_KEYWORDS } |
Keywords with a predefined meaning. More... | |
Public Types inherited from casacore::MSTable< MSSourceEnums > | |
typedef MSEnum::PredefinedColumns | ColEnum |
Define the column and keyword enuym types. More... | |
typedef MSEnum::PredefinedKeywords | KeyEnum |
Public Types inherited from casacore::Table | |
enum | TableOption { Old , New , NewNoReplace , Scratch , Update , Delete } |
Define the possible options how a table can be opened. More... | |
enum | TableType { Plain , Memory } |
Define the possible table types. More... | |
enum | EndianFormat { BigEndian , LittleEndian , LocalEndian , AipsrcEndian } |
Define the possible endian formats in which table data can be stored. More... | |
typedef void | ScratchCallback(const String &name, Bool isScratch, const String &oldName) |
Define the signature of the function being called when the state of a scratch table changes (i.e. More... | |
Protected Member Functions inherited from casacore::MSTable< MSSourceEnums > | |
MSTable () | |
These constructors mirror the Table ones More... | |
MSTable (const String &tableName, TableOption option) | |
MSTable (const String &tableName, const TableLock &lockOptions, TableOption option) | |
MSTable (const String &tableName, const String &tableDescName, TableOption option) | |
MSTable (const String &tableName, const String &tableDescName, const TableLock &lockOptions, TableOption option) | |
MSTable (SetupNewTable &newTab, rownr_t nrrow, Bool initialize) | |
MSTable (SetupNewTable &newTab, const TableLock &lockOptions, rownr_t nrrow, Bool initialize) | |
MSTable (MPI_Comm comm, SetupNewTable &newTab, rownr_t nrrow, Bool initialize) | |
MSTable (MPI_Comm comm, SetupNewTable &newTab, const TableLock &lockOptions, rownr_t nrrow, Bool initialize) | |
MSTable (const Table &table) | |
MSTable (const MSTable< MSSourceEnums > &other) | |
~MSTable () | |
MSTable & | operator= (const MSTable< MSSourceEnums > &) |
Assignment operator, reference semantics. More... | |
Table | referenceCopy (const String &newTableName, const Block< String > &writableColumns) const |
Return a table that references all columns in this table except for those given in writableColumns, those are empty and writable. More... | |
Static Protected Member Functions inherited from casacore::MSTable< MSSourceEnums > | |
static const String & | columnName (const MSTableMaps &maps, ColEnum which) |
Convert a ColEnum to the actual column name. More... | |
static DataType | columnDataType (const MSTableMaps &maps, ColEnum which) |
static const String & | columnStandardComment (const MSTableMaps &maps, ColEnum which) |
static const String & | columnUnit (const MSTableMaps &maps, ColEnum which) |
static const String & | columnMeasureType (const MSTableMaps &maps, ColEnum which) |
static const String & | keywordName (const MSTableMaps &maps, KeyEnum which) |
static DataType | keywordDataType (const MSTableMaps &maps, KeyEnum which) |
static const String & | keywordStandardComment (const MSTableMaps &maps, KeyEnum which) |
static MSTableMaps & | getMaps () |
Get the static struct containing all column and keyword mappings. More... | |
static void | colMapDef (MSTableMaps &maps, ColEnum col, const String &colName, DataType colType, const String &colComment, const String &colUnit="", const String &colMeasureType="") |
Define an entry in the column maps. More... | |
static void | keyMapDef (MSTableMaps &maps, KeyEnum key, const String &keyName, DataType keyType, const String &keyComment) |
Define an entry in the keyword maps. More... | |
A Table intended to hold a MeasurementSet SOURCE table.
Public interface
MSSource stands for the MeasurementSet Source table.
An MSSource is a table intended to hold the SOURCE table for the MeasurementSet. It has an identical set of member functions as the main MeasurementSet class. For further info and examples see the MeasurementSet class.
See the MeasurementSet for an example of how to access and use this class.
It was found that subtables and the main table of the MeasurementSet have a lot in common, therefore they derive their interface from the same base class. Each subtable has its own class to keep the enum definitions and conversion functions in separate scopes.
Definition at line 77 of file MSSource.h.
casacore::MSSource::MSSource | ( | ) |
This constructs an empty MSSource.
casacore::MSSource::MSSource | ( | const String & | tableName, |
TableOption | = Table::Old |
||
) |
casacore::MSSource::MSSource | ( | const String & | tableName, |
const String & | tableDescName, | ||
TableOption | = Table::Old |
||
) |
casacore::MSSource::MSSource | ( | SetupNewTable & | newTab, |
rownr_t | nrrow = 0 , |
||
Bool | initialize = False |
||
) |
casacore::MSSource::MSSource | ( | const Table & | table | ) |
casacore::MSSource::MSSource | ( | const MSSource & | other | ) |
casacore::MSSource::~MSSource | ( | ) |
As with tables, the destructor writes the table if necessary.
Additional checking is done here to verify that all required columns are still present. If it is NOT valid, it will write the table and then throw an exception.
|
static |
Initialize the statics appropriately.
This does not need to be called by users, it is called by the implementation class MSTableImpl.
Assignment operator, reference semantics.
MSSource casacore::MSSource::referenceCopy | ( | const String & | newTableName, |
const Block< String > & | writableColumns | ||
) | const |
Make a special copy of this Table which references all columns from this Table except those mentioned; those are empty and writable.
Each forwarded column has the same writable status as the underlying column. The mentioned columns all use the AipsIO storage manager. This function is inherited from MSTable and unlikely to be of use, except in the class MeasurementSet (see comment there)..
|
private |
required by the need to throw an exception in the destructor
Definition at line 131 of file MSSource.h.