SynAPSE  0.6.0
Synergistic Analysis of Phase Space Evolution
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends
Public Member Functions | Private Member Functions | Private Attributes
DMultiGaus Class Reference

Defines the methods associated with a set of Gaussian distributions in any dimension. More...

#include <DMultiGaus.hh>

Inheritance diagram for DMultiGaus:
DFunction

Public Member Functions

 DMultiGaus (const size_t n=1, const size_t k=1, const double dist=5)
 Normal constructor, initilizes k normal distribution of dimension n. More...
 
 DMultiGaus (const std::vector< double > &mu, const std::vector< double > &sigma)
 1D constructor, initilizes k Gaussians with provided means and sigmas More...
 
 DMultiGaus (const std::vector< std::vector< double >> &mu, const std::vector< std::vector< double >> &sigma)
 nD constructor, initilizes k n-Gaussianswith provided means and sigmas More...
 
 DMultiGaus (const std::vector< std::vector< double >> &mu, const std::vector< Matrix< double >> &cov)
 General constructor, intializes k n-Gaussians with provided means and cov. matrices. More...
 
 DMultiGaus (const DMultiGaus &df)
 Copy constructor. More...
 
DMultiGaus & operator= (const DMultiGaus &df)
 Equality operator. More...
 
 ~DMultiGaus ()
 Destructor. More...
 
double CDF (const double &v) const
 Cumulative distribution function at v. More...
 
double CDFRadial (const double &R) const
 If the function has an L1, L2 or Linf symmetry, returns its CDF at radius R. More...
 
bool AddPeak (const std::vector< double > &mu, const std::vector< double > &sigma)
 Adds a Gaussian peak to the current array of peaks. More...
 
bool AddPeak (const std::vector< double > &mu, const Matrix< double > &cov)
 Adds a Gaussian peak to the current array of peaks. More...
 
std::vector< TLine * > Contour1D (const double alpha) const
 Segment that encompass a certain p-value in 1 dimension. More...
 
std::vector< TObject * > Contour2D (const double alpha) const
 Ellipse that encompasses a certain p-value in 2 dimensions. More...
 
std::vector< TLine * > ContourRadial (const double alpha) const
 Dummy definition of radial contour, no radial symmetry. More...
 
TF3 * Contour3D (const double alpha) const
 Ellipsoid that encompasses a certain p-value in 3 dimensions. More...
 
double ContourVolume (const double alpha) const
 Volume of the smallest contour of a given p-value. More...
 
double Evaluate (const std::vector< double > &v) const
 Returns the value of the distribution in v. More...
 
double Level (const double alpha) const
 Returns the level of the alpha-contour of the distribution. More...
 
double Norm () const
 Returns the probability content within the defined interval. More...
 
double Radial (const double R) const
 Radial function. The uniform distribution does not have a radial symmetry. More...
 
double Radial (const size_t i, const double R) const
 Return the value of the Gaussian for an R following the L2 symmetry. More...
 
double Radius (const double alpha) const
 Returns the radius of the alpha-contour, following an L2 symmetry. More...
 
std::vector< double > Radii (const double alpha) const
 Returns the radii of each peak for the alpha-contour, following an L2 symmetry. More...
 
double Random ()
 Returns a random value sampled from the Gaussian distribution. More...
 
std::vector< double > RandomVector ()
 Returns a random vector sampled from the Gaussian distribution. More...
 
- Public Member Functions inherited from DFunction
 DFunction ()
 Default constructor, initilizes everything to 0. More...
 
 DFunction (const DFunction &df)
 Copy constructor. More...
 
DFunction & operator= (const DFunction &df)
 Equality operator. More...
 
double operator() (const std::vector< double > &v) const
 Overloaded function operator, calls Evaluate. More...
 
double operator() (const double &v) const
 Overloaded function operator, calls Evaluate. More...
 
double operator() (const double *v) const
 Overloaded function operator, calls Evaluate. More...
 
 ~DFunction ()
 Destructor. More...
 
size_t Dimension () const
 Returns the dimension of the space. More...
 
double Evaluate (const double &v) const
 Returns the value of the PDF. More...
 
double Evaluate (const double *v) const
 Returns the value of the PDF. More...
 
void SetLowerBound (const double lower, const size_t i=0)
 Sets the lower bound of axis i. More...
 
double LowerBound (const size_t i=0) const
 Returns the lower bound of axis i. More...
 
void SetLowerBounds (std::vector< double > lower)
 Sets the vector of lower bounds. More...
 
std::vector< double > LowerBounds () const
 Returns the array of lower bounds. More...
 
void SetName (const std::string &name)
 Returns the name of the function. More...
 
