casa  $Rev:20696$
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Classes | Public Types | Public Member Functions | Private Member Functions | Private Attributes
casa::FunctionHolder< T > Class Template Reference

A holder for Functions to enable record conversions. More...

#include <FunctionHolder.h>

Inheritance diagram for casa::FunctionHolder< T >:
casa::RecordTransformable

List of all members.

Classes

struct  FuncStat
 Structure to hold functional status. More...

Public Types

enum  Types {
  GAUSSIAN1D,
  GAUSSIAN2D,
  GAUSSIAN3D,
  GAUSSIANND,
  HYPERPLANE,
  POLYNOMIAL,
  EVENPOLYNOMIAL,
  ODDPOLYNOMIAL,
  SINUSOID1D,
  CHEBYSHEV,
  BUTTERWORTH,
  COMBINE,
  COMPOUND,
  COMPILED,
  N_Types
}
 Types of functions. More...

Public Member Functions

 FunctionHolder ()
 Creates an empty holder.
 FunctionHolder (const Function< T > &in)
 Create from a Function (copy made)
 FunctionHolder (const FunctionHolder< T > &other)
 Copy a holder (copy semantics)
 ~FunctionHolder ()
FunctionHolderoperator= (const FunctionHolder< T > &other)
 Assignment (copy semantics)
Bool isEmpty () const
 Check the the FunctionHolder holds the specified type.
const Vector< String > & names () const
 Get the known names.
const Function< T > & asFunction () const
 Get a specific Function from the holder (with lifetime as long as holder exists).
Bool addFunction (const Function< T > &fnc)
 Add a function.
Types type () const
 Get the type of currently filled holder.
virtual Bool fromRecord (String &error, const RecordInterface &in)
 Create a Function from a record.
virtual Bool fromString (String &error, const String &in)
 Initialise the class from a String representation.
template<class U >
Bool getRecord (String &error, Function< U > *&fn, const RecordInterface &in)
virtual Bool toRecord (String &error, RecordInterface &out) const
 Create a record from a Function.
virtual const Stringident () const
 Get identification of record.

Private Member Functions

void init () const
 Initialise and check the name list.
Bool putType (String &error, RecordInterface &out) const
 Aid for to/from Record, String.
template<class U >
Bool getType (String &error, Function< U > *&fn, const RecordInterface &in)
template<class U >
Bool getType (String &error, Function< U > *&fn)
void setParameters (Function< T > *&fn, const Vector< T > &params)
void setParameters (Function< AutoDiff< T > > *&fn, const Vector< T > &params)

Private Attributes

PtrHolder< Function< T > > hold_p
 Pointer to a Function.
