Public Member Functions | Protected Member Functions | Protected Attributes
BFL::Mixture< T > Class Template Reference

Class representing a mixture of PDFs, the mixture can contain different. More...

#include <mixture.h>

Inheritance diagram for BFL::Mixture< T >:
Inheritance graph
[legend]

List of all members.

Public Member Functions

bool AddComponent (Pdf< T > &pdf)
 Add a component pdf: THIS IS A NON-REALTIME OPERATION.
bool AddComponent (Pdf< T > &pdf, Probability w)
 Add a component pdf with weight w: THIS IS A NON-REALTIME OPERATION.
virtual MixtureClone () const
 Clone function.
Pdf< T > * ComponentGet (unsigned int componentNumber) const
 Get the pointer to the component pdf of component "componentNumber".
vector< Pdf< T > * > ComponentsGet () const
 Get the vector of pointers to the component pdfs.
MatrixWrapper::SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
bool DeleteComponent (unsigned int componentNumber)
 Delete a component pdf: THIS IS A NON_REALTIME OPERATION.
template<>
ColumnVector ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
unsigned int ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
int ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
double ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
 Mixture (const unsigned int dimension=0)
 Constructor: An equal weight is set for all components.
template<typename U >
 Mixture (const U &componentVector)
 Constructor: An equal weights is set for all components.
 Mixture (const Mixture &my_mixture)
 Copy Constructor.
int MostProbableComponentGet () const
 Get the index of the most probable component, if a few component are.
unsigned int NumComponentsGet () const
 Get the number of components.
Probability ProbabilityGet (const T &state) const
 Implementation of virtual base class method.
bool SampleFrom (vector< Sample< T > > &list_samples, const unsigned int num_samples, int method=DEFAULT, void *args=NULL) const
bool SampleFrom (Sample< T > &one_sample, int method=DEFAULT, void *args=NULL) const
Probability WeightGet (unsigned int componentNumber) const
 Get the component weight of component "componentNumber".
bool WeightSet (unsigned int componentNumber, Probability w)
 Function to change/set the weigth of a single component.
vector< ProbabilityWeightsGet () const
 Get all component weights.
bool WeightsSet (vector< Probability > &weights)
 Set all component weights.
virtual ~Mixture ()
 Destructor.

Protected Member Functions

bool CumWeightsUpdate ()
 Updates the cumWeights.
bool NormalizeWeights ()
 Normalize the component weigths (eg. after setting a component weight)
void TestNotInit () const
 Called when a the number of components=0 and if method is called which.

Protected Attributes

vector< Pdf< T > * > * _componentPdfs
 Pointer to the vector of component pdfs.
vector< Probability > * _componentWeights
 Pointer to the vector of mixture weights, the sum of the elements = 1.
vector< double > _cumWeights
 Vector containing the cumulative component weights (for efficient sampling)
unsigned int _numComponents
 The number of components.

Detailed Description

template<typename T>
class BFL::Mixture< T >

Class representing a mixture of PDFs, the mixture can contain different.

This class is an instantation from the template class Pdf, with added methods to get a set the individual components and mixture weights

Definition at line 48 of file mixture.h.


Constructor & Destructor Documentation

template<typename T>
BFL::Mixture< T >::Mixture ( const unsigned int  dimension = 0)

Constructor: An equal weight is set for all components.

Parameters:
dimensionthe dimension of the state space
template<typename T>
template<typename U >
BFL::Mixture< T >::Mixture ( const U &  componentVector)

Constructor: An equal weights is set for all components.

Parameters:
componentVectorvector of components (Pdf<T>*)
template<typename T>
BFL::Mixture< T >::Mixture ( const Mixture< T > &  my_mixture)

Copy Constructor.

template<typename T>
virtual BFL::Mixture< T >::~Mixture ( ) [virtual]

Destructor.


Member Function Documentation

template<typename T>
bool BFL::Mixture< T >::AddComponent ( Pdf< T > &  pdf)

