Bayesian Filtering Library  Generated from SVN r
Public Member Functions | Protected Member Functions | Protected Attributes
MCPdf< T > Class Template Reference

Monte Carlo Pdf: Sample based implementation of Pdf. More...

#include <particlefilter.h>

Inheritance diagram for MCPdf< T >:
Pdf< T > Pdf< T >

List of all members.

Public Member Functions

 MCPdf (unsigned int num_samples=0, unsigned int dimension=0)
 Constructor.
virtual ~MCPdf ()
 destructor
 MCPdf (const MCPdf< T > &)
 copy constructor
virtual MCPdf< T > * Clone () const
 Clone function.
bool SampleFrom (Sample< T > &one_sample, int method=DEFAULT, void *args=NULL) const
 Draw 1 sample from the Pdf:
bool SampleFrom (vector< Sample< T > > &list_samples, const unsigned int num_samples, int method=DEFAULT, void *args=NULL) const
 Draw multiple samples from the Pdf (overloaded)
ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
MatrixWrapper::SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
void NumSamplesSet (unsigned int num_samples)
 Set number of samples.
unsigned int NumSamplesGet () const
 Get number of samples.
const WeightedSample< T > & SampleGet (unsigned int i) const
 Get one sample.
bool ListOfSamplesSet (const vector< WeightedSample< T > > &list_of_samples)
 Set the list of weighted samples.
bool ListOfSamplesSet (const vector< Sample< T > > &list_of_samples)
 Overloading: Set the list of Samples (uniform weights)
const vector< WeightedSample
< T > > & 
ListOfSamplesGet () const
 Get the list of weighted samples.
bool ListOfSamplesUpdate (const vector< WeightedSample< T > > &list_of_samples)
 Update the list of samples (overloaded)
bool ListOfSamplesUpdate (const vector< Sample< T > > &list_of_samples)
 Update the list of samples (overloaded)
vector< double > & CumulativePDFGet ()
 Add a sample to the list.
 MCPdf (unsigned int num_samples=0, unsigned int dimension=0)
 Constructor.
virtual ~MCPdf ()
 destructor
 MCPdf (const MCPdf< T > &)
 copy constructor
virtual MCPdf< T > * Clone () const
 Clone function.
bool SampleFrom (Sample< T > &one_sample, int method=DEFAULT, void *args=NULL) const
 Draw 1 sample from the Pdf:
bool SampleFrom (vector< Sample< T > > &list_samples, const unsigned int num_samples, int method=DEFAULT, void *args=NULL) const
 Draw multiple samples from the Pdf (overloaded)
ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
MatrixWrapper::SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
void NumSamplesSet (unsigned int num_samples)
 Set number of samples.
unsigned int NumSamplesGet () const
 Get number of samples.
const WeightedSample< T > & SampleGet (unsigned int i) const
 Get one sample.
bool ListOfSamplesSet (const vector< WeightedSample< T > > &list_of_samples)
 Set the list of weighted samples.
bool ListOfSamplesSet (const vector< Sample< T > > &list_of_samples)
 Overloading: Set the list of Samples (uniform weights)
const vector< WeightedSample
< T > > & 
ListOfSamplesGet () const
 Get the list of weighted samples.
bool ListOfSamplesUpdate (const vector< WeightedSample< T > > &list_of_samples)
 Update the list of samples (overloaded)
bool ListOfSamplesUpdate (const vector< Sample< T > > &list_of_samples)
 Update the list of samples (overloaded)
vector< double > & CumulativePDFGet ()
 Add a sample to the list.
template<>
 MCPdf (unsigned int num_samples, unsigned int dimension)
template<>
 MCPdf (const MCPdf &pdf)
template<>
ColumnVector ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
template<>
unsigned int ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
template<>
 MCPdf (unsigned int num_samples, unsigned int dimension)
template<>
 MCPdf (const MCPdf &pdf)
template<>
ColumnVector ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
template<>
unsigned int ExpectedValueGet () const
 Get the expected value E[x] of the pdf.
template<>
SymmetricMatrix CovarianceGet () const
 Get the Covariance Matrix E[(x - E[x])^2] of the Analytic pdf.
virtual Probability ProbabilityGet (const T &input) const
 Get the probability of a certain argument.
virtual Probability ProbabilityGet (const T &input) const
 Get the probability of a certain argument.
virtual Probability ProbabilityGet (const T &input) const
 Get the probability of a certain argument.
virtual Probability ProbabilityGet (const T &input) const
 Get the probability of a certain argument.
unsigned int DimensionGet () const
 Get the dimension of the argument.
unsigned int DimensionGet () const
 Get the dimension of the argument.
