|
| VirtualTaQLColumn (const String &expr, const String &style=String()) |
| Construct it with the given TaQL expression. More...
|
|
| VirtualTaQLColumn (const Record &spec) |
| Construct it with the given specification. More...
|
|
virtual | ~VirtualTaQLColumn () |
| Destructor is mandatory. More...
|
|
virtual DataManager * | clone () const |
| Clone the engine object. More...
|
|
virtual Record | dataManagerSpec () const |
| Get the data manager specification. More...
|
|
virtual String | dataManagerType () const |
| Return the type name of the engine. More...
|
|
const String & | expression () const |
| Return the TaQL expression used. More...
|
|
virtual void | setShapeColumn (const IPosition &aShape) |
| Set the shape of an array in the column. More...
|
|
virtual void | setMaxLength (uInt maxLength) |
| Set the maximum length of a 'fixed length' string. More...
|
|
virtual int | dataType () const |
| Functions to return column info. More...
|
|
virtual Bool | isWritable () const |
| Test if data can be put into this column. More...
|
|
virtual uInt | ndim (rownr_t rownr) |
| Get the dimensionality of the item in the given row. More...
|
|
virtual IPosition | shape (rownr_t rownr) |
| Get the shape of the item in the given row. More...
|
|
virtual Bool | isShapeDefined (rownr_t rownr) |
| Is the value shape defined in the given row? By default it returns True. More...
|
|
Public Member Functions inherited from casacore::VirtualColumnEngine |
| VirtualColumnEngine () |
| Create the object. More...
|
|
virtual | ~VirtualColumnEngine () |
|
| DataManager () |
| Default constructor. More...
|
|
virtual | ~DataManager () |
|
virtual String | dataManagerName () const |
| Return the name of the data manager. More...
|
|
void | dataManagerInfo (Record &info) const |
| Add SEQNR and SPEC (the DataManagerSpec subrecord) to the info. More...
|
|
virtual Record | getProperties () const |
| Get data manager properties that can be modified. More...
|
|
virtual void | setProperties (const Record &spec) |
| Modify data manager properties given in record fields. More...
|
|
virtual Bool | canReallocateColumns () const |
| Tell if the data manager wants to reallocate the data manager column objects. More...
|
|
virtual DataManagerColumn * | reallocateColumn (DataManagerColumn *column) |
| Reallocate the column object if it is part of this data manager. More...
|
|
uInt | sequenceNr () const |
| Get the (unique) sequence nr of this data manager. More...
|
|
uInt | ncolumn () const |
| Get the nr of columns in this data manager (can be zero). More...
|
|
Bool | asBigEndian () const |
| Have the data to be stored in big or little endian canonical format? More...
|
|
const TSMOption & | tsmOption () const |
| Get the TSM option. More...
|
|
MultiFileBase * | multiFile () |
| Get the MultiFile pointer (can be 0). More...
|
|
String | keywordName (const String &keyword) const |
| Compose a keyword name from the given keyword appended with the sequence number (e.g. More...
|
|
String | fileName () const |
| Compose a unique filename from the table name and sequence number. More...
|
|
ByteIO::OpenOption | fileOption () const |
| Get the AipsIO option of the underlying file. More...
|
|
virtual Bool | isRegular () const |
| Is this a regular storage manager? It is regular if it allows addition of rows and writing data in them. More...
|
|
Table & | table () const |
| Get the table this object is associated with. More...
|
|
virtual void | reopenRW () |
| Reopen the data manager for read/write access. More...
|
|
virtual Bool | canAddColumn () const |
| Does the data manager allow to add columns? (default no) More...
|
|
virtual Bool | canRemoveColumn () const |
| Does the data manager allow to delete columns? (default no) More...
|
|
virtual Bool | canRenameColumn () const |
| Does the data manager allow to rename columns? (default yes) More...
|
|
virtual void | setMaximumCacheSize (uInt nMiB) |
| Set the maximum cache size (in bytes) to be used by a storage manager. More...
|
|
virtual void | showCacheStatistics (std::ostream &) const |
| Show the data manager's IO statistics. More...
|
|
DataManagerColumn * | createScalarColumn (const String &columnName, int dataType, const String &dataTypeId) |
| Create a column in the data manager on behalf of a table column. More...
|
|
DataManagerColumn * | createDirArrColumn (const String &columnName, int dataType, const String &dataTypeId) |
| Create a direct array column. More...
|
|
DataManagerColumn * | createIndArrColumn (const String &columnName, int dataType, const String &dataTypeId) |
| Create an indirect array column. More...
|
|
DataManager * | getClone () const |
| Has the object already been cloned? More...
|
|
void | setClone (DataManager *clone) const |
| Set the pointer to the clone. More...
|
|
Public Member Functions inherited from casacore::DataManagerColumn |
| DataManagerColumn () |
| Create a column. More...
|
|
virtual | ~DataManagerColumn () |
| Frees up the storage. More...
|
|
void | setIsFixedShape (Bool isFixedShape) |
| Set the isFixedShape flag. More...
|
|
Bool | isFixedShape () const |
| Is this a fixed shape column? More...
|
|
virtual String | dataTypeId () const |
| Get the data type id of the column for dataType==TpOther. More...
|
|
void | setFixedShapeColumn (const IPosition &shape) |
| Set the shape of all (fixed-shaped) arrays in the column. More...
|
|
virtual void | setShape (rownr_t rownr, const IPosition &shape) |
| Set the shape of an (variable-shaped) array in the given row. More...
|
|
virtual void | setShapeTiled (rownr_t rownr, const IPosition &shape, const IPosition &tileShape) |
| Set the shape and tile shape of an (variable-shaped) array in the given row. More...
|
|
virtual IPosition | tileShape (rownr_t rownr) |
| Get the tile shape of the item in the given row. More...
|
|
virtual Bool | canChangeShape () const |
| Can the data manager handle chaging the shape of an existing array? Default is no. More...
|
|
ColumnCache & | columnCache () |
| Get access to the ColumnCache object. More...
|
|
const ColumnCache * | columnCachePtr () const |
|
void | get (rownr_t rownr, Bool *dataPtr) |
| Get the scalar value in the given row. More...
|
|
void | get (rownr_t rownr, uChar *dataPtr) |
|
void | get (rownr_t rownr, Short *dataPtr) |
|
void | get (rownr_t rownr, uShort *dataPtr) |
|
void | get (rownr_t rownr, Int *dataPtr) |
|
void | get (rownr_t rownr, uInt *dataPtr) |
|
void | get (rownr_t rownr, Int64 *dataPtr) |
|
void | get (rownr_t rownr, float *dataPtr) |
|
void | get (rownr_t rownr, double *dataPtr) |
|
void | get (rownr_t rownr, Complex *dataPtr) |
|
void | get (rownr_t rownr, DComplex *dataPtr) |
|
void | get (rownr_t rownr, String *dataPtr) |
|
void | get (rownr_t rownr, void *dataPtr) |
| This function is the get for all non-standard data types. More...
|
|
void | put (rownr_t rownr, const Bool *dataPtr) |
| Put the scalar value into the given row. More...
|
|
void | put (rownr_t rownr, const uChar *dataPtr) |
|
void | put (rownr_t rownr, const Short *dataPtr) |
|
void | put (rownr_t rownr, const uShort *dataPtr) |
|
void | put (rownr_t rownr, const Int *dataPtr) |
|
void | put (rownr_t rownr, const uInt *dataPtr) |
|
void | put (rownr_t rownr, const Int64 *dataPtr) |
|
void | put (rownr_t rownr, const float *dataPtr) |
|
void | put (rownr_t rownr, const double *dataPtr) |
|
void | put (rownr_t rownr, const Complex *dataPtr) |
|
void | put (rownr_t rownr, const DComplex *dataPtr) |
|
void | put (rownr_t rownr, const String *dataPtr) |
|
void | put (rownr_t rownr, const void *dataPtr) |
| This function is the put for all non-standard data types. More...
|
|
virtual void | putScalarColumnV (const ArrayBase &dataPtr) |
| Put all scalar values in the column. More...
|
|
virtual void | putScalarColumnCellsV (const RefRows &rownrs, const ArrayBase &dataPtr) |
| Put some scalar values in the column. More...
|
|
virtual void | putArrayV (rownr_t rownr, const ArrayBase &data) |
| Put the array value into the given row. More...
|
|
virtual void | getArrayColumnV (ArrayBase &data) |
| Get all array values in the column. More...
|
|
virtual void | putArrayColumnV (const ArrayBase &data) |
| Put all array values in the column. More...
|
|
virtual void | getArrayColumnCellsV (const RefRows &rownrs, ArrayBase &data) |
| Get some array values in the column. More...
|
|
virtual void | putArrayColumnCellsV (const RefRows &rownrs, const ArrayBase &data) |
| Put some array values in the column. More...
|
|
virtual void | getSliceV (rownr_t rownr, const Slicer &slicer, ArrayBase &data) |
| Get a section of the array in the given row. More...
|
|
virtual void | putSliceV (rownr_t rownr, const Slicer &slicer, const ArrayBase &data) |
| Put into a section of the array in the given row. More...
|
|
virtual void | getColumnSliceV (const Slicer &slicer, ArrayBase &data) |
| Get a section of all arrays in the column. More...
|
|
virtual void | putColumnSliceV (const Slicer &slicer, const ArrayBase &data) |
| Put into a section of all arrays in the column. More...
|
|
virtual void | getColumnSliceCellsV (const RefRows &rownrs, const Slicer &slicer, ArrayBase &data) |
| Get a section of some arrays in the column. More...
|
|
virtual void | putColumnSliceCellsV (const RefRows &rownrs, const Slicer &slicer, const ArrayBase &data) |
| Put into a section of some arrays in the column. More...
|
|
void | throwGet () const |
| Throw an "invalid operation" exception for the default implementation of get. More...
|
|
void | throwPut () const |
| Throw an "invalid operation" exception for the default implementation of put. More...
|
|
void | setColumnName (const String &colName) |
| Set the column name. More...
|
|
const String & | columnName () const |
| Get rhe column name. More...
|
|
|
| VirtualTaQLColumn (const VirtualTaQLColumn &) |
| Copy is not needed and therefore forbidden (so it is made private). More...
|
|
VirtualTaQLColumn & | operator= (const VirtualTaQLColumn &) |
| Assignment is not needed and therefore forbidden (so it is made private). More...
|
|
virtual DataManagerColumn * | makeScalarColumn (const String &columnName, int dataType, const String &) |
| Create the column object for the scalar column in this engine. More...
|
|
virtual DataManagerColumn * | makeIndArrColumn (const String &columnName, int dataType, const String &dataTypeId) |
| Create the column object for the indirect array column in this engine. More...
|
|
virtual void | create64 (rownr_t) |
| Let the engine initialize the object for a new table. More...
|
|
virtual void | prepare () |
| Prepare compiles the expression. More...
|
|
virtual void | getBool (rownr_t rownr, Bool *dataPtr) |
| Get the scalar value in the given row. More...
|
|
virtual void | getuChar (rownr_t rownr, uChar *dataPtr) |
|
virtual void | getShort (rownr_t rownr, Short *dataPtr) |
|
virtual void | getuShort (rownr_t rownr, uShort *dataPtr) |
|
virtual void | getInt (rownr_t rownr, Int *dataPtr) |
|
virtual void | getuInt (rownr_t rownr, uInt *dataPtr) |
|
virtual void | getInt64 (rownr_t rownr, Int64 *dataPtr) |
|
virtual void | getfloat (rownr_t rownr, float *dataPtr) |
|
virtual void | getdouble (rownr_t rownr, double *dataPtr) |
|
virtual void | getComplex (rownr_t rownr, Complex *dataPtr) |
|
virtual void | getDComplex (rownr_t rownr, DComplex *dataPtr) |
|
virtual void | getString (rownr_t rownr, String *dataPtr) |
|
virtual void | getArrayV (rownr_t rownr, ArrayBase &arr) |
| Get the array value in the given row. More...
|
|
void | getResult (rownr_t rownr) |
| Get the array result into itsCurArray. More...
|
|
void | makeCurArray () |
| Make the result cache. More...
|
|
virtual void | getScalarColumnV (ArrayBase &arr) |
| Get functions implemented by means of their DataManagerColumn::getXXBase counterparts, but optimized for constant expressions. More...
|
|
virtual void | getScalarColumnCellsV (const RefRows &rownrs, ArrayBase &arr) |
| Get some scalar values in the column. More...
|
|
void | fillColumnCache () |
| Fill the ColumnCache object with a constant scalar value. More...
|
|
void | fillArray (ArrayBase &data) |
| Fill an array with a constant scalar value. More...
|
|
|
static rownr_t | MAXROWNR32 |
| Define the highest row number that can be represented as signed 32-bit. More...
|
|
void | decrementNcolumn () |
| Decrement number of columns (in case a column is deleted). More...
|
|
void | setEndian (Bool bigEndian) |
| Tell the data manager if big or little endian format is needed. More...
|
|
void | setTsmOption (const TSMOption &tsmOption) |
| Tell the data manager which TSM option to use. More...
|
|
void | setMultiFile (MultiFileBase *mfile) |
| Tell the data manager that MultiFile can be used. More...
|
|
virtual Bool | hasMultiFileSupport () const |
| Does the data manager support use of MultiFile? A derived class has to return True if it can use the MultiFile. More...
|
|
void | throwDataTypeOther (const String &columnName, int dataType) const |
| Throw an exception in case data type is TpOther, because the storage managers (and maybe other data managers) do not support such columns. More...
|
|
Protected Member Functions inherited from casacore::DataManagerColumn |
virtual void | getOther (rownr_t rownr, void *dataPtr) |
| This function is the get for all non-standard data types. More...
|
|
virtual void | putBool (rownr_t rownr, const Bool *dataPtr) |
| Put the scalar value into the given row. More...
|
|
virtual void | putuChar (rownr_t rownr, const uChar *dataPtr) |
|
virtual void | putShort (rownr_t rownr, const Short *dataPtr) |
|
virtual void | putuShort (rownr_t rownr, const uShort *dataPtr) |
|
virtual void | putInt (rownr_t rownr, const Int *dataPtr) |
|
virtual void | putuInt (rownr_t rownr, const uInt *dataPtr) |
|
virtual void | putInt64 (rownr_t rownr, const Int64 *dataPtr) |
|
virtual void | putfloat (rownr_t rownr, const float *dataPtr) |
|
virtual void | putdouble (rownr_t rownr, const double *dataPtr) |
|
virtual void | putComplex (rownr_t rownr, const Complex *dataPtr) |
|
virtual void | putDComplex (rownr_t rownr, const DComplex *dataPtr) |
|
virtual void | putString (rownr_t rownr, const String *dataPtr) |
|
virtual void | putOther (rownr_t rownr, const void *dataPtr) |
| This function is the put for all non-standard data types. More...
|
|
void | getScalarColumnBase (ArrayBase &dataPtr) |
| The default implementations of get and put functions. More...
|
|
void | putScalarColumnBase (const ArrayBase &dataPtr) |
|
void | getScalarColumnCellsBase (const RefRows &rownrs, ArrayBase &dataPtr) |
|
void | putScalarColumnCellsBase (const RefRows &rownrs, const ArrayBase &dataPtr) |
|
void | getArrayColumnBase (ArrayBase &data) |
|
void | putArrayColumnBase (const ArrayBase &data) |
|
void | getArrayColumnCellsBase (const RefRows &rownrs, ArrayBase &data) |
|
void | putArrayColumnCellsBase (const RefRows &rownrs, const ArrayBase &data) |
|
void | getSliceBase (rownr_t rownr, const Slicer &slicer, ArrayBase &data) |
|
void | putSliceBase (rownr_t rownr, const Slicer &slicer, const ArrayBase &data) |
|
void | getColumnSliceBase (const Slicer &slicer, ArrayBase &data) |
|
void | putColumnSliceBase (const Slicer &slicer, const ArrayBase &data) |
|
void | getColumnSliceCellsBase (const RefRows &rownrs, const Slicer &slicer, ArrayBase &data) |
|
void | putColumnSliceCellsBase (const RefRows &rownrs, const Slicer &slicer, const ArrayBase &data) |
|
Virtual scalar column using TaQL.
Review Status
- Reviewed By:
- GvD
- Date Reviewed:
- 2004/07/09
Prerequisite
Synopsis
VirtualTaQLColumn is a virtual column engine to define the contents of a column as a TaQL CALC expression in which possibly other columns are used. It is (of course) only possible to get data from the column; puts cannot be done. See note 199 for a description of TaQL. The TaQL style can be specified (such as 0- or 1-based indexing).
The expression result can be a scalar or array of the basic TaQL data types. The column data type has to be conformant with that TaQL type, thus a column of any integer type has to be used for an integer TaQL result.
Constant expressions are precalculated and cached making the retrieval of e.g. the full column much faster (factor 4).
A possible use for a virtual TaQL column is a column in a MeasurementSet containing a constant value. It could also be used for on-the-fly calculation of J2000 UVW-values or HADEC using an expression such as "derivedmscal.newuvw()"
Caution: One has to be careful with deleting columns; If in an existing table a TaQL expression uses a deleted column, the expression cannot be parsed anymore and the table cannot be opened anymore; In the future the Table System will be made more forgiving;
Example
The following example creates a table with a few columns. One column is virtual and has a random value if Col3 is true. Otherwise it has value 0.
TableDesc td;
td.addColumn (ScalarColumnDesc<DComplex>("Col1"));
td.addColumn (ScalarColumnDesc<Int>("Col2"));
td.addColumn (ScalarColumnDesc<Bool>("Col3"));
td.addColumn (ScalarColumnDesc<Double>("ColVirt"));
newTab.bindColumn("ColVirt", engine);
Table tab(newTab);
Definition at line 97 of file VirtualTaQLColumn.h.