A 3D vector on Earth. More...

#include <MVuvw.h>

Inheritance diagram for casa::MVuvw:

Public Member Functions
	MVuvw ()
	Default constructor generates a (0,0,0) uvw.
	MVuvw (const MVPosition &other)
	Copy constructor.
	MVuvw (Double in0, Double in1, Double in2)
	Creates a specified vector.
	MVuvw (Double in0)
	Creates a vector with specified length towards pole.
	MVuvw (const Quantity &l)
	MVuvw (const Quantity &l, Double angle0, Double angle1)
	Creates the uvw from specified (azimuth,elevation) angles and length.
	MVuvw (const Quantity &l, const Quantity &angle0, const Quantity &angle1)
	Creates the uvw from specified angles and length.
	MVuvw (const Quantum< Vector< Double > > &angle)
	If not enough angles: pole assumed (if none), or elevation =0 (if 1)
	MVuvw (const Quantity &l, const Quantum< Vector< Double > > &angle)
	MVuvw (const Vector< Double > &other)
	Create from specified length and/or angles and/or uvw.
	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)
MVuvw &	operator= (const MVuvw &other)
	Copy assignment.
	~MVuvw ()
	Destructor.
Double	operator* (const MVuvw &other) const
	Multiplication defined as in-product.
Bool	operator== (const MVuvw &other) const
	Equality comparisons.
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.
MVuvw &	operator+= (const MVuvw &right)
MVuvw	operator+ (const MVuvw &right) const
MVuvw &	operator-= (const MVuvw &right)
MVuvw	operator- (const MVuvw &right) const
virtual uInt	type () const
	Tell me your type.
virtual void	adjust ()
	Normalise direction aspects by adjusting the length to 1.
virtual void	adjust (Double &res)
	Adjustment with returned factor.
virtual void	readjust (Double res)
	Re-adjust using factor given.