unsigned int DimensionGet () const
 Get the dimension of the argument.
unsigned int DimensionGet () const
 Get the dimension of the argument.
virtual void DimensionSet (unsigned int dim)
 Set the dimension of the argument.
virtual void DimensionSet (unsigned int dim)
 Set the dimension of the argument.
virtual void DimensionSet (unsigned int dim)
 Set the dimension of the argument.
virtual void DimensionSet (unsigned int dim)
 Set the dimension of the argument.

Protected Member Functions

bool SumWeightsUpdate ()
 STL-iterator for cumulative PDF list.
bool NormalizeWeights ()
 Normalizing the weights.
void CumPDFUpdate ()
 After updating weights, we have to update the cumPDF.
bool SumWeightsUpdate ()
 STL-iterator for cumulative PDF list.
bool NormalizeWeights ()
 Normalizing the weights.
void CumPDFUpdate ()
 After updating weights, we have to update the cumPDF.

Protected Attributes

double _SumWeights
 Sum of all weights: used for normalising purposes.
vector< WeightedSample< T > > _listOfSamples
 STL-list containing the list of samples.
vector< double > _CumPDF
 STL-iterator.

Detailed Description

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

Monte Carlo Pdf: Sample based implementation of Pdf.

Class Monte Carlo Pdf: This is a sample based representation of a Pdf P(x), which can both be continu or discrete

Todo:
This class can and should be made far more efficient!!!

Class Monte Carlo Pdf: This is a sample based representation of a Pdf P(x), which can both be continu or discrete

Todo:
This class can and should be made far more efficient!!!

Definition at line 49 of file particlefilter.h.


Constructor & Destructor Documentation

MCPdf ( unsigned int  num_samples = 0,
unsigned int  dimension = 0 
)

Constructor.

Parameters:
num_samplesthe number of samples this pdf has
dimensionthe dimension of these samples. You can use this parameter to avoid runtime memory allocation and

Definition at line 171 of file particlefilter.h.

MCPdf ( unsigned int  num_samples = 0,
unsigned int  dimension = 0 
)

Constructor.

Parameters:
num_samplesthe number of samples this pdf has
dimensionthe dimension of these samples. You can use this parameter to avoid runtime memory allocation and

Member Function Documentation

