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

#include <FunctionHolder.h>

Inheritance diagram for casa::FunctionHolder< T >:

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 ()
FunctionHolder &	operator= (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 String &	ident () 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< RecordInterface >	mode_p
Vector< String >	nam_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

RecordInterface class
Function class

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

AipsError if holder empty
AipsError if holder contains wrong Function

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.