Base class for values in a Measure. More...

#include <MeasValue.h>

Inheritance diagram for casa::MeasValue:

Public Member Functions
void	dummy_constr () const
	Each derived class should have at least the following constructors:
virtual	~MeasValue ()
	Destructor.
void	dummy_operator () const
	The following operators should be present at least.
virtual uInt	type () const =0
	Assert that we are the correct MeasValue type.
virtual void	print (ostream &os) const =0
	Print a MeasValue.
virtual MeasValue *	clone () const =0
	Clone a MeasValue.
virtual Vector< Double >	getVector () const =0
	Get the internal value as a `Vector<Double>`.
virtual Vector< Quantum< Double > >	getRecordValue () const =0
	Get the internal value as a `Vector<Quantity>`.
virtual Vector< Quantum< Double > >	getXRecordValue () const
virtual Vector< Quantum< Double > >	getTMRecordValue () const
virtual void	putVector (const Vector< Double > &in)=0
	Set the internal value from a Vector of values (obtained in principle with a getVector()).
virtual Bool	putValue (const Vector< Quantum< Double > > &in)=0
	Set the internal value if correct values and dimensions.
virtual void	adjust ()
	Some of the Measure values used need the occasional adjustments to proper values.
virtual void	adjust (Double &val)
	Adjust value and return a normalisation value.
virtual void	readjust (Double val)
	Re-adjust, i.e.
Friends
ostream &	operator<< (ostream &os, const MeasValue &meas)
	Output a MeasValue.

Detailed Description

Base class for values in a Measure.

Intended use:

Public interface

Review Status

Reviewed By:: tcornwel
Date Reviewed:: 1996/02/22
Test programs:: tMeasMath

Prerequisite

Measure class

Etymology

Synopsis

MeasValue forms the abstract base class for the values of quantities within a reference frame. Examples of derived classes are:

MVEpoch : a moment in time
MVDirection : a direction in space
MVPosition : a position on Earth
MVFrequency
MVRadialVelocity
MVDoppler

MeasValue is the generic name for the more specific instances like, e.g., MVEpoch , an instant in time.
MeasValues can in general be constructed from an appropiate value, or array of values.
The value can be expressed in the internally used units (e.g. days for time, a 3-vector for direction in space), as an array of internally used units, or as a Quantum : a value with appropiate units. Vector<Quantum<type> > and Quantum<Vector<type> > can also be used.

The value of the MeasValue can be obtained by a variety of get functions, returning in general internal or Quantum values. Special formatting (like hh:mm:ss.t, dd.mm.ss.t, yy/mm/dd etc) are catered for in conversion-type classes like MVTime , MVAngle

Note that the class is a pure virtual class. No instances can be created, but it describes the minimum set of functions necessary in derived functions.
Warning: In the member description a number of dummy routines are present; They are the only way I have found to get cxx2html to get the belonging text properly presented;

Example

See individual MV and Measure classes

Motivation

To be able to specify a physical entity appropiate for the measured quantity.

Definition at line 107 of file MeasValue.h.

Constructor & Destructor Documentation

virtual casa::MeasValue::~MeasValue ( ) [virtual]

Destructor.

Member Function Documentation

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

Some of the Measure values used need the occasional adjustments to proper values.

Examples are MVDirection (direction cosines) which have to be normalised to a length of 1 and MEpoch (time) which have to have its precision maintained. For others it is an effctive no-operation.

Adjust value

Reimplemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVDirection, and casa::MVEpoch.

virtual void casa::MeasValue::adjust ( Double & val ) [virtual]

Adjust value and return a normalisation value.

Reimplemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVDirection, and casa::MVEpoch.

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

Clone a MeasValue.

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVDirection, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.

void casa::MeasValue::dummy_constr ( ) const [inline]

Each derived class should have at least the following constructors:

        MV()                    // some default
        MV(Double)              // some default or error if vector expected
        MV(Vector<Double>)      // with check for array number of elements
        MV(Quantity)
        MV(Vector<Quantity>)
        MV(Quantum<Vector<Double> >

Float (or other standard type) versions could be added if appropiate. Dummy for cxx2html

Definition at line 130 of file MeasValue.h.

void casa::MeasValue::dummy_operator ( ) const [inline]

The following operators should be present at least.

      MV &operator+=(const MV &meas);
      MV &operator-=(const MV &meas);
      Bool operator==(const MV &meas) const;
      Bool operator!=(const MV &meas) const;
      Bool near(const MV &meas, Double tol = 1e-13) const;
      Bool nearAbs(const MV &meas, Double tol = 1e-13) const;

Dummy for cxx2html

Definition at line 147 of file MeasValue.h.

virtual Vector<Quantum<Double> > casa::MeasValue::getRecordValue ( ) const [pure virtual]

Get the internal value as a Vector<Quantity>.

Usable in records. The getXRecordValue() gets additional information for records. The getTMRecordValue() gets the record values as deemed appropriate for the TableMeasures. Note that the Vectors could be empty.

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVDirection, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.

virtual Vector<Quantum<Double> > casa::MeasValue::getTMRecordValue ( ) const [virtual]

Reimplemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, and casa::MVDirection.

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

Get the internal value as a Vector<Double>.

Note that the vector could be empty, or not be a true representation (different data sizes e.g.)

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.

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

Reimplemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, and casa::MVDirection.

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

Print a MeasValue.

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.

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

Set the internal value if correct values and dimensions.

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVDirection, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.

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

Set the internal value from a Vector of values (obtained in principle with a getVector()).

It will be assumed that the Vector is correctly formatted. If Vector is too long, the remainder will be discarded. If Vector is too short, action will depend on the individual classes, but in general act the same way as a constructor with a short Vector.

Implemented in casa::MVPosition, casa::MVuvw, casa::MVBaseline, casa::MVEarthMagnetic, casa::MVEpoch, casa::MVFrequency, casa::MVRadialVelocity, casa::MVDoppler, and casa::MVDouble.