SymmetricMatrix CovarianceGet ( ) const [inline, 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 Pdf< T >.

Definition at line 89 of file particlefilter.h.

SymmetricMatrix CovarianceGet ( ) const [inline, 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 Pdf< T >.

Definition at line 89 of file particlesmoother.h.

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 Pdf< T >.

Definition at line 541 of file particlefilter.h.

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 Pdf< T >.

SymmetricMatrix CovarianceGet ( ) const [inline, 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 Pdf< T >.

Definition at line 131 of file particlefilter.h.

SymmetricMatrix CovarianceGet ( ) const [inline, 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 Pdf< T >.

Definition at line 131 of file particlesmoother.h.

vector< double > & CumulativePDFGet ( )

Add a sample to the list.

Parameters:
samplethe sample to be added
Todo:
what's the best way to remove some samples?

Get the Cumulative Pdf

Returns:
a vector of doubles representing the CumulativePDF

Definition at line 554 of file particlefilter.h.

vector<double>& CumulativePDFGet ( )

Add a sample to the list.

Parameters:
samplethe sample to be added
Todo:
what's the best way to remove some samples?

Get the Cumulative Pdf

Returns:
a vector of doubles representing the CumulativePDF
unsigned int DimensionGet ( ) const [inline, inherited]

Get the dimension of the argument.

Returns:
the dimension of the argument

Definition at line 169 of file mixtureParticleFilter.h.

unsigned int DimensionGet ( ) const [inherited]

Get the dimension of the argument.

Returns:
the dimension of the argument
unsigned int DimensionGet ( ) const [inherited]

Get the dimension of the argument.

Returns:
the dimension of the argument
unsigned int DimensionGet ( ) const [inherited]

Get the dimension of the argument.

Returns:
the dimension of the argument
void DimensionSet ( unsigned int  dim) [virtual, inherited]

Set the dimension of the argument.

Parameters:
dimthe dimension

Definition at line 175 of file mixtureParticleFilter.h.

virtual void DimensionSet ( unsigned int  dim) [virtual, inherited]

Set the dimension of the argument.

Parameters:
dimthe dimension
virtual void DimensionSet ( unsigned int  dim) [virtual, inherited]

Set the dimension of the argument.

Parameters:
dimthe dimension
virtual void DimensionSet ( unsigned int  dim) [virtual, inherited]

Set the dimension of the argument.

Parameters:
dimthe dimension
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 Pdf< T >.

Definition at line 78 of file particlefilter.h.

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 Pdf< T >.

Definition at line 78 of file particlesmoother.h.

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 Pdf< T >.

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 Pdf< T >.

Definition at line 529 of file particlefilter.h.

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 Pdf< T >.

Definition at line 112 of file particlefilter.h.

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 Pdf< T >.

Definition at line 112 of file particlesmoother.h.

const vector< WeightedSample< T > > & ListOfSamplesGet ( ) const

Get the list of weighted samples.

Returns:
an STL-list with the list of weighted samples

Definition at line 422 of file particlefilter.h.

const vector<WeightedSample<T> >& ListOfSamplesGet ( ) const

Get the list of weighted samples.

Returns:
an STL-list with the list of weighted samples
bool ListOfSamplesSet ( const vector< WeightedSample< T > > &  list_of_samples)

Set the list of weighted samples.

Parameters:
list_of_samplesan STL-list containing the list of all weighted samples

Definition at line 382 of file particlefilter.h.

bool ListOfSamplesSet ( const vector< WeightedSample< T > > &  list_of_samples)

Set the list of weighted samples.

Parameters:
list_of_samplesan STL-list containing the list of all weighted samples
bool ListOfSamplesSet ( const vector< Sample< T > > &  list_of_samples)

Overloading: Set the list of Samples (uniform weights)

Parameters:
list_of_samplesan STL-list containing the list of all samples

Definition at line 395 of file particlefilter.h.

bool ListOfSamplesSet ( const vector< Sample< T > > &  list_of_samples)

Overloading: Set the list of Samples (uniform weights)

Parameters:
list_of_samplesan STL-list containing the list of all samples
bool ListOfSamplesUpdate ( const vector< WeightedSample< T > > &  list_of_samples)

Update the list of samples (overloaded)

Parameters:
list_of_samplesthe list of weighted samples
Precondition:
list_of_samples must contain exactly as many elements as this->NumSamplesGet() returns
bool ListOfSamplesUpdate ( const vector< WeightedSample< T > > &  list_of_samples)

Update the list of samples (overloaded)

Parameters:
list_of_samplesthe list of weighted samples
Precondition:
list_of_samples must contain exactly as many elements as this->NumSamplesGet() returns

Definition at line 429 of file particlefilter.h.

bool ListOfSamplesUpdate ( const vector< Sample< T > > &  list_of_samples)

Update the list of samples (overloaded)

Parameters:
list_of_samplesthe list of samples
Precondition:
list_of_samples must contain exactly as many elements as this->NumSamplesGet() returns
bool ListOfSamplesUpdate ( const vector< Sample< T > > &  list_of_samples)

Update the list of samples (overloaded)

Parameters:
list_of_samplesthe list of samples
Precondition:
list_of_samples must contain exactly as many elements as this->NumSamplesGet() returns

Definition at line 441 of file particlefilter.h.

unsigned int NumSamplesGet ( ) const

Get number of samples.

Returns:
the number of samples
unsigned int NumSamplesGet ( ) const

Get number of samples.

Returns:
the number of samples

Definition at line 330 of file particlefilter.h.

void NumSamplesSet ( unsigned int  num_samples)

Set number of samples.

Parameters:
num_samplesthe number of samples offcourse :-)
See also:
sample, weightedsample
void NumSamplesSet ( unsigned int  num_samples)

Set number of samples.

Parameters:
num_samplesthe number of samples offcourse :-)
See also:
sample, weightedsample

Definition at line 344 of file particlefilter.h.

virtual Probability ProbabilityGet ( const T &  input) const [virtual, inherited]

Get the probability of a certain argument.

Parameters:
inputT argument of the Pdf
Returns:
the probability value of the argument

Reimplemented in DiscreteConditionalPdf, Mixture< T >, Mixture< T >, DiscretePdf, DiscretePdf, Gaussian, Uniform, and ConditionalGaussian.

Probability ProbabilityGet ( const T &  input) const [virtual, inherited]

Get the probability of a certain argument.

Parameters:
inputT argument of the Pdf
Returns:
the probability value of the argument

Reimplemented in DiscreteConditionalPdf, Mixture< T >, Mixture< T >, DiscretePdf, DiscretePdf, Gaussian, Uniform, and ConditionalGaussian.

Definition at line 207 of file mixtureParticleFilter.h.

virtual Probability ProbabilityGet ( const T &  input) const [virtual, inherited]

Get the probability of a certain argument.

Parameters:
inputT argument of the Pdf
Returns:
the probability value of the argument

Reimplemented in DiscreteConditionalPdf, Mixture< T >, Mixture< T >, DiscretePdf, DiscretePdf, Gaussian, Uniform, and ConditionalGaussian.

virtual Probability ProbabilityGet ( const T &  input) const [virtual, inherited]

Get the probability of a certain argument.

Parameters:
inputT argument of the Pdf
Returns:
the probability value of the argument

Reimplemented in DiscreteConditionalPdf, Mixture< T >, Mixture< T >, DiscretePdf, DiscretePdf, Gaussian, Uniform, and ConditionalGaussian.

bool SampleFrom ( Sample< T > &  one_sample,
int  method = DEFAULT,
void *  args = NULL 
) const [virtual]

Draw 1 sample from the Pdf:

There's no need to create a list for only 1 sample!

Parameters:
one_samplesample that will contain result of sampling
methodSampling method to be used. Each sampling method is currently represented by a #define statement, eg. #define BOXMULLER 1
argsPointer to a struct representing extra sample arguments
See also:
SampleFrom()
Bug:
Sometimes the compiler doesn't know which method to choose!

Reimplemented from Pdf< T >.

bool SampleFrom ( Sample< T > &  one_sample,
int  method = DEFAULT,
void *  args = NULL 
) const [virtual]

Draw 1 sample from the Pdf:

There's no need to create a list for only 1 sample!

Parameters:
one_samplesample that will contain result of sampling
methodSampling method to be used. Each sampling method is currently represented by a #define statement, eg. #define BOXMULLER 1
argsPointer to a struct representing extra sample arguments
See also:
SampleFrom()
Bug:
Sometimes the compiler doesn't know which method to choose!

Reimplemented from Pdf< T >.

Definition at line 295 of file particlefilter.h.

bool SampleFrom ( vector< Sample< T > > &  list_samples,
const unsigned int  num_samples,
int  method = DEFAULT,
void *  args = NULL 
) const [virtual]

Draw multiple samples from the Pdf (overloaded)

Parameters:
list_sampleslist of samples that will contain result of sampling
num_samplesNumber of Samples to be drawn (iid)
methodSampling method to be used. Each sampling method is currently represented by a #define statement, eg. #define BOXMULLER 1
argsPointer to a struct representing extra sample arguments. "Sample Arguments" can be anything (the number of steps a gibbs-iterator should take, the interval width in MCMC, ... (or nothing), so it is hard to give a meaning to what exactly Sample Arguments should represent...
Todo:
replace the C-call "void * args" by a more object-oriented structure: Perhaps something like virtual Sample * Sample (const int num_samples,class Sampler)
Bug:
Sometimes the compiler doesn't know which method to choose!

Reimplemented from Pdf< T >.

Definition at line 228 of file particlefilter.h.

bool SampleFrom ( vector< Sample< T > > &  list_samples,
const unsigned int  num_samples,
int  method = DEFAULT,
void *  args = NULL 
) const [virtual]

Draw multiple samples from the Pdf (overloaded)

Parameters:
list_sampleslist of samples that will contain result of sampling
num_samplesNumber of Samples to be drawn (iid)
methodSampling method to be used. Each sampling method is currently represented by a #define statement, eg. #define BOXMULLER 1
argsPointer to a struct representing extra sample arguments. "Sample Arguments" can be anything (the number of steps a gibbs-iterator should take, the interval width in MCMC, ... (or nothing), so it is hard to give a meaning to what exactly Sample Arguments should represent...
Todo:
replace the C-call "void * args" by a more object-oriented structure: Perhaps something like virtual Sample * Sample (const int num_samples,class Sampler)
Bug:
Sometimes the compiler doesn't know which method to choose!

Reimplemented from Pdf< T >.

const WeightedSample< T > & SampleGet ( unsigned int  i) const

Get one sample.

Returns:
sample
Parameters:
ithe ith sample

Definition at line 336 of file particlefilter.h.

const WeightedSample<T>& SampleGet ( unsigned int  i) const

Get one sample.

Returns:
sample
Parameters:
ithe ith sample
bool SumWeightsUpdate ( ) [protected]

STL-iterator for cumulative PDF list.

After updating weights, we have to recalculate the sum of weights

bool SumWeightsUpdate ( ) [protected]

STL-iterator for cumulative PDF list.

After updating weights, we have to recalculate the sum of weights

Definition at line 466 of file particlefilter.h.


Member Data Documentation

vector< double > _CumPDF [protected]

STL-iterator.

STL-list containing the Cumulative PDF (for efficient sampling)

Definition at line 60 of file particlefilter.h.


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