Parameter handling for a hyper plane function. More...

#include <HyperPlaneParam.h>

Inheritance diagram for casacore::HyperPlaneParam< T >:

Public Member Functions
	HyperPlaneParam (uInt m=0)
	Construct an m-dimensional hyper plane which has m parameters. More...

	HyperPlaneParam (const HyperPlaneParam &other)
	Copy constructor (deep copy) More...

template<class W >
	HyperPlaneParam (const HyperPlaneParam< W > &other)

HyperPlaneParam< T > &	operator= (const HyperPlaneParam< T > &other)
	Copy assignment (deep copy) More...

virtual	~HyperPlaneParam ()
	Destructor. More...

Bool	operator== (const HyperPlaneParam< T > &other) const
	Comparisons. More...

Bool	operator!= (const HyperPlaneParam< T > &other) const

virtual const String &	name () const
	Give name of function. More...

virtual uInt	ndim () const
	What is the dimension of the parameter list. More...

Public Member Functions inherited from casacore::Function< T >
	Function ()
	Constructors. More...

	Function (const uInt n)

	Function (const Vector< T > &in)

	Function (const FunctionParam< T > &other)

	Function (const Function< W, X > &other)

	Function (const Function< T, U > &other)

virtual	~Function ()
	Destructor. More...

uInt	nparameters () const
	Returns the number of parameters. More...

virtual U	eval (FunctionArg x) const =0
	Evaluate the function object. More...

T &	operator[] (const uInt n)
	Manipulate the nth parameter (0-based) with no index check. More...

const T &	operator[] (const uInt n) const

virtual U	operator() () const
	Evaluate this function object at `x`or at `x, y`. More...

virtual U	operator() (const ArgType &x) const

virtual U	operator() (const Vector< ArgType > &x) const

virtual U	operator() (FunctionArg x) const

virtual U	operator() (const ArgType &x, const ArgType &y) const

virtual U	operator() (const ArgType &x, const ArgType &y, const ArgType &z) const

Bool &	mask (const uInt n)
	Manipulate the mask associated with the nth parameter (e.g. More...

const Bool &	mask (const uInt n) const

const FunctionParam< T > &	parameters () const
	Return the parameter interface. More...

FunctionParam< T > &	parameters ()

const Vector< ArgType > &	argp () const
	Get `arg_p` and `parset_p`. More...

Bool	parsetp () const

void	lockParam ()
	Compiler cannot always find the correct 'const' version of parameter access. More...

void	unlockParam ()

virtual void	setMode (const RecordInterface &mode)
	get/set the function mode. More...

virtual void	getMode (RecordInterface &mode) const

virtual Bool	hasMode () const
	return True if the implementing function supports a mode. More...

ostream &	print (ostream &os) const
	Print the function (i.e. More...

virtual Function< T, U > *	clone () const =0
	Return a copy of this object from the heap. More...

virtual Function< typename FunctionTraits< T >::DiffType > *	cloneAD () const

virtual Function< typename FunctionTraits< T >::BaseType > *	cloneNonAD () const

Public Member Functions inherited from casacore::Functional< FunctionTraits< T >::ArgType, U >
virtual	~Functional ()
	Destructor. More...

virtual U	operator() (const FunctionTraits< T >::ArgType &x) const =0
	Map a Domain `x` into a Range `y` value. More...

Public Member Functions inherited from casacore::Functional< Vector< FunctionTraits< T >::ArgType >, U >
virtual	~Functional ()
	Destructor. More...

virtual U	operator() (const Vector< FunctionTraits< T >::ArgType > &x) const =0
	Map a Domain `x` into a Range `y` value. More...

Additional Inherited Members
Public Types inherited from casacore::Function< T >
typedef FunctionTraits< T > ::ArgType	ArgType

typedef const ArgType *	FunctionArg

Protected Attributes inherited from casacore::Function< T >
FunctionParam< T >	param_p
	The parameters and masks. More...

Vector< ArgType >	arg_p
	Aid for non-contiguous argument storage. More...

Bool	parset_p
	Indicate parameter written. More...

Bool	locked_p
	Indicate that parameters are expected to be locked from changing. More...

Detailed Description

template<class T>
class casacore::HyperPlaneParam< T >

Parameter handling for a hyper plane function.

Intended use:

Internal

Review Status

Reviewed By:: wbrouw
Date Reviewed:: 2004/05/25
Test programs:: tHyperPlane

Prerequisite

FunctionParam class
Function class

Synopsis

This class forms a function of the form f(x₀,x₁,..,x_m-1) = p₀*x₀ + p₁*x₁ +...

p_m-1*x_m-1, where p_i are coefficients (parameters) and x_i are independent arguments.

f(x₀,x₁,..,x_m-1) represents a hyper plane of dimension m.

Since the HyperPlane is a Function, the derivatives can be obtained as well.

The parameter interface (see FunctionParam class), is used to provide an interface to the Fitting classes.

This class is in general used implicitly by the HyperPlane class only.

Example

// form the hyper plane function of this form: 
// 6*x0 + 2*x3 
HyperPlane<Double> hyper(4); // 4-dim hyperplane
hyper.parameters()[0] = 6;   
hyper.parameters()[3] = 2;
// Evaluate at x0=5, x3=7
Vector<Double> x(4);
x=0; x[0]=5; x[3]=7;
cout << "Hypervalue: " << hyper(x) << endl;
Hypervalue: 44

Template Type Argument Requirements (T)

T should have standard numerical operators and exp() function. Current implementation only tested for real types (and their AutoDiffs).

Thrown Exceptions

Assertion in debug mode if attempt is made to set a negative width
AipsError if incorrect parameter number specified.

Motivation

This class was created to facilitate linear constraint functions for the use of least-squares fits.

To Do

Nothing I know of

Definition at line 108 of file HyperPlaneParam.h.

Constructor & Destructor Documentation

template<class T>

casacore::HyperPlaneParam< T >::HyperPlaneParam ( uInt m = 0 )

explicit

Construct an m-dimensional hyper plane which has m parameters.

By default, the coefficients are initialized to zero. The default plane has m=0

template<class T>

casacore::HyperPlaneParam< T >::HyperPlaneParam ( const HyperPlaneParam< T > & other )

Copy constructor (deep copy)

template<class T>

template<class W >

casacore::HyperPlaneParam< T >::HyperPlaneParam ( const HyperPlaneParam< W > & other )

inline

Definition at line 123 of file HyperPlaneParam.h.

template<class T>

virtual casacore::HyperPlaneParam< T >::~HyperPlaneParam ( )

virtual

Destructor.

Member Function Documentation

template<class T>

virtual const String& casacore::HyperPlaneParam< T >::name ( ) const

inlinevirtual

Give name of function.

Reimplemented from casacore::Function< T >.

Definition at line 146 of file HyperPlaneParam.h.

template<class T>

virtual uInt casacore::HyperPlaneParam< T >::ndim ( ) const

inlinevirtual

What is the dimension of the parameter list.

Implements casacore::Function< T >.

Definition at line 150 of file HyperPlaneParam.h.

template<class T>

Bool casacore::HyperPlaneParam< T >::operator!= ( const HyperPlaneParam< T > & other ) const

inline

Definition at line 140 of file HyperPlaneParam.h.

template<class T>

HyperPlaneParam<T>& casacore::HyperPlaneParam< T >::operator= ( const HyperPlaneParam< T > & other )

Copy assignment (deep copy)

Referenced by casacore::HyperPlane< T >::operator=().

template<class T>

Bool casacore::HyperPlaneParam< T >::operator== ( const HyperPlaneParam< T > & other ) const

inline

Comparisons.

HyperPlanes are equal if they are of the same order and have the same parameters

Definition at line 138 of file HyperPlaneParam.h.

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

casa/casacore/scimath/Functionals/HyperPlaneParam.h

Public Member Functions

Additional Inherited Members

Detailed Description

template<class T> class casacore::HyperPlaneParam< T >

Intended use:

Review Status

Prerequisite

Synopsis

Example

Template Type Argument Requirements (T)

Thrown Exceptions

Motivation

To Do

Constructor & Destructor Documentation

Member Function Documentation

template<class T>
class casacore::HyperPlaneParam< T >