Add a component pdf: THIS IS A NON-REALTIME OPERATION.

Parameters:
pdfComponent pdf which will be added
template<typename T>
bool BFL::Mixture< T >::AddComponent ( Pdf< T > &  pdf,
Probability  w 
)

Add a component pdf with weight w: THIS IS A NON-REALTIME OPERATION.

Parameters:
pdfComponent pdf which will be added
weightthe weight of the new component
template<typename T>
virtual Mixture* BFL::Mixture< T >::Clone ( ) const [virtual]

Clone function.

Implements BFL::BFL::Pdf< T >.

template<typename T>
Pdf<T>* BFL::Mixture< T >::ComponentGet ( unsigned int  componentNumber) const

Get the pointer to the component pdf of component "componentNumber".

Parameters:
componentNumbernumber of the component (must be >=0 and <_numComponents)
template<typename T>
vector<Pdf<T>* > BFL::Mixture< T >::ComponentsGet ( ) const

Get the vector of pointers to the component pdfs.

template<typename T>
MatrixWrapper::SymmetricMatrix BFL::Mixture< T >::CovarianceGet ( ) const [virtual]

Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.

Get first order statistic (Covariance) of this AnalyticPdf

Returns:
The Covariance of the Pdf (a SymmetricMatrix of dim DIMENSION)
Todo:
extend this more general to n-th order statistic
Bug:
Discrete pdfs should not be able to use this!

Reimplemented from BFL::BFL::Pdf< T >.

template<typename T>
bool BFL::Mixture< T >::CumWeightsUpdate ( ) [protected]

Updates the cumWeights.

template<typename T>
bool BFL::Mixture< T >::DeleteComponent ( unsigned int  componentNumber)

Delete a component pdf: THIS IS A NON_REALTIME OPERATION.

Parameters:
componentNumbernumber of the component which will be deleted (must be >=0 and <_numComponents)
template<>
ColumnVector BFL::Mixture< ColumnVector >::ExpectedValueGet ( ) const [inline, virtual]

Get the expected value E[x] of the pdf.

Get low order statistic (Expected Value) of this AnalyticPdf

Returns:
The Expected Value of the Pdf (a ColumnVector with DIMENSION rows)
Note:
No set functions here! This can be useful for analytic functions, but not for sample based representations!
For certain discrete Pdfs, this function has no meaning, what is the average between yes and no?

Reimplemented from BFL::BFL::Pdf< T >.

Definition at line 30 of file mixture.cpp.

template<>
unsigned int BFL::Mixture< unsigned int >::ExpectedValueGet ( ) const [inline, virtual]

Get the expected value E[x] of the pdf.

Get low order statistic (Expected Value) of this AnalyticPdf

Returns:
The Expected Value of the Pdf (a ColumnVector with DIMENSION rows)
Note:
No set functions here! This can be useful for analytic functions, but not for sample based representations!
For certain discrete Pdfs, this function has no meaning, what is the average between yes and no?

Reimplemented from BFL::BFL::Pdf< T >.

Definition at line 45 of file mixture.cpp.

template<>
int BFL::Mixture< int >::ExpectedValueGet ( ) const [inline, virtual]

Get the expected value E[x] of the pdf.

Get low order statistic (Expected Value) of this AnalyticPdf

Returns:
The Expected Value of the Pdf (a ColumnVector with DIMENSION rows)
Note:
No set functions here! This can be useful for analytic functions, but not for sample based representations!
For certain discrete Pdfs, this function has no meaning, what is the average between yes and no?

Reimplemented from BFL::BFL::Pdf< T >.

Definition at line 81 of file mixture.cpp.

template<typename T>
T BFL::Mixture< T >::ExpectedValueGet ( ) const [virtual]

Get the expected value E[x] of the pdf.

Get low order statistic (Expected Value) of this AnalyticPdf

Returns:
The Expected Value of the Pdf (a ColumnVector with DIMENSION rows)
Note:
No set functions here! This can be useful for analytic functions, but not for sample based representations!
For certain discrete Pdfs, this function has no meaning, what is the average between yes and no?

