casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | Static Public Member Functions | Private Attributes | List of all members
casacore::DirectionUDF Class Reference

TaQL UDFs for Direction conversions. More...

#include <DirectionUDF.h>

Inheritance diagram for casacore::DirectionUDF:
casacore::UDFBase

Public Types

enum  FuncType {
  DIRECTION,
  DIRCOS,
  HADEC,
  AZEL,
  APP,
  J2000,
  B1950,
  ECLIPTIC,
  GALACTIC,
  SUPERGALACTIC,
  ITRF
}
 Define the possible function types. More...
 
- Public Types inherited from casacore::UDFBase
typedef UDFBaseMakeUDFObject (const String &functionName)
 The signature of a global or static member function creating an object of the UDF. More...
 

Public Member Functions

 DirectionUDF (FuncType, Bool riseSet=False)
 Create for the given function type. More...
 
virtual void setup (const Table &, const TaQLStyle &)
 Setup the object. More...
 
virtual Double getDouble (const TableExprId &id)
 Get the value. More...
 
virtual MArray< DoublegetArrayDouble (const TableExprId &id)
 
virtual MArray< MVTimegetArrayDate (const TableExprId &id)
 
- Public Member Functions inherited from casacore::UDFBase
 UDFBase ()
 Only default constructor is needed. More...
 
virtual ~UDFBase ()
 Destructor. More...
 
virtual Bool getBool (const TableExprId &id)
 Evaluate the function and return the result. More...
 
virtual Int64 getInt (const TableExprId &id)
 
virtual DComplex getDComplex (const TableExprId &id)
 
virtual String getString (const TableExprId &id)
 
virtual TaqlRegex getRegex (const TableExprId &id)
 
virtual MVTime getDate (const TableExprId &id)
 
virtual MArray< BoolgetArrayBool (const TableExprId &id)
 
virtual MArray< Int64getArrayInt (const TableExprId &id)
 
virtual MArray< DComplex > getArrayDComplex (const TableExprId &id)
 
virtual MArray< StringgetArrayString (const TableExprId &id)
 
const StringgetUnit () const
 Get the unit. More...
 
const RecordgetAttributes () const
 Get the attributes. More...
 
void getAggrNodes (vector< TableExprNodeRep * > &aggr)
 Get the nodes in the function operands representing an aggregate function. More...
 
void getColumnNodes (vector< TableExprNodeRep * > &cols)
 Get the nodes in the function operands representing a table column. More...
 
void init (const std::vector< TENShPtr > &arg, const Table &table, const TaQLStyle &)
 Initialize the function object. More...
 
TableExprNodeRep::NodeDataType dataType () const
 Get the data type. More...
 
Int ndim () const
 Get the dimensionality of the results. More...
 
const IPositionshape () const
 Get the result shape if the same for all results. More...
 
Bool isConstant () const
 Tell if the UDF gives a constant result. More...
 
Bool isAggregate () const
 Tell if the UDF is an aggregate function. More...
 
void disableApplySelection ()
 Do not apply the selection. More...
 
void applySelection (const Vector< uInt > &rownrs)
 If needed, let the UDF re-create column objects for a selection of rows. More...
 

Static Public Member Functions

static UDFBasemakeDIR (const String &)
 Function to create an object. More...
 
static UDFBasemakeDIRCOS (const String &)
 
static UDFBasemakeHADEC (const String &)
 
static UDFBasemakeAZEL (const String &)
 
static UDFBasemakeAPP (const String &)
 
static UDFBasemakeJ2000 (const String &)
 
static UDFBasemakeB1950 (const String &)
 
static UDFBasemakeECL (const String &)
 
static UDFBasemakeGAL (const String &)
 
static UDFBasemakeSGAL (const String &)
 
static UDFBasemakeITRF (const String &)
 
static UDFBasemakeRISESET (const String &)
 
- Static Public Member Functions inherited from casacore::UDFBase
static void registerUDF (const String &name, MakeUDFObject *func)
 Register the name and construction function of a UDF (thread-safe). More...
 
static UDFBasecreateUDF (const String &name, const TaQLStyle &style)
 Create a UDF object (thread-safe). More...
 

Private Attributes

DirectionEngine itsEngine
 
EpochEngine itsEpochEngine
 
PositionEngine itsPositionEngine
 
FuncType itsType
 
MDirection::Types itsRefType
 
Bool itsRiseSet
 

Additional Inherited Members

- Protected Member Functions inherited from casacore::UDFBase
std::vector< TENShPtr > & operands ()
 Get the operands. More...
 
void setDataType (TableExprNodeRep::NodeDataType)
 Set the data type. More...
 
void setNDim (Int ndim)
 Set the dimensionality of the results. More...
 
void setShape (const IPosition &shape)
 Set the shape of the results if it is fixed and known. More...
 
void setUnit (const String &unit)
 Set the unit of the result. More...
 
void setAttributes (const Record &attributes)
 Set the attributes of the result. More...
 
void setConstant (Bool isConstant)
 Define if the result is constant (e.g. More...
 
void setAggregate (Bool isAggregate)
 Define if the UDF is an aggregate function (usually used in GROUPBY). More...
 
virtual void recreateColumnObjects (const Vector< uInt > &rownrs)
 Let a derived class recreate its column objects in case a selection has to be applied. More...
 

Detailed Description

TaQL UDFs for Direction conversions.

Intended use:

Public interface

Review Status

Test programs:
tMeas

Prerequisite

Synopsis

DirectionUDF defines UDFs (user defined functions) that can be used in TaQL to convert Measures for directions. Special functions exist to convert to hourangle and azimuth/elevation. In this way such derived values appear to be ordinary TaQL functions.

A function is called like:

meas.dir (toref, dir, time, pos)
meas.dir (toref, dir, time, pos)
For example,
meas.dir ('B1950', [2rad,1rad])
meas.dir ('B1950', [[2rad,1rad], 'J2000'])
meas.dir ('APP', 'MOON', TIME, [[5d12m, 52deg, 11m], 'WGS84'])
meas.dir ('APP', 'MOON', TIME, POSITION)
Or
meas.dir (toref, fromref, dir, pos, time)

All functions have data type double and unit radian.

Motivation

It makes it possible to handle measures in TaQL.

Definition at line 89 of file DirectionUDF.h.

Member Enumeration Documentation

Define the possible function types.

Enumerator
DIRECTION 
DIRCOS 
HADEC 
AZEL 
APP 
J2000 
B1950 
ECLIPTIC 
GALACTIC 
SUPERGALACTIC 
ITRF 

Definition at line 93 of file DirectionUDF.h.

Constructor & Destructor Documentation

casacore::DirectionUDF::DirectionUDF ( FuncType  ,
Bool  riseSet = False 
)
explicit

Create for the given function type.

The Bools tell if rise/set times have to be calculated.

Member Function Documentation

virtual MArray<MVTime> casacore::DirectionUDF::getArrayDate ( const TableExprId id)
virtual

Reimplemented from casacore::UDFBase.

virtual MArray<Double> casacore::DirectionUDF::getArrayDouble ( const TableExprId id)
virtual

Reimplemented from casacore::UDFBase.

virtual Double casacore::DirectionUDF::getDouble ( const TableExprId id)
virtual

Get the value.

Reimplemented from casacore::UDFBase.

static UDFBase* casacore::DirectionUDF::makeAPP ( const String )
static
static UDFBase* casacore::DirectionUDF::makeAZEL ( const String )
static
static UDFBase* casacore::DirectionUDF::makeB1950 ( const String )
static
static UDFBase* casacore::DirectionUDF::makeDIR ( const String )
static

Function to create an object.

static UDFBase* casacore::DirectionUDF::makeDIRCOS ( const String )
static
static UDFBase* casacore::DirectionUDF::makeECL ( const String )
static
static UDFBase* casacore::DirectionUDF::makeGAL ( const String )
static
static UDFBase* casacore::DirectionUDF::makeHADEC ( const String )
static
static UDFBase* casacore::DirectionUDF::makeITRF ( const String )
static
static UDFBase* casacore::DirectionUDF::makeJ2000 ( const String )
static
static UDFBase* casacore::DirectionUDF::makeRISESET ( const String )
static
static UDFBase* casacore::DirectionUDF::makeSGAL ( const String )
static
virtual void casacore::DirectionUDF::setup ( const Table ,
const TaQLStyle  
)
virtual

Setup the object.

Implements casacore::UDFBase.

Member Data Documentation

DirectionEngine casacore::DirectionUDF::itsEngine
private

Definition at line 124 of file DirectionUDF.h.

EpochEngine casacore::DirectionUDF::itsEpochEngine
private

Definition at line 125 of file DirectionUDF.h.

PositionEngine casacore::DirectionUDF::itsPositionEngine
private

Definition at line 126 of file DirectionUDF.h.

MDirection::Types casacore::DirectionUDF::itsRefType
private

Definition at line 128 of file DirectionUDF.h.

Bool casacore::DirectionUDF::itsRiseSet
private

Definition at line 129 of file DirectionUDF.h.

FuncType casacore::DirectionUDF::itsType
private

Definition at line 127 of file DirectionUDF.h.


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