std::string Name () const
 Returns the name of the function. More...
 
void SetRange (const double lower, const double upper, const size_t i=0)
 Returns the upper bound of axis i. More...
 
void SetRange (const std::vector< double > &lower, const std::vector< double > &upper)
 Returns the upper bound of axis i. More...
 
void Range (std::vector< double > &lower, std::vector< double > &upper) const
 Returns the upper bound of axis i. More...
 
void SetTitle (const std::string &title)
 Returns the name of the function. More...
 
std::string Title () const
 Returns the name of the function. More...
 
void SetUpperBound (const double upper, const size_t i=0)
 Sets the upper bound of axis i. More...
 
double UpperBound (const size_t i=0) const
 Returns the upper bound of axis i. More...
 
void SetUpperBounds (std::vector< double > upper)
 Sets the vector of upper bounds. More...
 
std::vector< double > UpperBounds () const
 Returns the array of upper bounds. More...
 
TGraph * Graph (size_t idx=0, std::vector< double > x=std::vector< double >()) const
 Returns a 1D graph of the function in the requested axis. More...
 
TGraph * GraphRadial () const
 Returns a radial graph of the function. More...
 
TH2F * Graph2D (size_t idx=0, size_t idy=1, std::vector< double > x=std::vector< double >()) const
 Returns a 2D histogram of the function in the requested axis. More...
 
TGraph * GraphCDFRadial () const
 Returns a radial graph of the cummulative density function. More...
 
void Draw (const std::string opt="", int idx=0, int idy=1, std::vector< double > x=std::vector< double >()) const
 Draws the function on whichever TCanvas is currently being used (ROOT) More...
 
void DrawRadial (const std::string opt="") const
 Draws the radial function on whichever TCanvas is currently being used (ROOT) More...
 
void Print (const std::string opt="", int idx=0, int idy=1, std::vector< double > x=std::vector< double >()) const
 Creates a canvas, draws the function on it and save it to a file. More...
 
void PrintRadial (const std::string opt="") const
 Creates a canvas, draws the radial function on it and save it to a file. More...
 

Private Member Functions

bool Initialize ()
 Initializes the distribution. More...
 
double Norm1D (const size_t i) const
 Retuns the 1D normalisation for an arbitrary interval. More...
 
std::vector< double > Parameters () const
 Returns the parameters to produce a ROOT type Gaussian function. More...
 
std::vector< double > OffsetParameters (const double C) const
 Returns the parameters necessary to produce a ROOT 3D contour. More...
 

Private Attributes

size_t _k
 Number of peaks. More...
 
std::vector< std::vector
< double > > 
_means
 Array of vector means. More...
 
std::vector< Matrix< double > > _covs
 Array of covariance matrices. More...
 
std::vector< Matrix< double > > _invcovs
 Array of inverse covariance matrices. More...
 
std::vector< Matrix< double > > _Js
 Array of Jacobian of variable changes. More...
 
std::vector< double > _dets
 Array of determinants. More...
 

Additional Inherited Members

- Protected Attributes inherited from DFunction
size_t _dim
 Dimension of the space the function lives in. More...
 
std::vector< double > _lower
 Array of lower bounds. More...
 
std::vector< double > _upper
 Array of upper bounds. More...
 
std::string _name
 Name of the function. More...
 
std::string _title
 Title of the function. More...
 
TRandom3 _rdmzer
 Pseudorandom number generator. More...
 

Detailed Description

Defines the methods associated with a set of Gaussian distributions in any dimension.

Constructor & Destructor Documentation

DMultiGaus::DMultiGaus ( const size_t  n = 1,
const size_t  k = 1,
const double  dist = 5 
)

Normal constructor, initilizes k normal distribution of dimension n.

Parameters
nDimension of the space
kNumber of Gaussian peaks
distDistance between successive peaks
DMultiGaus::DMultiGaus ( const std::vector< double > &  mu,
const std::vector< double > &  sigma 
)

1D constructor, initilizes k Gaussians with provided means and sigmas

Parameters
muMean of the distribution
sigmaRMS of the distribution
DMultiGaus::DMultiGaus ( const std::vector< std::vector< double >> &  mu,
const std::vector< std::vector< double >> &  sigma 
)

nD constructor, initilizes k n-Gaussianswith provided means and sigmas

Parameters
muMean of the distribution
sigmaRMS of the distribution in each dimension
DMultiGaus::DMultiGaus ( const std::vector< std::vector< double >> &  mu,
const std::vector< Matrix< double >> &  cov 
)

General constructor, intializes k n-Gaussians with provided means and cov. matrices.

Parameters
muMean of the distribution
covCovariance matrix of the distribution
DMultiGaus::DMultiGaus ( const DMultiGaus &  df)