Types nf_p
 Aids (only filled after a succesful to/fromRecord.
Int order_p
String text_p
PtrHolder< RecordInterfacemode_p
Vector< Stringnam_p
 List of known names.
Bool isFilled
 Filled list?

Detailed Description

template<class T>
class casa::FunctionHolder< T >

A holder for Functions to enable record conversions.

Intended use:

Public interface

 <h3>Review Status</h3><dl><dt>Date Reviewed:<dd>yyyy/mm/dd<dt>Test programs:<dd>tFunctionHolder</dl> 

Prerequisite

Etymology

A Holder of general Measures

Synopsis

This class can be used to handle heterogeneous collections of Functions, e.g. as a Vector<FunctionHolder>. With the aid of the toRecord() and fromRecord() functions it can be used to convert a Function object into or from a record. A FunctionHolder is created from a Function, or can be empty.

Example

        TableRecord rec;
        MDirection dir(MVDirection(Quantity(12.5, 'deg'), Quantity(-2, 'deg')),
                       MDirection::J2000);
        String error;           // error message
        if (!FunctionHolder(dir).toRecord(error, rec)) {
                cout << error << endl;
        }
        Record grec;            // a Record
        if (!FunctionHolder(dir).toRecord(error, grec)) {  // make record
                cout << error << endl;
        }
    // Note that for GlishRecords use can be made of the
    // GlishRecord::to/fromrecord() methods.

Motivation

To make general conversions between Functions and records, without knowing the actual Function being converted.

Definition at line 91 of file FunctionHolder.h.


Member Enumeration Documentation

template<class T>
enum casa::FunctionHolder::Types

Types of functions.

Enumerator:
GAUSSIAN1D 
GAUSSIAN2D 
GAUSSIAN3D 
GAUSSIANND 
HYPERPLANE 
POLYNOMIAL 
EVENPOLYNOMIAL 
ODDPOLYNOMIAL 
SINUSOID1D 
CHEBYSHEV 
BUTTERWORTH 
COMBINE 
COMPOUND 
COMPILED 
N_Types 

Definition at line 95 of file FunctionHolder.h.


Constructor & Destructor Documentation

template<class T>
casa::FunctionHolder< T >::FunctionHolder ( )

Creates an empty holder.

template<class T>
casa::FunctionHolder< T >::FunctionHolder ( const Function< T > &  in)

Create from a Function (copy made)

template<class T>
casa::FunctionHolder< T >::FunctionHolder ( const FunctionHolder< T > &  other)

Copy a holder (copy semantics)

template<class T>
casa::FunctionHolder< T >::~FunctionHolder ( )

Member Function Documentation

template<class T>
Bool casa::FunctionHolder< T >::addFunction ( const Function< T > &  fnc)

Add a function.

template<class T>
const Function<T>& casa::FunctionHolder< T >::asFunction ( ) const

Get a specific Function from the holder (with lifetime as long as holder exists).

Thrown Exceptions

template<class T>
virtual Bool casa::FunctionHolder< T >::fromRecord ( String error,
const RecordInterface in 
) [virtual]

Create a Function from a record.

An error message is generated, and False returned if an invalid record is given. A valid record will return True. A valid record contains at least the following fields (any additional fields are ignored):

  • tp = TpString: type of Function (gaussian1d, etc; case insensitive) -- OR an enumeration code
  • order = TpInt: the order needed to create a Function (-1 if not necessary or default)
  • ndim, npar, params are optional
  • nfunc, funcs are required for COMBI or COMPOUND

A Function can be created from a string. In that case the string will only indicate the type of function (like polynomial), and will create a default polynomial of that given type. Error messages are postfixed to error.

Implements casa::RecordTransformable.

template<class T>
virtual Bool casa::FunctionHolder< T >::fromString ( String error,
const String inString 
) [virtual]

Initialise the class from a String representation.

A string cannot contain enough information for many objects. Hence the default implementation of this class returns False, indicating that the class could not be initialised and an error message is appended to the supplied string. If the class can be initialised from a string then this function should be overridden.

Reimplemented from casa::RecordTransformable.

template<class T>
template<class U >
Bool casa::FunctionHolder< T >::getRecord ( String error,
Function< U > *&  fn,
const RecordInterface in 
)
template<class T>
template<class U >
Bool casa::FunctionHolder< T >::getType ( String error,
Function< U > *&  fn,
const RecordInterface in 
) [private]
template<class T>
template<class U >
Bool casa::FunctionHolder< T >::getType ( String error,
Function< U > *&  fn 
) [private]
template<class T>
virtual const String& casa::FunctionHolder< T >::ident ( ) const [virtual]

Get identification of record.

Reimplemented from casa::RecordTransformable.

template<class T>
void casa::FunctionHolder< T >::init ( ) const [private]

Initialise and check the name list.

template<class T>
Bool casa::FunctionHolder< T >::isEmpty ( ) const

Check the the FunctionHolder holds the specified type.

Return True if if does and False otherwise.

template<class T>
const Vector<String>& casa::FunctionHolder< T >::names ( ) const

Get the known names.

template<class T>
FunctionHolder& casa::FunctionHolder< T >::operator= ( const FunctionHolder< T > &  other)

Assignment (copy semantics)

template<class T>
Bool casa::FunctionHolder< T >::putType ( String error,
RecordInterface out 
) const [private]

Aid for to/from Record, String.

template<class T>
void casa::FunctionHolder< T >::setParameters ( Function< T > *&  fn,
const Vector< T > &  params 
) [private]
template<class T>
void casa::FunctionHolder< T >::setParameters ( Function< AutoDiff< T > > *&  fn,
const Vector< T > &  params 
) [private]
template<class T>
virtual Bool casa::FunctionHolder< T >::toRecord ( String error,
RecordInterface out 
) const [virtual]

Create a record from a Function.

The return will be False and an error message generated only if the FunctionHolder does not contain a Function. Error messages are postfixed to error.

Implements casa::RecordTransformable.

template<class T>
Types casa::FunctionHolder< T >::type ( ) const

Get the type of currently filled holder.


Member Data Documentation

template<class T>
PtrHolder<Function<T> > casa::FunctionHolder< T >::hold_p [private]

Pointer to a Function.

Definition at line 191 of file FunctionHolder.h.

template<class T>
Bool casa::FunctionHolder< T >::isFilled [mutable, private]

Filled list?

Definition at line 202 of file FunctionHolder.h.

template<class T>
PtrHolder<RecordInterface> casa::FunctionHolder< T >::mode_p [mutable, private]

Definition at line 197 of file FunctionHolder.h.

template<class T>
Vector<String> casa::FunctionHolder< T >::nam_p [mutable, private]

List of known names.

Definition at line 200 of file FunctionHolder.h.

template<class T>
Types casa::FunctionHolder< T >::nf_p [mutable, private]

Aids (only filled after a succesful to/fromRecord.

Definition at line 194 of file FunctionHolder.h.

template<class T>
Int casa::FunctionHolder< T >::order_p [mutable, private]

Definition at line 195 of file FunctionHolder.h.

template<class T>
String casa::FunctionHolder< T >::text_p [mutable, private]

Definition at line 196 of file FunctionHolder.h.


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