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

A 3D vector on Earth. More...

#include <MVuvw.h>

Inheritance diagram for casacore::MVuvw:
casacore::MVPosition casacore::MeasValue

Public Member Functions

 MVuvw ()
 Default constructor generates a (0,0,0) uvw. More...
 
 MVuvw (const MVPosition &other)
 Copy constructor. More...
 
 MVuvw (Double in0, Double in1, Double in2)
 Creates a specified vector. More...
 
 MVuvw (Double in0)
 Creates a vector with specified length towards pole. More...
 
 MVuvw (const Quantity &l)
 
 MVuvw (const Quantity &l, Double angle0, Double angle1)
 Creates the uvw from specified (azimuth,elevation) angles and length. More...
 
 MVuvw (const Quantity &l, const Quantity &angle0, const Quantity &angle1)
 Creates the uvw from specified angles and length. More...
 
 MVuvw (const Quantum< Vector< Double > > &angle)
 If not enough angles: pole assumed (if none), or elevation =0 (if 1) More...
 
 MVuvw (const Quantity &l, const Quantum< Vector< Double > > &angle)
 
 MVuvw (const Vector< Double > &other)
 Create from specified length and/or angles and/or uvw. More...
 
 MVuvw (const Vector< Quantity > &other)
 
 MVuvw (const MVBaseline &pos, const MVDirection &dr, Bool ew=False)
 uvw from a baseline and a reference direction (in same frame) More...
 
MVuvwoperator= (const MVuvw &other)
 Copy assignment. More...
 
 ~MVuvw ()
 Destructor. More...
 
Double operator* (const MVuvw &other) const
 Multiplication defined as in-product. More...
 
Bool operator== (const MVuvw &other) const
 Equality comparisons. More...
 
Bool operator!= (const MVuvw &other) const
 
Bool near (const MVuvw &other, Double tol=1e-13) const
 
Bool near (const MVuvw &other, Quantity tol) const
 
Bool nearAbs (const MVuvw &other, Double tol=1e-13) const
 
MVuvw operator- () const
 Addition and subtraction. More...
 
MVuvwoperator+= (const MVuvw &right)
 
MVuvw operator+ (const MVuvw &right) const
 
MVuvwoperator-= (const MVuvw &right)
 
MVuvw operator- (const MVuvw &right) const
 
virtual uInt type () const
 Tell me your type. More...
 
virtual void adjust ()
 Normalise direction aspects by adjusting the length to 1. More...
 
virtual void adjust (Double &res)
 Adjustment with returned factor. More...
 
virtual void readjust (Double res)
 Re-adjust using factor given. More...
 
