casacore
Public Member Functions | Static Public Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes | Friends | List of all members
casacore::TableExprNode Class Reference

Handle class for a table column expression tree. More...

#include <ExprNode.h>

Public Member Functions

 TableExprNode ()
 
TableExprNode operator+ () const
 Unary operators on numeric TableExprNode's. More...
 
TableExprNode operator- () const
 
TableExprNode operator! () const
 Unary NOT-operator on boolean TableExprNode's. More...
 
TableExprNode operator~ () const
 Unary bitwise negate-operator on integer TableExprNode's. More...
 
TableExprNode in (const TableExprNodeSet &set, const TaQLStyle &=TaQLStyle(0)) const
 
TableExprNode useUnit (const Unit &unit) const
 Use a unit for the given TableExprNode. More...
 
 TableExprNode (const Bool &value)
 Constructors to convert a constant value to a TableExprNode. More...
 
 TableExprNode (const Int64 &value)
 
 TableExprNode (const Int &value)
 
 TableExprNode (const uInt &value)
 
 TableExprNode (const Float &value)
 
 TableExprNode (const Double &value)
 
 TableExprNode (const Complex &value)
 
 TableExprNode (const DComplex &value)
 
 TableExprNode (const String &value)
 
 TableExprNode (const std::string &value)
 
 TableExprNode (const char *)
 
 TableExprNode (const Regex &value)
 
 TableExprNode (const StringDistance &value)
 
 TableExprNode (const TaqlRegex &value)
 
 TableExprNode (const MVTime &value)
 
 TableExprNode (const Array< Bool > &value)
 
 TableExprNode (const Array< uChar > &value)
 
 TableExprNode (const Array< Short > &value)
 
 TableExprNode (const Array< uShort > &value)
 
 TableExprNode (const Array< Int > &value)
 
 TableExprNode (const Array< uInt > &value)
 
 TableExprNode (const Array< Float > &value)
 
 TableExprNode (const Array< Double > &value)
 
 TableExprNode (const Array< Complex > &value)
 
 TableExprNode (const Array< DComplex > &value)
 
 TableExprNode (const Array< String > &value)
 
 TableExprNode (const Array< MVTime > &value)
 
 TableExprNode (TableExprNodeRep *)
 Construct a node from a node representation. More...
 
 TableExprNode (const TableExprNode &)
 copy constructor (reference semantics). More...
 
TableExprNodeoperator= (const TableExprNode &)
 Assignment (reference semantics). More...
 
 ~TableExprNode ()
 The destructor deletes all the underlying TableExprNode objects,. More...
 
Bool isNull () const
 Does the node contain no actual node? More...
 
void applySelection (const Vector< uInt > &rownrs)
 Re-create the column object for a selection of rows. More...
 
const Unitunit () const
 Get the unit of the expression. More...
 
DataType dataType () const
 Get the data type of the expression. More...
 
Bool isScalar () const
 Is the expression a scalar? More...
 
uInt nrow () const
 Get the number of rows in the table associated with this expression. More...
 
Bool isResultDefined (const TableExprId &id) const
 Is the result value defined? Normally it is, but not for a column with an undefined value. More...
 
DataType getColumnDataType () const
 Get the data type for doing a getColumn on the expression. More...
 
Bool checkTableSize (const Table &table, Bool canBeConst) const
 Check if tables used in expression have the same number of rows as the given table. More...
 
void adaptUnit (const Unit &)
 Adapt the unit of the expression to the given unit (if not empty). More...
 

Static Public Member Functions

static TableExprNode newColumnNode (const Table &tab, const String &name, const Vector< String > &fieldNames)
 Create a column node on behalf of the Table class. More...
 
static TableExprNode newKeyConst (const TableRecord &, const Vector< String > &fieldNames)
 Create a TableExprNodeConst for a table keyword (which is handled as a constant). More...
 
static void throwInvDT (const String &message)
 Throw invalid data type exception. More...
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNodeSet &set, const Table &table, const TaQLStyle &=TaQLStyle(0))
 Create function node of the given type with the given arguments. More...
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNode &node)
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNode &node1, const TableExprNode &node2)
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNode &node1, const TableExprNode &node2, const TableExprNode &node3)
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNode &array, const TableExprNodeSet &axes)
 
static TableExprNode newFunctionNode (TableExprFuncNode::FunctionType, const TableExprNode &array, const TableExprNode &node, const TableExprNodeSet &axes)
 
static TableExprNode newUDFNode (const String &name, const TableExprNodeSet &set, const Table &table, const TaQLStyle &=TaQLStyle(0))
 Create a user defined function node. More...
 
static TableExprNode newConeNode (TableExprFuncNode::FunctionType, const TableExprNodeSet &set, uInt origin=0)
 Create cone function node of the given type with the given arguments. More...
 
static TableExprNode newConeNode (TableExprFuncNode::FunctionType, const TableExprNode &node1, const TableExprNode &node2)
 
static TableExprNode newConeNode (TableExprFuncNode::FunctionType, const TableExprNode &node1, const TableExprNode &node2, const TableExprNode &node3)
 
static TableExprNode newRownrNode (const Table &table, uInt origin)
 Create rownumber() function node. More...
 
static TableExprNode newRowidNode (const Table &table)
 Create rowid() function node. More...
 
static TableExprNode newRandomNode (const Table &table)
 Create rand() function node. More...
 
static TableExprNode newArrayPartNode (const TableExprNode &arrayNode, const TableExprNodeSet &indices, const TaQLStyle &=TaQLStyle(0))
 Create ArrayElement node for the given array with the given index. More...
 

Private Member Functions

TableExprNodeRepnewPlus (TableExprNodeRep *right) const
 Construct a new node for the given operation. More...
 
TableExprNodeRepnewMinus (TableExprNodeRep *right) const
 
TableExprNodeRepnewTimes (TableExprNodeRep *right) const
 
TableExprNodeRepnewDivide (TableExprNodeRep *right) const
 
TableExprNodeRepnewModulo (TableExprNodeRep *right) const
 
TableExprNodeRepnewBitAnd (TableExprNodeRep *right) const
 
TableExprNodeRepnewBitOr (TableExprNodeRep *right) const
 
TableExprNodeRepnewBitXor (TableExprNodeRep *right) const
 
TableExprNodeRepnewEQ (TableExprNodeRep *right) const
 
TableExprNodeRepnewNE (TableExprNodeRep *right) const
 
TableExprNodeRepnewGE (TableExprNodeRep *right) const
 
TableExprNodeRepnewGT (TableExprNodeRep *right) const
 
TableExprNodeRepnewIN (TableExprNodeRep *right, const TaQLStyle &) const
 
TableExprNodeRepnewOR (TableExprNodeRep *right) const
 
TableExprNodeRepnewAND (TableExprNodeRep *right) const
 

Static Private Member Functions

static PtrBlock< TableExprNodeRep * > convertBlockTEN (Block< TableExprNode > &nodes)
 convert Block of TableExprNode to PtrBlock of TableExprNodeRep*. More...
 

Private Attributes

TableExprNodeRepnode_p
 The actual (counted referenced) representation of a node. More...
 

Friends

class TableExprNodeRep
 
class TableParse
 
TableExprNode operator+ (const TableExprNode &left, const TableExprNode &right)
 Define all global functions as friends. More...
 