Copy constructor.

DMultiGaus::~DMultiGaus ( )

Destructor.

Member Function Documentation

bool DMultiGaus::AddPeak ( const std::vector< double > &  mu,
const std::vector< double > &  sigma 
)

Adds a Gaussian peak to the current array of peaks.

Parameters
muMean of the distribution
sigmaRMS of the distribution
bool DMultiGaus::AddPeak ( const std::vector< double > &  mu,
const Matrix< double > &  cov 
)

Adds a Gaussian peak to the current array of peaks.

Parameters
muMean of the distribution
covCovariance matrix of the distribution
double DMultiGaus::CDF ( const double &  v) const
virtual

Cumulative distribution function at v.

Parameters
vValue in which to evaluate the CDF

Implements DFunction.

double DMultiGaus::CDFRadial ( const double &  R) const
virtual

If the function has an L1, L2 or Linf symmetry, returns its CDF at radius R.

Parameters
RRadius to evaluate at

Implements DFunction.

std::vector< TLine * > DMultiGaus::Contour1D ( const double  alpha) const
virtual

Segment that encompass a certain p-value in 1 dimension.

Parameters
alphaP-value

Implements DFunction.

std::vector< TObject * > DMultiGaus::Contour2D ( const double  alpha) const
virtual

Ellipse that encompasses a certain p-value in 2 dimensions.

Parameters
alphaP-value

Implements DFunction.

TF3 * DMultiGaus::Contour3D ( const double  alpha) const
virtual

Ellipsoid that encompasses a certain p-value in 3 dimensions.

Parameters
alphaP-value

Implements DFunction.

std::vector< TLine * > DMultiGaus::ContourRadial ( const double  alpha) const
virtual

Dummy definition of radial contour, no radial symmetry.

Parameters
alphaP-value

Implements DFunction.

double DMultiGaus::ContourVolume ( const double  alpha) const
virtual

Volume of the smallest contour of a given p-value.

Parameters
alphaP-value

Implements DFunction.

double DMultiGaus::Evaluate ( const std::vector< double > &  v) const
virtual

Returns the value of the distribution in v.

Parameters
vVector in which to evaluate

Implements DFunction.

bool DMultiGaus::Initialize ( )
private

Initializes the distribution.

double DMultiGaus::Level ( const double  alpha) const
virtual

Returns the level of the alpha-contour of the distribution.

Parameters
alphaP-value

Implements DFunction.

double DMultiGaus::Norm ( ) const
virtual

Returns the probability content within the defined interval.

Implements DFunction.

double DMultiGaus::Norm1D ( const size_t  i) const
private

Retuns the 1D normalisation for an arbitrary interval.

Parameters
iAxis to consider
std::vector< double > DMultiGaus::OffsetParameters ( const double  C) const
private

Returns the parameters necessary to produce a ROOT 3D contour.

Parameters
CLevel of the contour
DMultiGaus & DMultiGaus::operator= ( const DMultiGaus &  df)

Equality operator.

std::vector< double > DMultiGaus::Parameters ( ) const
private

Returns the parameters to produce a ROOT type Gaussian function.

double DMultiGaus::Radial ( const double  R) const
virtual

Radial function. The uniform distribution does not have a radial symmetry.

Implements DFunction.

double DMultiGaus::Radial ( const size_t  i,
const double  R 
) const

Return the value of the Gaussian for an R following the L2 symmetry.

Parameters
iID of the peak of which to compute the level
RRadius to evaluate at (L2 symmetry)
std::vector< double > DMultiGaus::Radii ( const double  alpha) const

Returns the radii of each peak for the alpha-contour, following an L2 symmetry.

Parameters
alphaP-value
double DMultiGaus::Radius ( const double  alpha) const

Returns the radius of the alpha-contour, following an L2 symmetry.

Parameters
alphaP-value
double DMultiGaus::Random ( )
virtual

Returns a random value sampled from the Gaussian distribution.

Implements DFunction.

std::vector< double > DMultiGaus::RandomVector ( )
virtual

Returns a random vector sampled from the Gaussian distribution.

Implements DFunction.

Field Documentation

std::vector<Matrix<double> > DMultiGaus::_covs
private

Array of covariance matrices.

std::vector<double> DMultiGaus::_dets
private

Array of determinants.

std::vector<Matrix<double> > DMultiGaus::_invcovs
private

Array of inverse covariance matrices.

std::vector<Matrix<double> > DMultiGaus::_Js
private

Array of Jacobian of variable changes.

size_t DMultiGaus::_k
private

Number of peaks.

std::vector<std::vector<double> > DMultiGaus::_means
private

Array of vector means.


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