casacore
Modules | Classes

More...

Modules

 MeasUDF_module_internal_classes
 Internal MeasUDF_module classes and functions.
 

Classes

class  casacore::BaseEngine
  More...
 
class  casacore::DirectionEngine
  More...
 
class  casacore::DirectionUDF
  More...
 
class  casacore::DopplerEngine
  More...
 
class  casacore::DopplerUDF
  More...
 
class  casacore::EarthMagneticEngine
  More...
 
class  casacore::EarthMagneticUDF
  More...
 
class  casacore::EpochEngine
  More...
 
class  casacore::EpochUDF
  More...
 
class  casacore::FrequencyEngine
  More...
 
class  casacore::FrequencyUDF
  More...
 
class  casacore::MeasEngine< M >
  More...
 
class  casacore::PositionEngine
  More...
 
class  casacore::PositionUDF
  More...
 
class  casacore::RadialVelocityEngine
  More...
 
class  casacore::RadialVelocityUDF
  More...
 

Detailed Description

TaQL user defined functions handling measures

See below for an overview of the classes in this module.

Prerequisite

Synopsis

This module extends TaQL (the Table Query Language) with functions handling measures. Currently it can handle MDirection, MEpoch, MPosition, MFrequency, MRadialVelocity, MDoppler and MEarthMagnetic.

These functions make it possible to convert one or more measures from one reference type and frame to another. For example, to convert a direction from J2000 to apparent one can specify the direction in J2000 as well as a time and position to define the measure frame like:

calc meas.app ([4h23m32.7, 34d11m54.8], "J2000",
datetime(), "UTC", POSITION) from my.ms/ANTENNA
TableExprNode datetime(const TableExprNode &node)
Functions for date-values.
Definition: ExprNode.h:1497

The above example converts the given J2000 direction to apparent coordinates for the given time (current time is used) and for all positions in the POSITION column in the given ANTENNA table.

As shown in the example an argument of a meas function can be a constant, a table column in a table. or any expression. If a table column is given, it is recognized if the column has a reference type attached to it (using the TableMeasures). In this example it would be recognized that the positions in the POSITION column are given as, say, WGS84.
For constants the reference type can be given in case it differs from the default type. In the example UTC is specified for the time (was not necessary because it is the default).


Note: The meas library will be loaded dynamically by TaQL when such a function is used; Therefore it is important that the library and the other casacore libraries are built shared;
It is also important that the library can be found in the (DY)LD_LIBRARY_PATH;

Motivation

It is very handy to be able to convert measures in tools that deal with various table columns (e.g. TaQL, TablePlot, pyrap).