TableExprNode operator- (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator* (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator/ (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator% (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator& (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator| (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator^ (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator== (const TableExprNode &left, const TableExprNode &right)
 Comparison operators. More...
 
TableExprNode operator!= (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator>= (const TableExprNode &left, const TableExprNode &right)
 Not defined for Bool. More...
 
TableExprNode operator> (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator<= (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator< (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode operator&& (const TableExprNode &left, const TableExprNode &right)
 Logical operators to combine boolean TableExprNode's. More...
 
TableExprNode operator|| (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode near (const TableExprNode &left, const TableExprNode &right)
 Functions to return whether a value is "relatively" near another. More...
 
TableExprNode near (const TableExprNode &left, const TableExprNode &right, const TableExprNode &tolerance)
 
TableExprNode nearAbs (const TableExprNode &left, const TableExprNode &right)
 
TableExprNode nearAbs (const TableExprNode &left, const TableExprNode &right, const TableExprNode &tolerance)
 
TableExprNode angdist (const TableExprNode &pos1, const TableExprNode &pos2)
 Angular distance between positions. More...
 
TableExprNode cones (const TableExprNode &sourcePos, const TableExprNode &cones)
 Cone search; test if the position of a source is inside a cone. More...
 
TableExprNode anyCone (const TableExprNode &sourcePos, const TableExprNode &cones)
 The result is always a Bool scalar telling if any cone contains the source. More...
 
TableExprNode findCone (const TableExprNode &sourcePos, const TableExprNode &cones)
 The sourcePos can contain multiple sources. More...
 
TableExprNode cones (const TableExprNode &sourcePos, const TableExprNode &conePos, const TableExprNode &radii)
 Cone search as above. More...
 
TableExprNode anyCone (const TableExprNode &sourcePos, const TableExprNode &conePos, const TableExprNode &radii)
 
TableExprNode findCone (const TableExprNode &sourcePos, const TableExprNode &conePos, const TableExprNode &radii)
 
TableExprNode sin (const TableExprNode &node)
 Transcendental functions that can be applied to essentially all numeric nodes containing scalars or arrays. More...
 
TableExprNode sinh (const TableExprNode &node)
 
TableExprNode cos (const TableExprNode &node)
 
TableExprNode cosh (const TableExprNode &node)
 
TableExprNode exp (const TableExprNode &node)
 
TableExprNode log (const TableExprNode &node)
 
TableExprNode log10 (const TableExprNode &node)
 
TableExprNode pow (const TableExprNode &x, const TableExprNode &exp)
 
TableExprNode square (const TableExprNode &node)
 
TableExprNode cube (const TableExprNode &node)
 
TableExprNode sqrt (const TableExprNode &node)
 
TableExprNode norm (const TableExprNode &node)
 
TableExprNode asin (const TableExprNode &node)
 Transcendental functions applied to to nodes containing scalars or arrays with double values. More...
 
TableExprNode acos (const TableExprNode &node)
 
TableExprNode atan (const TableExprNode &node)
 
TableExprNode atan2 (const TableExprNode &y, const TableExprNode &x)
 
TableExprNode tan (const TableExprNode &node)
 
TableExprNode tanh (const TableExprNode &node)
 
TableExprNode sign (const TableExprNode &node)
 
TableExprNode round (const TableExprNode &node)
 
TableExprNode ceil (const TableExprNode &node)
 
TableExprNode abs (const TableExprNode &node)
 
TableExprNode floor (const TableExprNode &node)
 
TableExprNode fmod (const TableExprNode &x, const TableExprNode &y)
 
TableExprNode strlength (const TableExprNode &node)
 String functions on scalars or arrays. More...
 
TableExprNode upcase (const TableExprNode &node)
 
TableExprNode downcase (const TableExprNode &node)
 
TableExprNode capitalize (const TableExprNode &node)
 
TableExprNode trim (const TableExprNode &node)
 
TableExprNode ltrim (const TableExprNode &node)
 
TableExprNode rtrim (const TableExprNode &node)
 
TableExprNode substr (const TableExprNode &str, const TableExprNode &pos)
 
TableExprNode substr (const TableExprNode &str, const TableExprNode &pos, const TableExprNode &npos)
 
TableExprNode replace (const TableExprNode &str, const TableExprNode &patt)
 
TableExprNode replace (const TableExprNode &str, const TableExprNode &patt, const TableExprNode &repl)
 
TableExprNode regex (const TableExprNode &node)
 Functions for regular expression matching and pattern matching. More...
 
TableExprNode pattern (const TableExprNode &node)
 
TableExprNode sqlpattern (const TableExprNode &node)
 
TableExprNode datetime (const TableExprNode &node)
 Functions for date-values. More...
 
TableExprNode mjdtodate (const TableExprNode &node)
 
TableExprNode mjd (const TableExprNode &node)
 
TableExprNode date (const TableExprNode &node)
 
TableExprNode year (const TableExprNode &node)
 
TableExprNode month (const TableExprNode &node)
 
TableExprNode day (const TableExprNode &node)
 
TableExprNode cmonth (const TableExprNode &node)
 
TableExprNode weekday (const TableExprNode &node)
 
TableExprNode cdow (const TableExprNode &node)
 
TableExprNode ctodt (const TableExprNode &node)
 
TableExprNode cdate (const TableExprNode &node)
 
TableExprNode ctime (const TableExprNode &node)
 
TableExprNode week (const TableExprNode &node)
 
TableExprNode time (const TableExprNode &node)
 
TableExprNode isNaN (const TableExprNode &node)
 Function to test if a scalar or array is NaN (not-a-number). More...
 
TableExprNode isFinite (const TableExprNode &node)
 Function to test if a scalar or array is finite. More...
 
TableExprNode min (const TableExprNode &a, const TableExprNode &b)
 Minimum or maximum of 2 nodes. More...
 
TableExprNode max (const TableExprNode &a, const TableExprNode &b)
 
TableExprNode conj (const TableExprNode &node)
 The complex conjugate of a complex node. More...
 
TableExprNode real (const TableExprNode &node)
 The real part of a complex node. More...
 
TableExprNode imag (const TableExprNode &node)
 The imaginary part of a complex node. More...
 
TableExprNode amplitude (const TableExprNode &node)
 The amplitude (i.e. More...
 
TableExprNode phase (const TableExprNode &node)
 The phase (i.e. More...
 
TableExprNode arg (const TableExprNode &node)
 The arg (i.e. More...
 
TableExprNode formComplex (const TableExprNode &real, const TableExprNode &imag)
 Form a complex number from two Doubles. More...
 
TableExprNode sum (const TableExprNode &array)
 Functions operating on a Double or Complex scalar or array resulting in a scalar with the same data type. More...
 
TableExprNode product (const TableExprNode &array)
 
TableExprNode sumSquare (const TableExprNode &array)
 
TableExprNode min (const TableExprNode &array)
 Functions operating on a Double scalar or array resulting in a Double scalar. More...
 
TableExprNode max (const TableExprNode &array)
 
TableExprNode mean (const TableExprNode &array)
 
TableExprNode variance (const TableExprNode &array)
 
TableExprNode stddev (const TableExprNode &array)
 
TableExprNode avdev (const TableExprNode &array)
 
TableExprNode rms (const TableExprNode &array)
 
TableExprNode median (const TableExprNode &array)
 
TableExprNode fractile (const TableExprNode &array, const TableExprNode &fraction)
 
TableExprNode any (const TableExprNode &array)
 
TableExprNode all (const TableExprNode &array)
 
TableExprNode ntrue (const TableExprNode &array)
 
TableExprNode nfalse (const TableExprNode &array)
 
TableExprNode sums (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 The partial version of the functions above. More...
 
TableExprNode products (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode sumSquares (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode mins (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode maxs (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode means (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode variances (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode stddevs (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode avdevs (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode rmss (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode medians (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode fractiles (const TableExprNode &array, const TableExprNode &fraction, const TableExprNodeSet &collapseAxes)
 
TableExprNode anys (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode alls (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode ntrues (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode nfalses (const TableExprNode &array, const TableExprNodeSet &collapseAxes)
 
TableExprNode runningMin (const TableExprNode &array)
 
TableExprNode runningMax (const TableExprNode &array)
 
TableExprNode runningMean (const TableExprNode &array)
 
TableExprNode runningVariance (const TableExprNode &array)
 
TableExprNode runningStddev (const TableExprNode &array)
 
TableExprNode runningAvdev (const TableExprNode &array)
 
TableExprNode runningRms (const TableExprNode &array)
 
TableExprNode runningMedian (const TableExprNode &array)
 
TableExprNode runningAny (const TableExprNode &array)
 
TableExprNode runningAll (const TableExprNode &array)
 
TableExprNode array (const TableExprNode &values, const TableExprNodeSet &shape)
 Create an array of the given shape and fill it with the values. More...
 
TableExprNode transpose (const TableExprNode &array)
 Transpose all axes of an array. More...
 
TableExprNode transpose (const TableExprNode &array, const TableExprNode &axes)
 Transpose an array by making the given axes the first axes. More...
 
TableExprNode isdefined (const TableExprNode &array)
 Function operating on a field resulting in a bool scalar. More...
 
TableExprNode nelements (const TableExprNode &array)
 Functions operating on any scalar or array resulting in a Double scalar. More...
 
TableExprNode ndim (const TableExprNode &array)
 
TableExprNode shape (const TableExprNode &array)
 Function operating on any scalar or array resulting in a Double array containing the shape. More...
 
TableExprNode iif (const TableExprNode &condition, const TableExprNode &arg1, const TableExprNode &arg2)
 Function resembling the ternary ?: construct in C++. More...
 
TableExprNode operator() (const TableExprNodeSet &indices)
 Slicing in a node containing an array. More...
 
TableExprNode in (const TableExprNode &array, const TaQLStyle &=TaQLStyle(0)) const
 The IN operator to test if a value is contained in an array or set. More...
 
void get (const TableExprId &id, Bool &value) const
 Get a value for this node in the given row. More...
 
void get (const TableExprId &id, Int64 &value) const
 
void get (const TableExprId &id, Double &value) const
 
void get (const TableExprId &id, DComplex &value) const
 
void get (const TableExprId &id, String &value) const
 
void get (const TableExprId &id, TaqlRegex &value) const
 
void get (const TableExprId &id, MVTime &value) const
 
void get (const TableExprId &id, Array< Bool > &value) const
 
void get (const TableExprId &id, Array< Int64 > &value) const
 
void get (const TableExprId &id, Array< Double > &value) const
 
void get (const TableExprId &id, Array< DComplex > &value) const
 
void get (const TableExprId &id, Array< String > &value) const
 
void get (const TableExprId &id, Array< MVTime > &value) const
 
Bool getBool (const TableExprId &id) const
 
Int64 getInt (const TableExprId &id) const
 
Double getDouble (const TableExprId &id) const
 
DComplex getDComplex (const TableExprId &id) const
 
String getString (const TableExprId &id) const
 
Array< BoolgetArrayBool (const TableExprId &id) const
 
Array< Int64getArrayInt (const TableExprId &id) const
 
Array< DoublegetArrayDouble (const TableExprId &id) const
 
Array< DComplex > getArrayDComplex (const TableExprId &id) const
 
Array< StringgetArrayString (const TableExprId &id) const
 
Array< BoolgetBoolAS (const TableExprId &id) const
 Get a value as an array, even it it is a scalar. More...
 
Array< Int64getIntAS (const TableExprId &id) const
 
Array< DoublegetDoubleAS (const TableExprId &id) const
 
Array< DComplex > getDComplexAS (const TableExprId &id) const
 
Array< StringgetStringAS (const TableExprId &id) const
 
Array< BoolgetColumnBool (const Vector< uInt > &rownrs) const
 Get the value of the expression evaluated for the entire column. More...
 
Array< uChargetColumnuChar (const Vector< uInt > &rownrs) const
 
Array< ShortgetColumnShort (const Vector< uInt > &rownrs) const
 
Array< uShortgetColumnuShort (const Vector< uInt > &rownrs) const
 
Array< IntgetColumnInt (const Vector< uInt > &rownrs) const
 
Array< uIntgetColumnuInt (const Vector< uInt > &rownrs) const
 
Array< FloatgetColumnFloat (const Vector< uInt > &rownrs) const
 
Array< DoublegetColumnDouble (const Vector< uInt > &rownrs) const
 
Array< Complex > getColumnComplex (const Vector< uInt > &rownrs) const
 
Array< DComplex > getColumnDComplex (const Vector< uInt > &rownrs) const
 
Array< StringgetColumnString (const Vector< uInt > &rownrs) const
 
void show (ostream &) const
 Show the tree. More...
 
void ranges (Block< TableExprRange > &)
 Convert the tree to a number of range vectors which at least select the same things. More...
 
const Tabletable () const
 Get table. More...
 
const TableExprNodeRepgetNodeRep () const
 returns const pointer to the representation-object of it More...
 
TableExprNodeRepgetRep ()
 returns non-const pointer to the representation-object of it More...
 

Detailed Description

Handle class for a table column expression tree.

Intended use:

Public interface

Review Status

Reviewed By:
UNKNOWN
Date Reviewed:
before2004/08/25

Prerequisite

Etymology

TableExprNode represents a node in the tree reflecting a table select expression.

Synopsis

TableExprNode is the class to store a table select expression, which allows to select rows from the table. The selected rows form a table which is a view of the original table.

TableExprNode is a handle class for the counted referenced class TableExprNodeRep. Classes (like TableExprNodePlusXX) derived from TableExprNodeRep hold the individual nodes in the expression, i.e. the operators and operands. The nodes form a binary tree reflecting the expression. E.g. the expression 2*COLUMN results in the node TableExprNodeTimes with its children TableExprNodeConst and TableExprNodeColumn. Constant subexpressions (like 2*3) are evaluated immediately and only the result is stored as a node.

There are a few TableExprNode constructors taking a constant scalar or array. In this way constant value are automatically converted to the appropriate TableExprNodeConst object.

The derived classes also reflect the data type of the node. Data types Bool, Double, DComplex and String are used. Char, uChar, Short, uShort, Int, uInt and float are converted to Double and Complex to DComplex. Binary operators +, -, *, /, %, &, }, ^, ==, >=, >, <, <= and != are recognized. Also &&, ||, parentheses and unary +, -, ~ and ! are recognized. For strings the binary operator + can also be used. The operators have the normal C++ precedence. Furthermore functions (like sin, max, ceil) can be used in an expression.
Operator() can be used to take a slice from an array.

The Table function col has to be used to create a TableExprNode object for a column in the table. The Table operator() can be used the do the actual selection from the top TableExprNode object.

Example

// Select from table X all rows where column RA<5 and where column
// SWITCH is true.
Table table("X");
Table subtable = table(table.col("RA") < 5 && table.col("SWITCH"));
// Select from that result all rows where the concatenation of
// the strings in columns STR1 and STR2 is equal to the string
// in keyword STRKEY.
Table subsub = subtable(subtable.col("STR1") + subtable.col("STR2")
== subtable.key("STRKEY"));

Motivation

Having TableExprNode as a handle class makes it possible to handle temporary objects created by the compiler in a smooth way. TableExprNode and its derivations allow to store an expression before actually evaluating it. This also allows the classes to be used by the table expression parser defined in TableParse and TableGram.

For each operator a special derived class is implemented. Another approach could have been to store the operator as a flag and switch on that. However, that causes extra overhead and the C++ virtual function mechanism is the designed for these purposes.

To Do

Definition at line 578 of file ExprNode.h.

Constructor & Destructor Documentation

casacore::TableExprNode::TableExprNode ( )
casacore::TableExprNode::TableExprNode ( const Bool value)

Constructors to convert a constant value to a TableExprNode.

The constructor for char* is also supported to convert a character-array to a string, since a two step conversion is not done automatically.

casacore::TableExprNode::TableExprNode ( const Int64 value)
casacore::TableExprNode::TableExprNode ( const Int value)
casacore::TableExprNode::TableExprNode ( const uInt value)
casacore::TableExprNode::TableExprNode ( const Float value)
casacore::TableExprNode::TableExprNode ( const Double value)
casacore::TableExprNode::TableExprNode ( const Complex &  value)
casacore::TableExprNode::TableExprNode ( const DComplex &  value)
casacore::TableExprNode::TableExprNode ( const String value)
casacore::TableExprNode::TableExprNode ( const std::string &  value)
casacore::TableExprNode::TableExprNode ( const char *  )
casacore::TableExprNode::TableExprNode ( const Regex value)
casacore::TableExprNode::TableExprNode ( const StringDistance value)
casacore::TableExprNode::TableExprNode ( const TaqlRegex value)
casacore::TableExprNode::TableExprNode ( const MVTime value)
casacore::TableExprNode::TableExprNode ( const Array< Bool > &  value)
casacore::TableExprNode::TableExprNode ( const Array< uChar > &  value)
casacore::TableExprNode::TableExprNode ( const Array< Short > &  value)
casacore::TableExprNode::TableExprNode ( const Array< uShort > &  value)
casacore::TableExprNode::TableExprNode ( const Array< Int > &  value)
casacore::TableExprNode::TableExprNode ( const Array< uInt > &  value)
casacore::TableExprNode::TableExprNode ( const Array< Float > &  value)
casacore::TableExprNode::TableExprNode ( const Array< Double > &  value)
casacore::TableExprNode::TableExprNode ( const Array< Complex > &  value)
casacore::TableExprNode::TableExprNode ( const Array< DComplex > &  value)
casacore::TableExprNode::TableExprNode ( const Array< String > &  value)
casacore::TableExprNode::TableExprNode ( const Array< MVTime > &  value)
casacore::TableExprNode::TableExprNode ( TableExprNodeRep )

Construct a node from a node representation.

casacore::TableExprNode::TableExprNode ( const TableExprNode )

copy constructor (reference semantics).

casacore::TableExprNode::~TableExprNode ( )

The destructor deletes all the underlying TableExprNode objects,.

Member Function Documentation

void casacore::TableExprNode::adaptUnit ( const Unit )

Adapt the unit of the expression to the given unit (if not empty).

Referenced by isResultDefined().

void casacore::TableExprNode::applySelection ( const Vector< uInt > &  rownrs)
inline

Re-create the column object for a selection of rows.

Nothing is done if the node does not represent a column object.

Definition at line 893 of file ExprNode.h.

References casacore::TableExprNodeRep::applySelection(), and node_p.

Bool casacore::TableExprNode::checkTableSize ( const Table table,
Bool  canBeConst 
) const

Check if tables used in expression have the same number of rows as the given table.

Referenced by isResultDefined().

static PtrBlock<TableExprNodeRep*> casacore::TableExprNode::convertBlockTEN ( Block< TableExprNode > &  nodes)
staticprivate

convert Block of TableExprNode to PtrBlock of TableExprNodeRep*.

Referenced by isResultDefined().

DataType casacore::TableExprNode::dataType ( ) const

Get the data type of the expression.

Currently the only possible values are TpBool, TpInt, TpDouble, TpDComplex, TpString, and TpOther. The latter is returned for a date or regex.

Referenced by unit().

void casacore::TableExprNode::get ( const TableExprId id,
Bool value 
) const
inline

Get a value for this node in the given row.

These functions are implemented in the derived classes and will usually invoke the get in their children and apply the operator on the resulting values.

Definition at line 1135 of file ExprNode.h.

References casacore::TableExprNodeRep::getBool(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Int64 value 
) const
inline

Definition at line 1137 of file ExprNode.h.

References casacore::TableExprNodeRep::getInt(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Double value 
) const
inline

Definition at line 1139 of file ExprNode.h.

References casacore::TableExprNodeRep::getDouble(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
DComplex &  value 
) const
inline

Definition at line 1141 of file ExprNode.h.

References casacore::TableExprNodeRep::getDComplex(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
String value 
) const
inline

Definition at line 1143 of file ExprNode.h.

References casacore::TableExprNodeRep::getString(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
TaqlRegex value 
) const
inline

Definition at line 1145 of file ExprNode.h.

References casacore::TableExprNodeRep::getRegex(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
MVTime value 
) const
inline

Definition at line 1147 of file ExprNode.h.

References casacore::TableExprNodeRep::getDate(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< Bool > &  value 
) const
inline

Definition at line 1149 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayBool(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< Int64 > &  value 
) const
inline

Definition at line 1152 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayInt(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< Double > &  value 
) const
inline

Definition at line 1155 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayDouble(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< DComplex > &  value 
) const
inline

Definition at line 1158 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayDComplex(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< String > &  value 
) const
inline

Definition at line 1161 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayString(), and node_p.

void casacore::TableExprNode::get ( const TableExprId id,
Array< MVTime > &  value 
) const
inline

Definition at line 1164 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayDate(), and node_p.

Array< Bool > casacore::TableExprNode::getArrayBool ( const TableExprId id) const
inline

Definition at line 1177 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayBool(), and node_p.

Referenced by isResultDefined().

Array< DComplex > casacore::TableExprNode::getArrayDComplex ( const TableExprId id) const
inline

Definition at line 1183 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayDComplex(), and node_p.

Referenced by isResultDefined().

Array< Double > casacore::TableExprNode::getArrayDouble ( const TableExprId id) const
inline

Definition at line 1181 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayDouble(), and node_p.

Referenced by isResultDefined().

Array< Int64 > casacore::TableExprNode::getArrayInt ( const TableExprId id) const
inline

Definition at line 1179 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayInt(), and node_p.

Referenced by isResultDefined().

Array< String > casacore::TableExprNode::getArrayString ( const TableExprId id) const
inline

Definition at line 1185 of file ExprNode.h.

References casacore::TableExprNodeRep::getArrayString(), and node_p.

Referenced by isResultDefined().

Bool casacore::TableExprNode::getBool ( const TableExprId id) const
inline

Definition at line 1167 of file ExprNode.h.

References casacore::TableExprNodeRep::getBool(), and node_p.

Referenced by isResultDefined().

Array< Bool > casacore::TableExprNode::getBoolAS ( const TableExprId id) const
inline

Get a value as an array, even it it is a scalar.

This is useful in case one can give an argument as scalar or array.

Definition at line 1187 of file ExprNode.h.

References casacore::TableExprNodeRep::getBoolAS(), and node_p.

Referenced by isResultDefined().

Array< Bool > casacore::TableExprNode::getColumnBool ( const Vector< uInt > &  rownrs) const
inline

Get the value of the expression evaluated for the entire column.

The data of function called should match the data type as returned by function getColumnDataType.

Definition at line 1198 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnBool(), and node_p.

Referenced by isResultDefined().

Array< Complex > casacore::TableExprNode::getColumnComplex ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1214 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnComplex(), and node_p.

Referenced by isResultDefined().

DataType casacore::TableExprNode::getColumnDataType ( ) const

Get the data type for doing a getColumn on the expression.

This is the data type of the column if the expression consists of a single column only. Otherwise it is the expression data type as returned by function dataType.

Referenced by isResultDefined().

Array< DComplex > casacore::TableExprNode::getColumnDComplex ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1216 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnDComplex(), and node_p.

Referenced by isResultDefined().

Array< Double > casacore::TableExprNode::getColumnDouble ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1212 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnDouble(), and node_p.

Referenced by isResultDefined().

Array< Float > casacore::TableExprNode::getColumnFloat ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1210 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnFloat(), and node_p.

Referenced by isResultDefined().

Array< Int > casacore::TableExprNode::getColumnInt ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1206 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnInt(), and node_p.

Referenced by isResultDefined().

Array< Short > casacore::TableExprNode::getColumnShort ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1202 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnShort(), and node_p.

Referenced by isResultDefined().

Array< String > casacore::TableExprNode::getColumnString ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1218 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnString(), and node_p.

Referenced by isResultDefined().

Array< uChar > casacore::TableExprNode::getColumnuChar ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1200 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnuChar(), and node_p.

Referenced by isResultDefined().

Array< uInt > casacore::TableExprNode::getColumnuInt ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1208 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnuInt(), and node_p.

Referenced by isResultDefined().

Array< uShort > casacore::TableExprNode::getColumnuShort ( const Vector< uInt > &  rownrs) const
inline

Definition at line 1204 of file ExprNode.h.

References casacore::TableExprNodeRep::getColumnuShort(), and node_p.

Referenced by isResultDefined().

DComplex casacore::TableExprNode::getDComplex ( const TableExprId id) const
inline

Definition at line 1173 of file ExprNode.h.

References casacore::TableExprNodeRep::getDComplex(), and node_p.

Referenced by isResultDefined().

Array< DComplex > casacore::TableExprNode::getDComplexAS ( const TableExprId id) const
inline

Definition at line 1193 of file ExprNode.h.

References casacore::TableExprNodeRep::getDComplexAS(), and node_p.

Referenced by isResultDefined().

Double casacore::TableExprNode::getDouble ( const TableExprId id) const
inline

Definition at line 1171 of file ExprNode.h.

References casacore::TableExprNodeRep::getDouble(), and node_p.

Referenced by isResultDefined().

Array< Double > casacore::TableExprNode::getDoubleAS ( const TableExprId id) const
inline

Definition at line 1191 of file ExprNode.h.

References casacore::TableExprNodeRep::getDoubleAS(), and node_p.

Referenced by isResultDefined().

Int64 casacore::TableExprNode::getInt ( const TableExprId id) const
inline

Definition at line 1169 of file ExprNode.h.

References casacore::TableExprNodeRep::getInt(), and node_p.

Referenced by isResultDefined().

Array< Int64 > casacore::TableExprNode::getIntAS ( const TableExprId id) const
inline

Definition at line 1189 of file ExprNode.h.

References casacore::TableExprNodeRep::getIntAS(), and node_p.

Referenced by isResultDefined().

const TableExprNodeRep * casacore::TableExprNode::getNodeRep ( ) const
inline

returns const pointer to the representation-object of it

Definition at line 2032 of file ExprNode.h.

References node_p.

Referenced by isResultDefined().

TableExprNodeRep * casacore::TableExprNode::getRep ( )
inlineprivate

returns non-const pointer to the representation-object of it

Definition at line 2036 of file ExprNode.h.

References node_p.

Referenced by isResultDefined().

String casacore::TableExprNode::getString ( const TableExprId id) const
inline

Definition at line 1175 of file ExprNode.h.

References casacore::TableExprNodeRep::getString(), and node_p.

Referenced by isResultDefined().

Array< String > casacore::TableExprNode::getStringAS ( const TableExprId id) const
inline

Definition at line 1195 of file ExprNode.h.

References casacore::TableExprNodeRep::getStringAS(), and node_p.

Referenced by isResultDefined().

TableExprNode casacore::TableExprNode::in ( const TableExprNode array,
const TaQLStyle style = TaQLStyle(0) 
) const
inline

The IN operator to test if a value is contained in an array or set.

The array can also be a scalar.

Definition at line 1292 of file ExprNode.h.

References newIN(), and node_p.

TableExprNode casacore::TableExprNode::in ( const TableExprNodeSet set,
const TaQLStyle = TaQLStyle(0) 
) const
Bool casacore::TableExprNode::isNull ( ) const
inline

Does the node contain no actual node?

Definition at line 888 of file ExprNode.h.

References node_p.

Referenced by casacore::TaQLResult::isTable().

Bool casacore::TableExprNode::isResultDefined ( const TableExprId id) const
inline
Bool casacore::TableExprNode::isScalar ( ) const
inline

Is the expression a scalar?

Definition at line 907 of file ExprNode.h.

References node_p, casacore::TableExprNodeRep::valueType(), and casacore::TableExprNodeRep::VTScalar.

TableExprNodeRep* casacore::TableExprNode::newAND ( TableExprNodeRep right) const
private

Referenced by isResultDefined().

static TableExprNode casacore::TableExprNode::newArrayPartNode ( const TableExprNode arrayNode,
const TableExprNodeSet indices,
const TaQLStyle = TaQLStyle(0) 
)
static

Create ArrayElement node for the given array with the given index.

The origin is 0 for C++ and 1 for TaQL.

Referenced by isResultDefined(), and operator()().

TableExprNodeRep* casacore::TableExprNode::newBitAnd ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newBitOr ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newBitXor ( TableExprNodeRep right) const
private
static TableExprNode casacore::TableExprNode::newColumnNode ( const Table tab,
const String name,
const Vector< String > &  fieldNames 
)
static

Create a column node on behalf of the Table class.

For builtin data types another type of node is created than for other data types. isArray indicates if the column should be an array column.

Referenced by isResultDefined().

static TableExprNode casacore::TableExprNode::newConeNode ( TableExprFuncNode::FunctionType  ,
const TableExprNodeSet set,
uInt  origin = 0 
)
static

Create cone function node of the given type with the given arguments.

Referenced by casacore::anyCone(), casacore::cones(), casacore::findCone(), and isResultDefined().

static TableExprNode casacore::TableExprNode::newConeNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode node1,
const TableExprNode node2 
)
static
static TableExprNode casacore::TableExprNode::newConeNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode node1,
const TableExprNode node2,
const TableExprNode node3 
)
static
TableExprNodeRep* casacore::TableExprNode::newDivide ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newEQ ( TableExprNodeRep right) const
private
static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNodeSet set,
const Table table,
const TaQLStyle = TaQLStyle(0) 
)
static

Create function node of the given type with the given arguments.

Referenced by casacore::abs(), casacore::acos(), casacore::all(), casacore::alls(), casacore::amplitude(), casacore::angdist(), casacore::angdistx(), casacore::any(), casacore::anys(), casacore::arg(), casacore::array(), casacore::asin(), casacore::atan(), casacore::atan2(), casacore::avdev(), casacore::avdevs(), casacore::boxedAll(), casacore::boxedAny(), casacore::boxedAvdev(), casacore::boxedMax(), casacore::boxedMean(), casacore::boxedMedian(), casacore::boxedMin(), casacore::boxedRms(), casacore::boxedStddev(), casacore::boxedVariance(), casacore::capitalize(), casacore::cdate(), casacore::cdow(), casacore::ceil(), casacore::cmonth(), casacore::conj(), casacore::cos(), casacore::cosh(), casacore::ctime(), casacore::ctodt(), casacore::cube(), casacore::date(), casacore::datetime(), casacore::day(), casacore::dms(), casacore::downcase(), casacore::exp(), casacore::floor(), casacore::fmod(), casacore::formComplex(), casacore::fractile(), casacore::fractiles(), casacore::hdms(), casacore::hms(), casacore::iif(), casacore::imag(), casacore::integer(), casacore::isdefined(), casacore::isFinite(), casacore::isInf(), casacore::isNaN(), isResultDefined(), casacore::log(), casacore::log10(), casacore::ltrim(), casacore::max(), casacore::maxs(), casacore::mean(), casacore::means(), casacore::median(), casacore::medians(), casacore::min(), casacore::mins(), casacore::mjd(), casacore::mjdtodate(), casacore::month(), casacore::ndim(), casacore::near(), casacore::nearAbs(), casacore::nelements(), casacore::nfalse(), casacore::nfalses(), casacore::norm(), casacore::ntrue(), casacore::ntrues(), casacore::pattern(), casacore::phase(), casacore::pow(), casacore::product(), casacore::products(), casacore::real(), casacore::regex(), casacore::replace(), casacore::rms(), casacore::rmss(), casacore::round(), casacore::rtrim(), casacore::runningAll(), casacore::runningAny(), casacore::runningAvdev(), casacore::runningMax(), casacore::runningMean(), casacore::runningMedian(), casacore::runningMin(), casacore::runningRms(), casacore::runningStddev(), casacore::runningVariance(), casacore::shape(), casacore::sign(), casacore::sin(), casacore::sinh(), casacore::sqlpattern(), casacore::sqrt(), casacore::square(), casacore::stddev(), casacore::stddevs(), casacore::strlength(), casacore::substr(), casacore::sum(), casacore::sums(), casacore::sumSquare(), casacore::sumSquares(), casacore::tan(), casacore::tanh(), casacore::time(), casacore::toString(), casacore::transpose(), casacore::trim(), casacore::upcase(), casacore::variance(), casacore::variances(), casacore::week(), casacore::weekday(), and casacore::year().

static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode node 
)
static
static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode node1,
const TableExprNode node2 
)
static
static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode node1,
const TableExprNode node2,
const TableExprNode node3 
)
static
static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode array,
const TableExprNodeSet axes 
)
static
static TableExprNode casacore::TableExprNode::newFunctionNode ( TableExprFuncNode::FunctionType  ,
const TableExprNode array,
const TableExprNode node,
const TableExprNodeSet axes 
)
static
TableExprNodeRep* casacore::TableExprNode::newGE ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newGT ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newIN ( TableExprNodeRep right,
const TaQLStyle  
) const
private

Referenced by in(), and isResultDefined().

static TableExprNode casacore::TableExprNode::newKeyConst ( const TableRecord ,
const Vector< String > &  fieldNames 
)
static

Create a TableExprNodeConst for a table keyword (which is handled as a constant).

Referenced by isResultDefined().

TableExprNodeRep* casacore::TableExprNode::newMinus ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newModulo ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newNE ( TableExprNodeRep right) const
private
TableExprNodeRep* casacore::TableExprNode::newOR ( TableExprNodeRep right) const
private

Referenced by isResultDefined().

TableExprNodeRep* casacore::TableExprNode::newPlus ( TableExprNodeRep right) const
private

Construct a new node for the given operation.

Referenced by isResultDefined(), and casacore::operator+().

static TableExprNode casacore::TableExprNode::newRandomNode ( const Table table)
static

Create rand() function node.

Referenced by isResultDefined().

static TableExprNode casacore::TableExprNode::newRowidNode ( const Table table)
static

Create rowid() function node.

Origin is always 0.

Referenced by isResultDefined().

static TableExprNode casacore::TableExprNode::newRownrNode ( const Table table,
uInt  origin 
)
static

Create rownumber() function node.

Origin indicates whether the first row should be zero (for C++ binding) or an other value (one for TaQL binding).

Referenced by isResultDefined().

TableExprNodeRep* casacore::TableExprNode::newTimes ( TableExprNodeRep right) const
private
static TableExprNode casacore::TableExprNode::newUDFNode ( const String name,
const TableExprNodeSet set,
const Table table,
const TaQLStyle = TaQLStyle(0) 
)
static

Create a user defined function node.

Referenced by isResultDefined().

uInt casacore::TableExprNode::nrow ( ) const
inline

Get the number of rows in the table associated with this expression.

One is returned if the expression is a constant. Zero is returned if no table is associated with it.

Definition at line 913 of file ExprNode.h.

References node_p, and casacore::TableExprNodeRep::nrow().

TableExprNode casacore::TableExprNode::operator! ( ) const

Unary NOT-operator on boolean TableExprNode's.

TableExprNode casacore::TableExprNode::operator() ( const TableExprNodeSet indices)
inline

Slicing in a node containing an array.

It is possible to address a single pixel or an n-dimensional subarray. In case of a single pixel the result is a scalar node. Otherwise the result is an array node with the same dimensionality as the source.
Note that there exist TableExprNodeSet constructors to convert an IPosition or Slicer object automatically to a TableExprNodeSet. An IPosition addresses a single element and results in a scalar node, while a Slicer can address multiple elements and always results in an array node.

C++ indexing is 0-based.

Definition at line 1297 of file ExprNode.h.

References newArrayPartNode().

TableExprNode casacore::TableExprNode::operator+ ( ) const

Unary operators on numeric TableExprNode's.

TableExprNode casacore::TableExprNode::operator- ( ) const
TableExprNode& casacore::TableExprNode::operator= ( const TableExprNode )

Assignment (reference semantics).

TableExprNode casacore::TableExprNode::operator~ ( ) const

Unary bitwise negate-operator on integer TableExprNode's.

void casacore::TableExprNode::ranges ( Block< TableExprRange > &  blrange)
inline

Convert the tree to a number of range vectors which at least select the same things.

This function is very useful to convert the expression to some intervals covering the select expression. This can be used to do a rough fast selection via an index and do the the slower final selection on that much smaller subset. The function can only convert direct comparisons of columns with constants (via ==, !=, >, >=, < or <=) and their combinations using && or ||.

Definition at line 1127 of file ExprNode.h.

References node_p, and casacore::TableExprNodeRep::ranges().

Referenced by isResultDefined().

void casacore::TableExprNode::show ( ostream &  os) const
inline

Show the tree.

Definition at line 2028 of file ExprNode.h.

References node_p, and casacore::TableExprNodeRep::show().

Referenced by isResultDefined().

const Table & casacore::TableExprNode::table ( ) const
inline

Get table.

This gets the Table object to which a TableExprNode belongs. A TableExprNode belongs to the Table to which the column(s) used in an expression belong. Note that all columns in an expression have to belong to the same table.

Definition at line 1131 of file ExprNode.h.

References node_p, and casacore::TableExprNodeRep::table().

Referenced by isResultDefined().

static void casacore::TableExprNode::throwInvDT ( const String message)
static

Throw invalid data type exception.

Referenced by isResultDefined().

const Unit& casacore::TableExprNode::unit ( ) const
inline

Get the unit of the expression.

Definition at line 897 of file ExprNode.h.

References dataType(), node_p, and casacore::TableExprNodeRep::unit().

TableExprNode casacore::TableExprNode::useUnit ( const Unit unit) const

Use a unit for the given TableExprNode.

Note that if a column has a unit, it is automatically set. In that case this can be used to convert units.

Friends And Related Function Documentation

TableExprNode abs ( const TableExprNode node)
friend

Definition at line 1458 of file ExprNode.h.

TableExprNode acos ( const TableExprNode node)
friend

Definition at line 1430 of file ExprNode.h.

TableExprNode all ( const TableExprNode array)
friend

Definition at line 1757 of file ExprNode.h.

TableExprNode alls ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1848 of file ExprNode.h.

TableExprNode amplitude ( const TableExprNode node)
friend

The amplitude (i.e.

sqrt(re*re + im*im)) of a complex node. This is a synonym for function abs. Defined for scalars and arrays.

Definition at line 1502 of file ExprNode.h.

TableExprNode angdist ( const TableExprNode pos1,
const TableExprNode pos2 
)
friend

Angular distance between positions.

Both arguments have to be arrays. If both arrays contain 2 values (ra and dec), the result is a scalar. Otherwise the arrays have to contain a multiple of 2 values and the result is a 2-dim array giving the distance of each position in the first array to each position in the second array.

Definition at line 1329 of file ExprNode.h.

TableExprNode any ( const TableExprNode array)
friend

Definition at line 1753 of file ExprNode.h.

TableExprNode anyCone ( const TableExprNode sourcePos,
const TableExprNode cones 
)
friend

The result is always a Bool scalar telling if any cone contains the source.

Definition at line 1347 of file ExprNode.h.

TableExprNode anyCone ( const TableExprNode sourcePos,
const TableExprNode conePos,
const TableExprNode radii 
)
friend

Definition at line 1366 of file ExprNode.h.

TableExprNode anys ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1842 of file ExprNode.h.

TableExprNode arg ( const TableExprNode node)
friend

The arg (i.e.

atan2(im, re)) of a complex node. Defined for scalars and arrays.

Definition at line 1506 of file ExprNode.h.

TableExprNode array ( const TableExprNode values,
const TableExprNodeSet shape 
)
friend

Create an array of the given shape and fill it with the values.

The values array is rewound as needed.

Definition at line 1986 of file ExprNode.h.

TableExprNode asin ( const TableExprNode node)
friend

Transcendental functions applied to to nodes containing scalars or arrays with double values.

They are invalid for Complex nodes.

Definition at line 1434 of file ExprNode.h.

TableExprNode atan ( const TableExprNode node)
friend

Definition at line 1438 of file ExprNode.h.

TableExprNode atan2 ( const TableExprNode y,
const TableExprNode x 
)
friend

Definition at line 1442 of file ExprNode.h.

TableExprNode avdev ( const TableExprNode array)
friend

Definition at line 1732 of file ExprNode.h.

TableExprNode avdevs ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1817 of file ExprNode.h.

TableExprNode capitalize ( const TableExprNode node)
friend

Definition at line 1535 of file ExprNode.h.

TableExprNode cdate ( const TableExprNode node)
friend

Definition at line 1602 of file ExprNode.h.

TableExprNode cdow ( const TableExprNode node)
friend

Definition at line 1594 of file ExprNode.h.

TableExprNode ceil ( const TableExprNode node)
friend

Definition at line 1454 of file ExprNode.h.

TableExprNode cmonth ( const TableExprNode node)
friend

Definition at line 1584 of file ExprNode.h.

TableExprNode cones ( const TableExprNode sourcePos,
const TableExprNode cones 
)
friend

Cone search; test if the position of a source is inside a cone.


Argument sourcePos must be a double array containing two values (ra and dec of source) in radians.
Argument cones must be a double array specifying the position of the cone centers and radii in radians. So the array must contain three values (ra,dec,radius) or a multiple of it.

The result is a bool array telling for each cone if it contains the source. If there is only one cone, the result is a scalar.

Definition at line 1341 of file ExprNode.h.

TableExprNode cones ( const TableExprNode sourcePos,
const TableExprNode conePos,
const TableExprNode radii 
)
friend

Cone search as above.

However, the cone positions and radii are specified separately and (virtually) a larger array containing every combination of position/radius is formed.

Definition at line 1359 of file ExprNode.h.

TableExprNode conj ( const TableExprNode node)
friend

The complex conjugate of a complex node.

Defined for scalars and arrays.

Definition at line 1498 of file ExprNode.h.

TableExprNode cos ( const TableExprNode node)
friend

Definition at line 1380 of file ExprNode.h.

TableExprNode cosh ( const TableExprNode node)
friend

Definition at line 1384 of file ExprNode.h.

TableExprNode ctime ( const TableExprNode node)
friend

Definition at line 1606 of file ExprNode.h.

TableExprNode ctodt ( const TableExprNode node)
friend

Definition at line 1598 of file ExprNode.h.

TableExprNode cube ( const TableExprNode node)
friend

Definition at line 1417 of file ExprNode.h.

TableExprNode date ( const TableExprNode node)
friend

Definition at line 1568 of file ExprNode.h.

TableExprNode datetime ( const TableExprNode node)
friend

Functions for date-values.

Defined for scalars and arrays.

Definition at line 1554 of file ExprNode.h.

TableExprNode day ( const TableExprNode node)
friend

Definition at line 1580 of file ExprNode.h.

TableExprNode downcase ( const TableExprNode node)
friend

Definition at line 1530 of file ExprNode.h.

TableExprNode exp ( const TableExprNode node)
friend

Definition at line 1388 of file ExprNode.h.

TableExprNode findCone ( const TableExprNode sourcePos,
const TableExprNode cones 
)
friend

The sourcePos can contain multiple sources.

The result is a double array giving the index of the first cone containing the corresponding source. If there is one source, the result is a double scalar.

Definition at line 1353 of file ExprNode.h.

TableExprNode findCone ( const TableExprNode sourcePos,
const TableExprNode conePos,
const TableExprNode radii 
)
friend

Definition at line 1373 of file ExprNode.h.

TableExprNode floor ( const TableExprNode node)
friend

Definition at line 1462 of file ExprNode.h.

TableExprNode fmod ( const TableExprNode x,
const TableExprNode y 
)
friend

Definition at line 1466 of file ExprNode.h.

TableExprNode formComplex ( const TableExprNode real,
const TableExprNode imag 
)
friend

Form a complex number from two Doubles.

One or both arguments can be scalar or array.

Definition at line 1514 of file ExprNode.h.

TableExprNode fractile ( const TableExprNode array,
const TableExprNode fraction 
)
friend

Definition at line 1747 of file ExprNode.h.

TableExprNode fractiles ( const TableExprNode array,
const TableExprNode fraction,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1835 of file ExprNode.h.

TableExprNode iif ( const TableExprNode condition,
const TableExprNode arg1,
const TableExprNode arg2 
)
friend

Function resembling the ternary ?: construct in C++.

The argument "condition" has to be a Bool value. If an element in "condition" is True, the corresponding element from "arg1" is taken, otherwise it is taken from "arg2". The arguments can be scalars or array or any combination.

Definition at line 2019 of file ExprNode.h.

TableExprNode imag ( const TableExprNode node)
friend

The imaginary part of a complex node.

Defined for scalars and arrays.

Definition at line 1490 of file ExprNode.h.

TableExprNode isdefined ( const TableExprNode array)
friend

Function operating on a field resulting in a bool scalar.

It can be used to test if a column has an array in the current row. It can also be used to test if a record contains a field.

Definition at line 2003 of file ExprNode.h.

TableExprNode isFinite ( const TableExprNode node)
friend

Function to test if a scalar or array is finite.

It results in a Bool scalar or array.

Definition at line 1687 of file ExprNode.h.

TableExprNode isNaN ( const TableExprNode node)
friend

Function to test if a scalar or array is NaN (not-a-number).

It results in a Bool scalar or array.

Definition at line 1679 of file ExprNode.h.

TableExprNode log ( const TableExprNode node)
friend

Definition at line 1392 of file ExprNode.h.

TableExprNode log10 ( const TableExprNode node)
friend

Definition at line 1396 of file ExprNode.h.

TableExprNode ltrim ( const TableExprNode node)
friend

Definition at line 1645 of file ExprNode.h.

TableExprNode max ( const TableExprNode a,
const TableExprNode b 
)
friend

Definition at line 1482 of file ExprNode.h.

TableExprNode max ( const TableExprNode array)
friend

Definition at line 1697 of file ExprNode.h.

TableExprNode maxs ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1793 of file ExprNode.h.

TableExprNode mean ( const TableExprNode array)
friend

Definition at line 1717 of file ExprNode.h.

TableExprNode means ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1799 of file ExprNode.h.

TableExprNode median ( const TableExprNode array)
friend

Definition at line 1742 of file ExprNode.h.

TableExprNode medians ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1829 of file ExprNode.h.

TableExprNode min ( const TableExprNode a,
const TableExprNode b 
)
friend

Minimum or maximum of 2 nodes.

Makes sense for numeric and String values. For Complex values the norm is compared. One or both arguments can be scalar or array.

Definition at line 1478 of file ExprNode.h.

TableExprNode min ( const TableExprNode array)
friend

Functions operating on a Double scalar or array resulting in a Double scalar.

Definition at line 1692 of file ExprNode.h.

TableExprNode mins ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1787 of file ExprNode.h.

TableExprNode mjd ( const TableExprNode node)
friend

Definition at line 1564 of file ExprNode.h.

TableExprNode mjdtodate ( const TableExprNode node)
friend

Definition at line 1559 of file ExprNode.h.

TableExprNode month ( const TableExprNode node)
friend

Definition at line 1576 of file ExprNode.h.

TableExprNode ndim ( const TableExprNode array)
friend

Definition at line 2011 of file ExprNode.h.

TableExprNode near ( const TableExprNode left,
const TableExprNode right 
)
friend

Functions to return whether a value is "relatively" near another.

Returns tol > abs(val2 - val1)/max(abs(val1),(val2)). If tol <= 0, returns val1 == val2. If either val is 0.0, takes care of area around the minimum number that can be represented.
The nearAbs functions return whether a value is "absolutely" near another. Returns tol > abs(val2 - val1). Default tolerance is 1.0e-13. They operate on scalars and arrays.

Definition at line 1303 of file ExprNode.h.

TableExprNode near ( const TableExprNode left,
const TableExprNode right,
const TableExprNode tolerance 
)
friend

Definition at line 1309 of file ExprNode.h.

TableExprNode nearAbs ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1316 of file ExprNode.h.

TableExprNode nearAbs ( const TableExprNode left,
const TableExprNode right,
const TableExprNode tolerance 
)
friend

Definition at line 1322 of file ExprNode.h.

TableExprNode nelements ( const TableExprNode array)
friend

Functions operating on any scalar or array resulting in a Double scalar.

A scalar has 1 element and dimensionality 0.

Definition at line 2007 of file ExprNode.h.

TableExprNode nfalse ( const TableExprNode array)
friend

Definition at line 1765 of file ExprNode.h.

TableExprNode nfalses ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1860 of file ExprNode.h.

TableExprNode norm ( const TableExprNode node)
friend

Definition at line 1426 of file ExprNode.h.

TableExprNode ntrue ( const TableExprNode array)
friend

Definition at line 1761 of file ExprNode.h.

TableExprNode ntrues ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1854 of file ExprNode.h.

TableExprNode operator!= ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1267 of file ExprNode.h.

TableExprNode operator% ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1242 of file ExprNode.h.

TableExprNode operator& ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1247 of file ExprNode.h.

TableExprNode operator&& ( const TableExprNode left,
const TableExprNode right 
)
friend

Logical operators to combine boolean TableExprNode's.

A null TableExprNode object is ignored, so it is possible to build up a full expression gradually.

TableExprNode operator* ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1232 of file ExprNode.h.

TableExprNode operator+ ( const TableExprNode left,
const TableExprNode right 
)
friend

Define all global functions as friends.

Arithmetic operators for numeric TableExprNode's.

  • is also defined for strings (means concatenation).

Definition at line 1222 of file ExprNode.h.

TableExprNode operator- ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1227 of file ExprNode.h.

TableExprNode operator/ ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1237 of file ExprNode.h.

TableExprNode operator< ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1287 of file ExprNode.h.

TableExprNode operator<= ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1282 of file ExprNode.h.

TableExprNode operator== ( const TableExprNode left,
const TableExprNode right 
)
friend

Comparison operators.

Definition at line 1262 of file ExprNode.h.

TableExprNode operator> ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1272 of file ExprNode.h.

TableExprNode operator>= ( const TableExprNode left,
const TableExprNode right 
)
friend

Not defined for Bool.

Definition at line 1277 of file ExprNode.h.

TableExprNode operator^ ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1257 of file ExprNode.h.

TableExprNode operator| ( const TableExprNode left,
const TableExprNode right 
)
friend

Definition at line 1252 of file ExprNode.h.

TableExprNode operator|| ( const TableExprNode left,
const TableExprNode right 
)
friend
TableExprNode pattern ( const TableExprNode node)
friend

Definition at line 1544 of file ExprNode.h.

TableExprNode phase ( const TableExprNode node)
friend

The phase (i.e.

atan2(im, re)) of a complex node. This is a synonym for function arg. Defined for scalars and arrays.

Definition at line 1510 of file ExprNode.h.

TableExprNode pow ( const TableExprNode x,
const TableExprNode exp 
)
friend

Definition at line 1400 of file ExprNode.h.

TableExprNode product ( const TableExprNode array)
friend

Definition at line 1707 of file ExprNode.h.

TableExprNode products ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1775 of file ExprNode.h.

TableExprNode real ( const TableExprNode node)
friend

The real part of a complex node.

Defined for scalars and arrays.

Definition at line 1486 of file ExprNode.h.

TableExprNode regex ( const TableExprNode node)
friend

Functions for regular expression matching and pattern matching.

Defined for scalars and arrays.
pattern is for a file name like pattern.
sqlpattern is for an SQL like pattern.

Definition at line 1540 of file ExprNode.h.

TableExprNode replace ( const TableExprNode str,
const TableExprNode patt 
)
friend

Definition at line 1666 of file ExprNode.h.

TableExprNode replace ( const TableExprNode str,
const TableExprNode patt,
const TableExprNode repl 
)
friend

Definition at line 1672 of file ExprNode.h.

TableExprNode rms ( const TableExprNode array)
friend

Definition at line 1737 of file ExprNode.h.

TableExprNode rmss ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1823 of file ExprNode.h.

TableExprNode round ( const TableExprNode node)
friend

Definition at line 1450 of file ExprNode.h.

TableExprNode rtrim ( const TableExprNode node)
friend

Definition at line 1649 of file ExprNode.h.

TableExprNode runningAll ( const TableExprNode array)
friend
TableExprNode runningAny ( const TableExprNode array)
friend
TableExprNode runningAvdev ( const TableExprNode array)
friend
TableExprNode runningMax ( const TableExprNode array)
friend
TableExprNode runningMean ( const TableExprNode array)
friend
TableExprNode runningMedian ( const TableExprNode array)
friend
TableExprNode runningMin ( const TableExprNode array)
friend
TableExprNode runningRms ( const TableExprNode array)
friend
TableExprNode runningStddev ( const TableExprNode array)
friend
TableExprNode runningVariance ( const TableExprNode array)
friend
TableExprNode shape ( const TableExprNode array)
friend

Function operating on any scalar or array resulting in a Double array containing the shape.

A scalar has shape [1].

Definition at line 2015 of file ExprNode.h.

TableExprNode sign ( const TableExprNode node)
friend

Definition at line 1446 of file ExprNode.h.

TableExprNode sin ( const TableExprNode node)
friend

Transcendental functions that can be applied to essentially all numeric nodes containing scalars or arrays.

Definition at line 1404 of file ExprNode.h.

TableExprNode sinh ( const TableExprNode node)
friend

Definition at line 1408 of file ExprNode.h.

TableExprNode sqlpattern ( const TableExprNode node)
friend

Definition at line 1549 of file ExprNode.h.

TableExprNode sqrt ( const TableExprNode node)
friend

Definition at line 1422 of file ExprNode.h.

TableExprNode square ( const TableExprNode node)
friend

Definition at line 1412 of file ExprNode.h.

TableExprNode stddev ( const TableExprNode array)
friend

Definition at line 1727 of file ExprNode.h.

TableExprNode stddevs ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1811 of file ExprNode.h.

TableExprNode strlength ( const TableExprNode node)
friend

String functions on scalars or arrays.

Definition at line 1520 of file ExprNode.h.

TableExprNode substr ( const TableExprNode str,
const TableExprNode pos 
)
friend

Definition at line 1653 of file ExprNode.h.

TableExprNode substr ( const TableExprNode str,
const TableExprNode pos,
const TableExprNode npos 
)
friend

Definition at line 1659 of file ExprNode.h.

TableExprNode sum ( const TableExprNode array)
friend

Functions operating on a Double or Complex scalar or array resulting in a scalar with the same data type.

Definition at line 1702 of file ExprNode.h.

TableExprNode sums ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

The partial version of the functions above.

They are applied to the array subsets defined by the axes in the set using the partialXXX functions in ArrayMath. The axes must be 0-relative.

Definition at line 1769 of file ExprNode.h.

TableExprNode sumSquare ( const TableExprNode array)
friend

Definition at line 1712 of file ExprNode.h.

TableExprNode sumSquares ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1781 of file ExprNode.h.

friend class TableExprNodeRep
friend

Definition at line 581 of file ExprNode.h.

friend class TableParse
friend

Definition at line 582 of file ExprNode.h.

TableExprNode tan ( const TableExprNode node)
friend

Definition at line 1470 of file ExprNode.h.

TableExprNode tanh ( const TableExprNode node)
friend

Definition at line 1474 of file ExprNode.h.

TableExprNode time ( const TableExprNode node)
friend

Definition at line 1637 of file ExprNode.h.

TableExprNode transpose ( const TableExprNode array)
friend

Transpose all axes of an array.

Definition at line 1992 of file ExprNode.h.

TableExprNode transpose ( const TableExprNode array,
const TableExprNode axes 
)
friend

Transpose an array by making the given axes the first axes.

TableExprNode trim ( const TableExprNode node)
friend

Definition at line 1641 of file ExprNode.h.

TableExprNode upcase ( const TableExprNode node)
friend

Definition at line 1525 of file ExprNode.h.

TableExprNode variance ( const TableExprNode array)
friend

Definition at line 1722 of file ExprNode.h.

TableExprNode variances ( const TableExprNode array,
const TableExprNodeSet collapseAxes 
)
friend

Definition at line 1805 of file ExprNode.h.

TableExprNode week ( const TableExprNode node)
friend

Definition at line 1633 of file ExprNode.h.

TableExprNode weekday ( const TableExprNode node)
friend

Definition at line 1589 of file ExprNode.h.

TableExprNode year ( const TableExprNode node)
friend

Definition at line 1572 of file ExprNode.h.

Member Data Documentation

TableExprNodeRep* casacore::TableExprNode::node_p
private

The documentation for this class was generated from the following file: