casa
$Rev:20696$
|
Container of function parameters with masking flags. More...
#include <FunctionParam.h>
Public Member Functions | |
FunctionParam () | |
Construct a default FunctionParam with 0 parameters. | |
FunctionParam (const uInt n) | |
Construct a FunctionParam with n parameters with zero value and all masks True | |
FunctionParam (const Vector< T > &in) | |
Construct a FunctionParam from the given vector, with all masks True | |
FunctionParam (const FunctionParam< T > &other) | |
Copy constructor (deep copy) | |
template<class W > | |
FunctionParam (const FunctionParam< W > &other) | |
Copy from different type (deep copy) | |
virtual | ~FunctionParam () |
Destructor. | |
FunctionParam & | operator= (const FunctionParam< T > &other) |
Copy assignment (deep copy) | |
T & | operator[] (const uInt n) |
Manipulate the nth parameter (0-based) with no index check. | |
const T & | operator[] (const uInt n) const |
Bool | operator== (const FunctionParam< T > &other) const |
Compare two parameter sets for equal size, values and masks. | |
Bool | operator!= (const FunctionParam< T > &other) const |
uInt | nelements () const |
Return the number of parameters. | |
T & | parameter (const uInt n) |
Manipulate the nth parameter (0-based) with no index check. | |
const T & | parameter (const uInt n) const |
Bool & | mask (const uInt n) |
Manipulate the mask associated with the nth parameter (e.g. | |
const Bool & | mask (const uInt n) const |
const Vector< T > & | getParameters () const |
Get all parameters at once. | |
void | setParameters (const Vector< T > ¶ms) |
Set all the parameters at once. | |
const Vector< Bool > & | getParamMasks () const |
Get all parameter masks at once. | |
void | setParamMasks (const Vector< Bool > &masks) |
Set all parameter masks at once. | |
uInt | nMaskedParameters () const |
Operations on the masked parameters only. | |
Vector< T > & | getMaskedParameters () const |
All masked parameters only. | |
void | setMaskedParameters (Vector< T > &in) |
ostream & | print (ostream &os) const |
Output the parameters. | |
Private Member Functions | |
void | createMaskedPtr () const |
Create a cached version of the masked parameter list. | |
void | clearMaskedPtr () const |
Clear the masked parameter list. | |
Private Attributes | |
uInt | npar_p |
Number of parameters. | |
Vector< T > | param_p |
Parameters. | |
Vector< Bool > | mask_p |
Masks. | |
Vector< T > * | maskedPtr_p |
Cached masked data. |
Container of function parameters with masking flags.
Public interface
FunctionParam
is used to provide an interface to an entity which has parameters that can be flagged. This is useful, for example, in implementing parameter fitting which operates on generic function objects.
Each parameter can be masked. The mask can, e.g., be used to indicate to a generic least-squares fitting routine to only adjust parameters with a True mask (the default). For that reason methods that only handle True data items have names with Adjust in the names. In general the user should not be concerned with these methods, but should only manipulate the parameter flags
and values
.
See the Function class for a usage interface.
Generically manipulatable adjustable parameters are important for fitting.
T
must have a default constructor, assignment operator, and copy constructor (for the Vector interface). Functions
. Definition at line 87 of file FunctionParam.h.
casa::FunctionParam< T >::FunctionParam | ( | ) |
Construct a default FunctionParam with 0 parameters.
casa::FunctionParam< T >::FunctionParam | ( | const uInt | n | ) | [explicit] |
Construct a FunctionParam with n
parameters with zero value and all masks True
casa::FunctionParam< T >::FunctionParam | ( | const Vector< T > & | in | ) | [explicit] |
Construct a FunctionParam from the given vector, with all masks True
casa::FunctionParam< T >::FunctionParam | ( | const FunctionParam< T > & | other | ) |
Copy constructor (deep copy)
casa::FunctionParam< T >::FunctionParam | ( | const FunctionParam< W > & | other | ) | [inline] |
Copy from different type (deep copy)
Definition at line 102 of file FunctionParam.h.
virtual casa::FunctionParam< T >::~FunctionParam | ( | ) | [virtual] |
Destructor.
void casa::FunctionParam< T >::clearMaskedPtr | ( | ) | const [private] |
Clear the masked parameter list.
void casa::FunctionParam< T >::createMaskedPtr | ( | ) | const [private] |
Create a cached version of the masked parameter list.
Vector<T>& casa::FunctionParam< T >::getMaskedParameters | ( | ) | const |
All masked parameters only.
const Vector<T>& casa::FunctionParam< T >::getParameters | ( | ) | const [inline] |
Get all parameters at once.
Returns zero length Vector if there are no parameters.
Definition at line 151 of file FunctionParam.h.
Referenced by casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::FunctionParam().
const Vector<Bool>& casa::FunctionParam< T >::getParamMasks | ( | ) | const [inline] |
Get all parameter masks at once.
Returns zero length Vector if there are no parameters.
Definition at line 159 of file FunctionParam.h.
Referenced by casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::FunctionParam().
Bool& casa::FunctionParam< T >::mask | ( | const uInt | n | ) |
Manipulate the mask associated with the nth parameter (e.g.
to indicate whether the parameter is adjustable or nonadjustable). Note no index check.
const Bool& casa::FunctionParam< T >::mask | ( | const uInt | n | ) | const [inline] |
Definition at line 146 of file FunctionParam.h.
uInt casa::FunctionParam< T >::nelements | ( | ) | const [inline] |
Return the number of parameters.
Definition at line 134 of file FunctionParam.h.
uInt casa::FunctionParam< T >::nMaskedParameters | ( | ) | const |
Operations on the masked parameters only.
For possible re-use the results are cached.
Number of masked (=True
) parameters
Bool casa::FunctionParam< T >::operator!= | ( | const FunctionParam< T > & | other | ) | const |
FunctionParam& casa::FunctionParam< T >::operator= | ( | const FunctionParam< T > & | other | ) |
Copy assignment (deep copy)
Bool casa::FunctionParam< T >::operator== | ( | const FunctionParam< T > & | other | ) | const |
Compare two parameter sets for equal size, values and masks.
T& casa::FunctionParam< T >::operator[] | ( | const uInt | n | ) | [inline] |
Manipulate the nth parameter (0-based) with no index check.
Definition at line 123 of file FunctionParam.h.
const T& casa::FunctionParam< T >::operator[] | ( | const uInt | n | ) | const [inline] |
Definition at line 124 of file FunctionParam.h.
T& casa::FunctionParam< T >::parameter | ( | const uInt | n | ) | [inline] |
Manipulate the nth parameter (0-based) with no index check.
Definition at line 137 of file FunctionParam.h.
const T& casa::FunctionParam< T >::parameter | ( | const uInt | n | ) | const [inline] |
Definition at line 138 of file FunctionParam.h.
ostream& casa::FunctionParam< T >::print | ( | ostream & | os | ) | const |
Output the parameters.
void casa::FunctionParam< T >::setMaskedParameters | ( | Vector< T > & | in | ) |
void casa::FunctionParam< T >::setParameters | ( | const Vector< T > & | params | ) |
Set all the parameters at once.
Only the minimum of the input number and the object number of parameters will be set.
void casa::FunctionParam< T >::setParamMasks | ( | const Vector< Bool > & | masks | ) |
Set all parameter masks at once.
Only the minimum of the input number and the object number of parameters will be set.
Vector<Bool> casa::FunctionParam< T >::mask_p [private] |
Masks.
Definition at line 187 of file FunctionParam.h.
Referenced by casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::FunctionParam(), casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::getParamMasks(), and casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::mask().
Vector<T>* casa::FunctionParam< T >::maskedPtr_p [mutable, private] |
Cached masked data.
Definition at line 189 of file FunctionParam.h.
uInt casa::FunctionParam< T >::npar_p [private] |
Number of parameters.
Definition at line 183 of file FunctionParam.h.
Referenced by casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::FunctionParam().
Vector<T> casa::FunctionParam< T >::param_p [private] |
Parameters.
Definition at line 185 of file FunctionParam.h.
Referenced by casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::FunctionParam(), casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::getParameters(), casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::nelements(), casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::operator[](), and casa::FunctionParam< typename FunctionTraits< DComplex >::DiffType >::parameter().