virtual Double radius ()
 Get radius(i.e. More...
 
Vector< Doubleget () const
 Generate a 3-vector of coordinates (length(m), angles(rad)) More...
 
const Vector< Double > & getValue () const
 Generate a 3-vector of x,y,z in m. More...
 
Quantum< Vector< Double > > getAngle () const
 Generate angle 2-vector (in rad) More...
 
Quantum< Vector< Double > > getAngle (const Unit &unit) const
 and with specified units More...
 
Quantity getLength () const
 Generate the length. More...
 
Quantity getLength (const Unit &unit) const
 and generate it with the specified units More...
 
Double uvwAngle (const MVuvw &other) const
 Get the uvw angle between the directions. More...
 
Quantity uvwAngle (const MVuvw &other, const Unit &unit) const
 
Double separation (const MVuvw &other) const
 Get the angular separation between two directions. More...
 
Quantity separation (const MVuvw &other, const Unit &unit) const
 
MVuvw crossProduct (const MVuvw &other) const
 Produce the cross product. More...
 
virtual void print (ostream &os) const
 Print data. More...
 
virtual MeasValueclone () const
 Clone. More...
 
virtual Vector< DoublegetVector () const
 Get the value in internal units. More...
 
virtual void putVector (const Vector< Double > &in)
 Set the value from internal units (set 0 for empty vector) More...
 
virtual Vector< Quantum< Double > > getRecordValue () const
 Get the internal value as a Vector<Quantity>. More...
 
virtual Vector< Quantum< Double > > getXRecordValue () const
 
virtual Vector< Quantum< Double > > getTMRecordValue () const
 
virtual Bool putValue (const Vector< Quantum< Double > > &in)
 Set the internal value if correct values and dimensions. More...
 
- Public Member Functions inherited from casacore::MVPosition
 MVPosition ()
 Default constructor generates a (0,0,0) position. More...
 
 MVPosition (const MVPosition &other)
 Copy constructor. More...
 
 MVPosition (Double in0, Double in1, Double in2)
 Creates a specified vector. More...
 
 MVPosition (Double in0)
 Creates a vector with specified length towards pole. More...
 
 MVPosition (const Quantity &l)
 
 MVPosition (const Quantity &l, Double angle0, Double angle1)
 Creates the position from specified (azimuth,elevation) angles and length. More...
 
 MVPosition (const Quantity &l, const Quantity &angle0, const Quantity &angle1)
 Creates the position from specified angles and length. More...
 
 MVPosition (const Quantum< Vector< Double > > &angle)
 If not enough angles: pole assumed (if none), or elevation =0 (if 1) More...
 
 MVPosition (const Quantity &l, const Quantum< Vector< Double > > &angle)
 
 MVPosition (const Vector< Double > &other)
 Create from specified length and/or angles and/or position. More...
 
 MVPosition (const Vector< Quantity > &other)
 
MVPositionoperator= (const MVPosition &other)
 Copy assignment. More...
 
virtual ~MVPosition ()
 Destructor. More...
 
Double operator* (const MVPosition &other) const
 Multiplication defined as in-product. More...
 
Bool operator== (const MVPosition &other) const
 Equality comparisons. More...
 
Bool operator!= (const MVPosition &other) const
 
Bool near (const MVPosition &other, Double tol=1e-13) const
 
Bool near (const MVPosition &other, Quantity tol) const
 
Bool nearAbs (const MVPosition &other, Double tol=1e-13) const
 
MVPosition operator- () const
 Addition and subtraction. More...
 
MVPositionoperator+= (const MVPosition &right)
 
MVPosition operator+ (const MVPosition &right) const
 
MVPositionoperator-= (const MVPosition &right)
 
MVPosition operator- (const MVPosition &right) const
 
MVPositionoperator*= (const RotMatrix &right)
 Multiplication with rotation matrix (see also global functions) More...
 
MVPositionoperator*= (Double right)
 Multiplication with constant. More...
 
Doubleoperator() (uInt which)
 Obtain an element. More...
 
const Doubleoperator() (uInt which) const
 
Vector< Doubleget () const
 Generate a 3-vector of coordinates (length(m), angles(rad)) More...
 
const Vector< Double > & getValue () const
 Generate a 3-vector of x,y,z in m. More...
 
Quantum< Vector< Double > > getAngle () const
 Generate angle 2-vector (in rad) More...
 
Quantum< Vector< Double > > getAngle (const Unit &unit) const
 and with specified units More...
 
Double getLong () const
 Get the longitudinal angle (in radians) More...
 
Quantity getLong (const Unit &unit) const
 and with specified units More...
 
Double getLat () const
 Get the latitude angle (rad) More...
 
Quantity getLat (const Unit &unit) const
 and with specified units More...
 
Quantity getLength () const
 Generate the length. More...
 
Quantity getLength (const Unit &unit) const
 and generate it with the specified units More...
 
Double positionAngle (const MVPosition &other) const
 Get the position angle between the directions. More...
 
Quantity positionAngle (const MVPosition &other, const Unit &unit) const
 
Double separation (const MVPosition &other) const
 Get the angular separation between two directions. More...
 
Quantity separation (const MVPosition &other, const Unit &unit) const
 
MVPosition crossProduct (const MVPosition &other) const
 Produce the cross product. More...
 
- Public Member Functions inherited from casacore::MeasValue
void dummy_constr () const
 Each derived class should have at least the following constructors: More...
 
virtual ~MeasValue ()
 Destructor. More...
 
void dummy_operator () const
 The following operators should be present at least. More...
 

Static Public Member Functions

static void assure (const MeasValue &in)
 
- Static Public Member Functions inherited from casacore::MVPosition
static void assure (const MeasValue &in)
 

Additional Inherited Members

- Static Public Attributes inherited from casacore::MVPosition
static const Double loLimit
 Internal limts codes for negative height. More...
 
static const Double hiLimit
 
- Protected Member Functions inherited from casacore::MVPosition
Double getLat (Double ln) const
 Get the latitude assuming length is given. More...
 
- Protected Attributes inherited from casacore::MVPosition
Vector< Doublexyz
 Position vector (in m) More...
 

Detailed Description

A 3D vector on Earth.

Intended use:

Public interface

Review Status

Reviewed By:
UNKNOWN
Date Reviewed:
before2004/08/25
Test programs:
tMuvw

Prerequisite

Etymology

From Measure, Value and uvw

Synopsis

A MVuvw is a 3-vector of uvws in a rectangular frame with internal units of m.
It can be constructed with:

A void adjust(Double) function normalises the vector to a length of 1; a get() returns as a Double 3-vector the length and angles of the uvw vector; a getAngle() returns a Quantum 2-vector, (uInt) returns the indicated element, and getValue returns the vector.
uvws can be added and subtracted.
The multiplication of two uvws produces the in-product.

Example

See Muvw class.

Motivation

To do coordinate transformations

To Do

Definition at line 110 of file MVuvw.h.

Constructor & Destructor Documentation

casacore::MVuvw::MVuvw ( )

Default constructor generates a (0,0,0) uvw.

casacore::MVuvw::MVuvw ( const MVPosition other)

Copy constructor.

casacore::MVuvw::MVuvw ( Double  in0,
Double  in1,
Double  in2 
)

Creates a specified vector.

casacore::MVuvw::MVuvw ( Double  in0)
explicit

Creates a vector with specified length towards pole.

casacore::MVuvw::MVuvw ( const Quantity l)
casacore::MVuvw::MVuvw ( const Quantity l,
Double  angle0,
Double  angle1 
)

Creates the uvw from specified (azimuth,elevation) angles and length.

casacore::MVuvw::MVuvw ( const Quantity l,
const Quantity angle0,
const Quantity angle1 
)

Creates the uvw from specified angles and length.

or uvws

Thrown Exceptions

  • AipsError if quantities not in angle format
casacore::MVuvw::MVuvw ( const Quantum< Vector< Double > > &  angle)

If not enough angles: pole assumed (if none), or elevation =0 (if 1)

casacore::MVuvw::MVuvw ( const Quantity l,
const Quantum< Vector< Double > > &  angle 
)
casacore::MVuvw::MVuvw ( const Vector< Double > &  other)

Create from specified length and/or angles and/or uvw.

casacore::MVuvw::MVuvw ( const Vector< Quantity > &  other)
casacore::MVuvw::MVuvw ( const MVBaseline pos,
const MVDirection dr,
Bool  ew = False 
)

uvw from a baseline and a reference direction (in same frame)

casacore::MVuvw::~MVuvw ( )

Destructor.

Member Function Documentation

virtual void casacore::MVuvw::adjust ( )
virtual

Normalise direction aspects by adjusting the length to 1.

Reimplemented from casacore::MVPosition.

virtual void casacore::MVuvw::adjust ( Double res)
virtual

Adjustment with returned factor.

Reimplemented from casacore::MVPosition.

static void casacore::MVuvw::assure ( const MeasValue in)
static
virtual MeasValue* casacore::MVuvw::clone ( ) const
virtual

Clone.

Reimplemented from casacore::MVPosition.

MVuvw casacore::MVuvw::crossProduct ( const MVuvw other) const

Produce the cross product.

Vector<Double> casacore::MVuvw::get ( ) const

Generate a 3-vector of coordinates (length(m), angles(rad))

Quantum<Vector<Double> > casacore::MVuvw::getAngle ( ) const

Generate angle 2-vector (in rad)

Quantum<Vector<Double> > casacore::MVuvw::getAngle ( const Unit unit) const

and with specified units

Quantity casacore::MVuvw::getLength ( ) const

Generate the length.

Quantity casacore::MVuvw::getLength ( const Unit unit) const

and generate it with the specified units

virtual Vector<Quantum<Double> > casacore::MVuvw::getRecordValue ( ) const
virtual

Get the internal value as a Vector<Quantity>.

Usable in records. The getXRecordValue() gets additional information for records. Note that the Vectors could be empty.

Reimplemented from casacore::MVPosition.

virtual Vector<Quantum<Double> > casacore::MVuvw::getTMRecordValue ( ) const
inlinevirtual

Reimplemented from casacore::MVPosition.

Definition at line 239 of file MVuvw.h.

References getXRecordValue().

const Vector<Double>& casacore::MVuvw::getValue ( ) const

Generate a 3-vector of x,y,z in m.

virtual Vector<Double> casacore::MVuvw::getVector ( ) const
virtual

Get the value in internal units.

Reimplemented from casacore::MVPosition.

virtual Vector<Quantum<Double> > casacore::MVuvw::getXRecordValue ( ) const
virtual

Reimplemented from casacore::MVPosition.

Referenced by getTMRecordValue().

Bool casacore::MVuvw::near ( const MVuvw other,
Double  tol = 1e-13 
) const
Bool casacore::MVuvw::near ( const MVuvw other,
Quantity  tol 
) const
Bool casacore::MVuvw::nearAbs ( const MVuvw other,
Double  tol = 1e-13 
) const
Bool casacore::MVuvw::operator!= ( const MVuvw other) const
Double casacore::MVuvw::operator* ( const MVuvw other) const

Multiplication defined as in-product.

MVuvw casacore::MVuvw::operator+ ( const MVuvw right) const
MVuvw& casacore::MVuvw::operator+= ( const MVuvw right)
MVuvw casacore::MVuvw::operator- ( ) const

Addition and subtraction.

MVuvw casacore::MVuvw::operator- ( const MVuvw right) const
MVuvw& casacore::MVuvw::operator-= ( const MVuvw right)
MVuvw& casacore::MVuvw::operator= ( const MVuvw other)

Copy assignment.

Bool casacore::MVuvw::operator== ( const MVuvw other) const

Equality comparisons.

virtual void casacore::MVuvw::print ( ostream &  os) const
virtual

Print data.

Reimplemented from casacore::MVPosition.

virtual Bool casacore::MVuvw::putValue ( const Vector< Quantum< Double > > &  in)
virtual

Set the internal value if correct values and dimensions.

Reimplemented from casacore::MVPosition.

virtual void casacore::MVuvw::putVector ( const Vector< Double > &  in)
virtual

Set the value from internal units (set 0 for empty vector)

Reimplemented from casacore::MVPosition.

virtual Double casacore::MVuvw::radius ( )
virtual

Get radius(i.e.

length of vector, in m) of uvw

Reimplemented from casacore::MVPosition.

virtual void casacore::MVuvw::readjust ( Double  res)
virtual

Re-adjust using factor given.

Reimplemented from casacore::MVPosition.

Double casacore::MVuvw::separation ( const MVuvw other) const

Get the angular separation between two directions.

Quantity casacore::MVuvw::separation ( const MVuvw other,
const Unit unit 
) const
virtual uInt casacore::MVuvw::type ( ) const
virtual

Tell me your type.

Reimplemented from casacore::MVPosition.

Double casacore::MVuvw::uvwAngle ( const MVuvw other) const

Get the uvw angle between the directions.

I.e. the angle between the direction from one to the pole, and from one to the other.

Quantity casacore::MVuvw::uvwAngle ( const MVuvw other,
const Unit unit 
) const

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