virtual Double	radius ()
	Get radius(i.e.
Vector< Double >	get () const
	Generate a 3-vector of coordinates (length(m), angles(rad))
const Vector< Double > &	getValue () const
	Generate a 3-vector of x,y,z in m.
Quantum< Vector< Double > >	getAngle () const
	Generate angle 2-vector (in rad)
Quantum< Vector< Double > >	getAngle (const Unit &unit) const
	and with specified units
Quantity	getLength () const
	Generate the length.
Quantity	getLength (const Unit &unit) const
	and generate it with the specified units
Double	uvwAngle (const MVuvw &other) const
	Get the uvw angle between the directions.
Quantity	uvwAngle (const MVuvw &other, const Unit &unit) const
Double	separation (const MVuvw &other) const
	Get the angular separation between two directions.
Quantity	separation (const MVuvw &other, const Unit &unit) const
MVuvw	crossProduct (const MVuvw &other) const
	Produce the cross product.
virtual void	print (ostream &os) const
	Print data.
virtual MeasValue *	clone () const
	Clone.
virtual Vector< Double >	getVector () const
	Get the value in internal units.
virtual void	putVector (const Vector< Double > &in)
	Set the value from internal units (set 0 for empty vector)
virtual Vector< Quantum< Double > >	getRecordValue () const
	Get the internal value as a `Vector<Quantity>`.
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.
Static Public Member Functions
static void	assure (const MeasValue &in)

Detailed Description

A 3D vector on Earth.

Intended use:

Public interface

 <h3>Review Status</h3><dl><dt>Reviewed By:<dd>UNKNOWN<dt>Date Reviewed:<dd>before2004/08/25<dt>Test programs:<dd>tMuvw</dl>

Prerequisite

MeasValue

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:

MVuvw() creates point at origin (0,0,0)
MVuvw(MVuvw) creates a copy
MVuvw(Double, Double, Double) creates (x,y,z) with specified values (assuming meters)
MVuvw(Quantity length,Double, Double) creates a MVuvw assuming that the two values are (in radians) angle along 'equator' and towards 'pole'.
MVuvw(Quantity length, Quantity, Quantity) creates a MVuvw assuming angles as in previous, or uvws
MVuvw(Quantity, Quantum<Vector<Double> >) creates a MVuvw from angle vector, using first two angles, and assuming second as zero if not present.
MVuvw(Quantum<Vector<Double> > creates from angles or uvws, depending on the units in the quantum vector. In the angle case, the data derived can be scaled with the readjust() function. If the unit of the quantum vector is length, uvw is assumed.
MVuvw(Vector<Double> creates from angles (less than or equal to two elements) or x,y,z (3 elements).
MVuvw(Vector<Quantity> creates from length+angles, angles, or x,y,z, depending on units.
MVuvw(MVBaseline, MVDirection) creates a uvw in the specified reference direction (in same reference frame)

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

Implement for EW
Get sign (especially of V) correct
Let it handle Vectors of UVW
Add some rotation matrix history for speed

Definition at line 110 of file MVuvw.h.

Constructor & Destructor Documentation

casa::MVuvw::MVuvw ( )

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

casa::MVuvw::MVuvw ( const MVPosition & other )

Copy constructor.

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

Creates a specified vector.

casa::MVuvw::MVuvw ( Double in0 ) [explicit]

Creates a vector with specified length towards pole.

casa::MVuvw::MVuvw ( const Quantity & l )

casa::MVuvw::MVuvw	(	const Quantity &	l,
		Double	angle0,
		Double	angle1
	)

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

casa::MVuvw::MVuvw	(	const Quantity &	l,
		const Quantity &	angle0,
		const Quantity &	angle1
	)

Creates the uvw from specified angles and length.

or uvws

<h3>Thrown Exceptions</h3><ul>     <li> AipsError if quantities not in angle format
</ul>

casa::MVuvw::MVuvw ( const Quantum< Vector< Double > > & angle )

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

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

casa::MVuvw::MVuvw ( const Vector< Double > & other )

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

casa::MVuvw::MVuvw ( const Vector< Quantity > & other )

casa::MVuvw::MVuvw	(	const MVBaseline &	pos,
		const MVDirection &	dr,
		Bool	ew = `False`
	)

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

casa::MVuvw::~MVuvw ( )

Destructor.

Member Function Documentation

virtual void casa::MVuvw::adjust ( ) [virtual]

Normalise direction aspects by adjusting the length to 1.

Reimplemented from casa::MVPosition.

virtual void casa::MVuvw::adjust ( Double & res ) [virtual]

Adjustment with returned factor.

Reimplemented from casa::MVPosition.

static void casa::MVuvw::assure ( const MeasValue & in ) [static]

Reimplemented from casa::MVPosition.

virtual MeasValue* casa::MVuvw::clone ( ) const [virtual]

Clone.

Reimplemented from casa::MVPosition.

MVuvw casa::MVuvw::crossProduct ( const MVuvw & other ) const

Produce the cross product.

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

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

Reimplemented from casa::MVPosition.

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

Generate angle 2-vector (in rad)

Reimplemented from casa::MVPosition.

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

and with specified units

Reimplemented from casa::MVPosition.

Quantity casa::MVuvw::getLength ( ) const

Generate the length.

Reimplemented from casa::MVPosition.

Quantity casa::MVuvw::getLength ( const Unit & unit ) const

and generate it with the specified units

Reimplemented from casa::MVPosition.

virtual Vector<Quantum<Double> > casa::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 casa::MVPosition.

virtual Vector<Quantum<Double> > casa::MVuvw::getTMRecordValue ( ) const [inline, virtual]

Reimplemented from casa::MVPosition.

Definition at line 239 of file MVuvw.h.

References getXRecordValue().

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

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

Reimplemented from casa::MVPosition.

virtual Vector<Double> casa::MVuvw::getVector ( ) const [virtual]

Get the value in internal units.

Reimplemented from casa::MVPosition.

virtual Vector<Quantum<Double> > casa::MVuvw::getXRecordValue ( ) const [virtual]

Reimplemented from casa::MVPosition.

Referenced by getTMRecordValue().

Bool casa::MVuvw::near	(	const MVuvw &	other,
		Double	tol = `1e-13`
	)		const

Bool casa::MVuvw::near	(	const MVuvw &	other,
		Quantity	tol
	)		const

Bool casa::MVuvw::nearAbs	(	const MVuvw &	other,
		Double	tol = `1e-13`
	)		const

Bool casa::MVuvw::operator!= ( const MVuvw & other ) const

Double casa::MVuvw::operator* ( const MVuvw & other ) const

Multiplication defined as in-product.

MVuvw casa::MVuvw::operator+ ( const MVuvw & right ) const

MVuvw& casa::MVuvw::operator+= ( const MVuvw & right )

MVuvw casa::MVuvw::operator- ( ) const

Addition and subtraction.

Reimplemented from casa::MVPosition.

MVuvw casa::MVuvw::operator- ( const MVuvw & right ) const

MVuvw& casa::MVuvw::operator-= ( const MVuvw & right )

MVuvw& casa::MVuvw::operator= ( const MVuvw & other )

Copy assignment.

Bool casa::MVuvw::operator== ( const MVuvw & other ) const

Equality comparisons.

virtual void casa::MVuvw::print ( ostream & os ) const [virtual]

Print data.

Reimplemented from casa::MVPosition.

virtual Bool casa::MVuvw::putValue ( const Vector< Quantum< Double > > & in ) [virtual]

Set the internal value if correct values and dimensions.

Reimplemented from casa::MVPosition.

virtual void casa::MVuvw::putVector ( const Vector< Double > & in ) [virtual]

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

Reimplemented from casa::MVPosition.

virtual Double casa::MVuvw::radius ( ) [virtual]

Get radius(i.e.

length of vector, in m) of uvw

Reimplemented from casa::MVPosition.

virtual void casa::MVuvw::readjust ( Double res ) [virtual]

Re-adjust using factor given.

Reimplemented from casa::MVPosition.

Double casa::MVuvw::separation ( const MVuvw & other ) const

Get the angular separation between two directions.

Quantity casa::MVuvw::separation	(	const MVuvw &	other,
		const Unit &	unit
	)		const

virtual uInt casa::MVuvw::type ( ) const [virtual]

Tell me your type.

Reimplemented from casa::MVPosition.

Double casa::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 casa::MVuvw::uvwAngle	(	const MVuvw &	other,
		const Unit &	unit
	)		const

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

casacore/casa/Quanta/MVuvw.h

Public Member Functions

Static Public Member Functions

Detailed Description

Intended use:

Prerequisite

Etymology

Synopsis

Example

Motivation

To Do

Constructor & Destructor Documentation

Member Function Documentation