Reimplemented from BFL::BFL::Pdf< T >.

template<>
double BFL::Mixture< double >::ExpectedValueGet ( ) const [inline, virtual]

Get the expected value E[x] of the pdf.

Get low order statistic (Expected Value) of this AnalyticPdf

Returns:
The Expected Value of the Pdf (a ColumnVector with DIMENSION rows)
Note:
No set functions here! This can be useful for analytic functions, but not for sample based representations!
For certain discrete Pdfs, this function has no meaning, what is the average between yes and no?

Reimplemented from BFL::BFL::Pdf< T >.

Definition at line 115 of file mixture.cpp.

template<typename T>
int BFL::Mixture< T >::MostProbableComponentGet ( ) const

Get the index of the most probable component, if a few component are.

template<typename T>
bool BFL::Mixture< T >::NormalizeWeights ( ) [protected]

Normalize the component weigths (eg. after setting a component weight)

template<typename T>
unsigned int BFL::Mixture< T >::NumComponentsGet ( ) const

Get the number of components.

template<typename T>
Probability BFL::Mixture< T >::ProbabilityGet ( const T &  state) const [virtual]

Implementation of virtual base class method.

Reimplemented from BFL::BFL::Pdf< T >.

template<typename T>
bool BFL::Mixture< T >::SampleFrom ( vector< Sample< T > > &  list_samples,
const unsigned int  num_samples,
int  method = DEFAULT,
void *  args = NULL 
) const
template<typename T>
bool BFL::Mixture< T >::SampleFrom ( Sample< T > &  one_sample,
int  method = DEFAULT,
void *  args = NULL 
) const
template<typename T>
void BFL::Mixture< T >::TestNotInit ( ) const [protected]

Called when a the number of components=0 and if method is called which.

template<typename T>
Probability BFL::Mixture< T >::WeightGet ( unsigned int  componentNumber) const

Get the component weight of component "componentNumber".

Parameters:
componentNumbernumber of the component (must be >=0 and <_numComponents)
template<typename T>
bool BFL::Mixture< T >::WeightSet ( unsigned int  componentNumber,
Probability  w 
)

Function to change/set the weigth of a single component.

Changes the component weights such that AFTER normalization the weight of the component "componentNumber" is equal to the weight w

Parameters:
componentNumbernumber of the component of which the weight will be set (must be >=0 and <_numComponents)
wProbability to which the weight of component "componentNumber" will be set (must be <= 1)
template<typename T>
vector<Probability> BFL::Mixture< T >::WeightsGet ( ) const

Get all component weights.

template<typename T>
bool BFL::Mixture< T >::WeightsSet ( vector< Probability > &  weights)

Set all component weights.

values vector<Probability> containing the new component weights . The sum of the probabilities of this list is not required to be one since the normalization is automatically carried out. The size of weights should be equal to the number of components


Member Data Documentation

template<typename T>
vector<Pdf<T>* >* BFL::Mixture< T >::_componentPdfs [protected]

Pointer to the vector of component pdfs.

Definition at line 58 of file mixture.h.

template<typename T>
vector<Probability>* BFL::Mixture< T >::_componentWeights [protected]

Pointer to the vector of mixture weights, the sum of the elements = 1.

Definition at line 55 of file mixture.h.

template<typename T>
vector<double> BFL::Mixture< T >::_cumWeights [protected]

Vector containing the cumulative component weights (for efficient sampling)

Definition at line 66 of file mixture.h.

template<typename T>
unsigned int BFL::Mixture< T >::_numComponents [protected]

The number of components.

Definition at line 52 of file mixture.h.


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


bfl
Author(s): Klaas Gadeyne, Wim Meeussen, Tinne Delaet and many others. See web page for a full contributor list. ROS package maintained by Wim Meeussen.
autogenerated on Sun Oct 5 2014 22:29:53