IT++ Logo
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
itpp::MOG_diag_kmeans_sup Class Reference

support class for MOG_diag_kmeans() More...

#include <itpp/stat/mog_diag_kmeans.h>

Inheritance diagram for itpp::MOG_diag_kmeans_sup:
itpp::MOG_diag itpp::MOG_generic

Public Member Functions

 MOG_diag_kmeans_sup ()
 Default constructor.
 
 ~MOG_diag_kmeans_sup ()
 Default destructor.
 
void run (MOG_diag &model_in, Array< vec > &X_in, int max_iter_in=10, double trust_in=0.5, bool normalise_in=true, bool verbose_in=false)
 ADD DOCUMENTATION HERE.
 
void cleanup ()
 Release memory used by the model. The model will be empty.
 
void load (const std::string &name_in)
 Initialise the model by loading the parameters from a model file.
 
void convert_to_full ()
 Do nothing. Present for compatability with the MOG_generic class.
 
double log_lhood_single_gaus (const double *c_x_in, const int k) const
 calculate the log likelihood of C vector c_x_in using only Gaussian k
 
double log_lhood_single_gaus (const vec &x_in, const int k) const
 calculate the log likelihood of IT++ vector x_in using only Gaussian k
 
virtual double log_lhood_single_gaus (const vec &x_in, const int k)
 calculate the log likelihood of vector x_in using only Gaussian k
 
double log_lhood (const double *c_x_in)
 calculate the log likelihood of C vector c_x_in
 
double log_lhood (const vec &x_in)
 calculate the log likelihood of IT++ vector x_in
 
double lhood (const double *c_x_in)
 calculate the likelihood of C vector c_x_in
 
double lhood (const vec &x_in)
 calculate the likelihood of IT++ vector x_in
 
double avg_log_lhood (const double **c_x_in, int N)
 calculate the average log likelihood of an array of C vectors ( c_x_in )
 
double avg_log_lhood (const Array< vec > &X_in)
 calculate the average log likelihood of an array of IT++ vectors ( X_in )
 
void init ()
 Initialise the model to be empty.
 
void init (const int &K_in, const int &D_in, bool full_in=false)
 initialise the model so that all Gaussians have zero mean and unit variance for all dimensions
 
void init (Array< vec > &means_in, bool full_in=false)
 Initialise the model using user supplied mean vectors.
 
void init (Array< vec > &means_in, Array< vec > &diag_covs_in, vec &weights_in)
 Initialise the model using user supplied parameters (diagonal covariance version)
 
void init (Array< vec > &means_in, Array< mat > &full_covs_in, vec &weights_in)
 Initialise the model using user supplied parameters (full covariance version)
 
bool is_valid () const
 Returns true if the model's parameters are valid.
 
bool is_full () const
 Returns true if the model has full covariance matrices.
 
int get_K () const
 Return the number of Gaussians.
 
int get_D () const
 Return the dimensionality.
 
vec get_weights () const
 Obtain a copy of the weight vector.
 
Array< vec > get_means () const
 Obtain a copy of the array of mean vectors.
 
Array< vec > get_diag_covs () const
 Obtain a copy of the array of diagonal covariance vectors.
 
Array< mat > get_full_covs () const
 Obtain a copy of the array of full covariance matrices.
 
void set_means (Array< vec > &means_in)
 Set the means of the model.
 
void set_diag_covs (Array< vec > &diag_covs_in)
 Set the diagonal covariance vectors of the model.
 
void set_full_covs (Array< mat > &full_covs_in)
 Set the full covariance matrices of the model.
 
void set_weights (vec &weights_in)
 Set the weight vector of the model.
 
void set_means_zero ()
 Set the means in the model to be zero.
 
void set_diag_covs_unity ()
 Set the diagonal covariance vectors to be unity.
 
void set_full_covs_unity ()
 Set the full covariance matrices to be unity.
 
void set_weights_uniform ()
 Set all the weights to 1/K, where K is the number of Gaussians.
 
void set_checks (bool do_checks_in)
 Enable/disable internal checks for likelihood functions.
 
void set_paranoid (bool paranoid_in)
 Enable/disable paranoia about numerical stability.
 
virtual void save (const std::string &name_in) const
 Save the model's parameters to a model file.
 
virtual void join (const MOG_generic &B_in)
 Mathematically join the model with a user supplied model.
 
virtual void convert_to_diag ()
 Convert the model to use diagonal covariances.
 

Protected Member Functions

double dist (const double *x, const double *y) const
 ADD DOCUMENTATION HERE.
 
void assign_to_means ()
 ADD DOCUMENTATION HERE.
 
void recalculate_means ()
 ADD DOCUMENTATION HERE.
 
bool dezombify_means ()
 ADD DOCUMENTATION HERE.
 
double measure_change () const
 ADD DOCUMENTATION HERE.
 
void initial_means ()
 ADD DOCUMENTATION HERE.
 
void iterate ()
 ADD DOCUMENTATION HERE.
 
void calc_means ()
 ADD DOCUMENTATION HERE.
 
void calc_covs ()
 ADD DOCUMENTATION HERE.
 
void calc_weights ()
 ADD DOCUMENTATION HERE.
 
void normalise_vectors ()
 ADD DOCUMENTATION HERE.
 
void unnormalise_vectors ()
 ADD DOCUMENTATION HERE.
 
void unnormalise_means ()
 ADD DOCUMENTATION HERE.
 
void setup_means ()
 additional processing of mean vectors, done as the last step of mean initialisation
 
void setup_covs ()
 additional processing of covariance vectors/matrices, done as the last step of covariance initialisation
 
void setup_weights ()
 additional processing of the weight vector, done as the last step of weight initialisation
 
void setup_misc ()
 additional processing of miscellaneous parameters, done as the last step of overall initialisation
 
double log_lhood_single_gaus_internal (const double *c_x_in, const int k) const
 ADD DOCUMENTATION HERE.
 
double log_lhood_single_gaus_internal (const vec &x_in, const int k) const
 ADD DOCUMENTATION HERE.
 
virtual double log_lhood_single_gaus_internal (const vec &x_in, const int k)
 ADD DOCUMENTATION HERE.
 
double log_lhood_internal (const double *c_x_in)
 ADD DOCUMENTATION HERE.
 
double log_lhood_internal (const vec &x_in)
 ADD DOCUMENTATION HERE.
 
double lhood_internal (const double *c_x_in)
 ADD DOCUMENTATION HERE.
 
double lhood_internal (const vec &x_in)
 ADD DOCUMENTATION HERE.
 
double ** enable_c_access (Array< vec > &A_in)
 Enable C style access to an Array of vectors (vec)
 
int ** enable_c_access (Array< ivec > &A_in)
 Enable C style access to an Array of vectors (ivec)
 
double * enable_c_access (vec &v_in)
 Enable C style access to a vector (vec)
 
int * enable_c_access (ivec &v_in)
 Enable C style access to a vector (ivec)
 
double ** disable_c_access (double **A_in)
 Disable C style access to an Array of vectors (vec)
 
int ** disable_c_access (int **A_in)
 Disable C style access to an Array of vectors (ivec)
 
double * disable_c_access (double *v_in)
 Disable C style access to a vector (vec)
 
int * disable_c_access (int *v_in)
 Disable C style access to a vector (ivec)
 
void zero_all_ptrs ()
 ADD DOCUMENTATION HERE.
 
void free_all_ptrs ()
 ADD DOCUMENTATION HERE.
 
bool check_size (const vec &x_in) const
 Check if vector x_in has the same dimensionality as the model.
 
bool check_size (const Array< vec > &X_in) const
 Check if all vectors in Array X_in have the same dimensionality as the model.
 
bool check_array_uniformity (const Array< vec > &A) const
 Check if all vectors in Array X_in have the same dimensionality.
 
void set_means_internal (Array< vec > &means_in)
 ADD DOCUMENTATION HERE.
 
void set_diag_covs_internal (Array< vec > &diag_covs_in)
 ADD DOCUMENTATION HERE.
 
void set_full_covs_internal (Array< mat > &full_covs_in)
 ADD DOCUMENTATION HERE.
 
void set_weights_internal (vec &_weigths)
 ADD DOCUMENTATION HERE.
 
void set_means_zero_internal ()
 ADD DOCUMENTATION HERE.
 
void set_diag_covs_unity_internal ()
 ADD DOCUMENTATION HERE.
 
void set_full_covs_unity_internal ()
 ADD DOCUMENTATION HERE.
 
void set_weights_uniform_internal ()
 ADD DOCUMENTATION HERE.
 
void convert_to_diag_internal ()
 ADD DOCUMENTATION HERE.
 
void convert_to_full_internal ()
 ADD DOCUMENTATION HERE.
 

Protected Attributes

int max_iter
 Maximum number of iterations.
 
double trust
 trust factor, where 0 <= trust <= 1.
 
bool verbose
 Whether we print the progress.
 
int N
 number of training vectors
 
double ** c_X
 'C' pointers to training vectors
 
Array< vec > means_old
 means from the previous iteration, used to measure progress
 
double ** c_means_old
 'C' pointers to old means
 
Array< ivec > partitions
 contains indices of vectors assigned to each mean
 
int ** c_partitions
 'C' pointers to partition vectors
 
ivec count
 keeps a count of the number of vectors assigned to each mean
 
int * c_count
 'C' pointer to the count vector
 
double ** c_means
 pointers to the mean vectors
 
double ** c_diag_covs
 pointers to the covariance vectors
 
double ** c_diag_covs_inv_etc
 pointers to the inverted covariance vectors
 
double * c_weights
 pointer to the weight vector
 
double * c_log_weights
 pointer to the log version of the weight vector
 
double * c_log_det_etc
 pointer to the log_det_etc vector
 
bool do_checks
 indicates whether checks on input data are done
 
bool valid
 indicates whether the parameters are valid
 
bool full
 indicates whether we are using full or diagonal covariance matrices
 
bool paranoid
 indicates whether we are paranoid about numerical stability
 
int K
 number of gaussians
 
int D
 dimensionality
 
Array< vec > means
 means
 
Array< vec > diag_covs
 diagonal covariance matrices, stored as vectors
 
Array< mat > full_covs
 full covariance matrices
 
vec weights
 weights
 
double log_max_K
 Pre-calcualted std::log(std::numeric_limits<double>::max() / K), where K is the number of Gaussians.
 
vec log_det_etc
 Gaussian specific pre-calcualted constants.
 
vec log_weights
 Pre-calculated log versions of the weights.
 
Array< mat > full_covs_inv
 Pre-calcuated inverted version of each full covariance matrix.
 
Array< vec > diag_covs_inv_etc
 Pre-calcuated inverted version of each diagonal covariance vector, where the covariance elements are first multiplied by two.
 

Detailed Description

support class for MOG_diag_kmeans()

Author
Conrad Sanderson

Definition at line 44 of file mog_diag_kmeans.h.

Constructor & Destructor Documentation

◆ MOG_diag_kmeans_sup()

itpp::MOG_diag_kmeans_sup::MOG_diag_kmeans_sup ( )
inline

Default constructor.

Definition at line 49 of file mog_diag_kmeans.h.

◆ ~MOG_diag_kmeans_sup()

itpp::MOG_diag_kmeans_sup::~MOG_diag_kmeans_sup ( )
inline

Default destructor.

Definition at line 52 of file mog_diag_kmeans.h.

Member Function Documentation

◆ run()

void itpp::MOG_diag_kmeans_sup::run ( MOG_diag model_in,
Array< vec > &  X_in,
int  max_iter_in = 10,
double  trust_in = 0.5,
bool  normalise_in = true,
bool  verbose_in = false 
)

◆ dist()

double itpp::MOG_diag_kmeans_sup::dist ( const double *  x,
const double *  y 
) const
inlineprotected

ADD DOCUMENTATION HERE.

Definition at line 36 of file mog_diag_kmeans.cpp.

References itpp::MOG_generic::D.

Referenced by assign_to_means(), and measure_change().

◆ assign_to_means()

void itpp::MOG_diag_kmeans_sup::assign_to_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 43 of file mog_diag_kmeans.cpp.

References c_count, itpp::MOG_diag::c_means, c_partitions, c_X, count, dist(), itpp::MOG_generic::K, and N.

Referenced by dezombify_means(), and iterate().

◆ recalculate_means()

void itpp::MOG_diag_kmeans_sup::recalculate_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 65 of file mog_diag_kmeans.cpp.

References c_count, itpp::MOG_diag::c_means, c_partitions, c_X, itpp::MOG_generic::D, and itpp::MOG_generic::K.

Referenced by iterate().

◆ dezombify_means()

bool itpp::MOG_diag_kmeans_sup::dezombify_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 88 of file mog_diag_kmeans.cpp.

References assign_to_means(), c_count, itpp::MOG_diag::c_means, c_partitions, c_X, count, itpp::MOG_generic::D, it_warning, itpp::MOG_generic::K, and verbose.

Referenced by iterate().

◆ measure_change()

double itpp::MOG_diag_kmeans_sup::measure_change ( ) const
protected

ADD DOCUMENTATION HERE.

Definition at line 130 of file mog_diag_kmeans.cpp.

References itpp::MOG_diag::c_means, c_means_old, dist(), and itpp::MOG_generic::K.

Referenced by iterate().

◆ initial_means()

void itpp::MOG_diag_kmeans_sup::initial_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 139 of file mog_diag_kmeans.cpp.

References itpp::MOG_diag::c_means, c_X, itpp::MOG_generic::D, itpp::floor(), itpp::MOG_generic::K, and N.

Referenced by calc_means().

◆ iterate()

void itpp::MOG_diag_kmeans_sup::iterate ( )
protected

◆ calc_means()

void itpp::MOG_diag_kmeans_sup::calc_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 183 of file mog_diag_kmeans.cpp.

References initial_means(), and iterate().

Referenced by run().

◆ calc_covs()

void itpp::MOG_diag_kmeans_sup::calc_covs ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 190 of file mog_diag_kmeans.cpp.

References c_count, itpp::MOG_diag::c_diag_covs, itpp::MOG_diag::c_means, c_partitions, c_X, itpp::MOG_generic::D, itpp::MOG_generic::K, and trust.

Referenced by run().

◆ calc_weights()

void itpp::MOG_diag_kmeans_sup::calc_weights ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 216 of file mog_diag_kmeans.cpp.

References c_count, itpp::MOG_diag::c_weights, itpp::MOG_generic::K, N, and trust.

Referenced by run().

◆ normalise_vectors()

void itpp::MOG_diag_kmeans_sup::normalise_vectors ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 222 of file mog_diag_kmeans.cpp.

References c_X, itpp::MOG_generic::D, and N.

Referenced by run().

◆ unnormalise_vectors()

void itpp::MOG_diag_kmeans_sup::unnormalise_vectors ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 244 of file mog_diag_kmeans.cpp.

References c_X, itpp::MOG_generic::D, and N.

Referenced by run().

◆ unnormalise_means()

void itpp::MOG_diag_kmeans_sup::unnormalise_means ( )
protected

ADD DOCUMENTATION HERE.

Definition at line 254 of file mog_diag_kmeans.cpp.

References itpp::MOG_diag::c_means, itpp::MOG_generic::D, and itpp::MOG_generic::K.

Referenced by run().

◆ cleanup()

void itpp::MOG_diag::cleanup ( )
inlinevirtualinherited

Release memory used by the model. The model will be empty.

Note
The likelihood functions are not useable until the model's parameters are re-initialised

Reimplemented from itpp::MOG_generic.

Definition at line 111 of file mog_diag.h.

Referenced by itpp::MOG_diag_EM_sup::ml(), and run().

◆ load()

void itpp::MOG_diag::load ( const std::string &  name_in)
virtualinherited

Initialise the model by loading the parameters from a model file.

Parameters
name_inThe model's filename
Note
If the model file contains a full covariance matrix model, the covariance matrices will be converted to be diagonal after loading.

Reimplemented from itpp::MOG_generic.

Definition at line 277 of file mog_diag.cpp.

References itpp::MOG_generic::convert_to_diag(), itpp::MOG_generic::full, and itpp::MOG_generic::load().

◆ convert_to_full()

void itpp::MOG_diag::convert_to_full ( )
inlinevirtualinherited

Do nothing. Present for compatability with the MOG_generic class.

Reimplemented from itpp::MOG_generic.

Definition at line 121 of file mog_diag.h.

◆ log_lhood_single_gaus() [1/3]

double itpp::MOG_diag::log_lhood_single_gaus ( const double *  c_x_in,
const int  k 
) const
inherited

calculate the log likelihood of C vector c_x_in using only Gaussian k

Definition at line 59 of file mog_diag.cpp.

References itpp::MOG_generic::do_checks, it_assert, itpp::MOG_generic::K, itpp::MOG_diag::log_lhood_single_gaus_internal(), and itpp::MOG_generic::valid.

◆ log_lhood_single_gaus() [2/3]

double itpp::MOG_diag::log_lhood_single_gaus ( const vec &  x_in,
const int  k 
) const
inherited

calculate the log likelihood of IT++ vector x_in using only Gaussian k

Definition at line 69 of file mog_diag.cpp.

References itpp::MOG_generic::check_size(), itpp::MOG_generic::do_checks, it_assert, itpp::MOG_generic::K, itpp::MOG_diag::log_lhood_single_gaus_internal(), and itpp::MOG_generic::valid.

◆ log_lhood_single_gaus() [3/3]

double itpp::MOG_generic::log_lhood_single_gaus ( const vec &  x_in,
const int  k 
)
virtualinherited

calculate the log likelihood of vector x_in using only Gaussian k

Definition at line 550 of file mog_generic.cpp.

References itpp::MOG_generic::check_size(), itpp::MOG_generic::do_checks, it_assert, itpp::MOG_generic::K, itpp::MOG_generic::log_lhood_single_gaus_internal(), and itpp::MOG_generic::valid.

◆ log_lhood() [1/2]

double itpp::MOG_diag::log_lhood ( const double *  c_x_in)
inherited

calculate the log likelihood of C vector c_x_in

Definition at line 122 of file mog_diag.cpp.

References itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::log_lhood_internal(), and itpp::MOG_generic::valid.

◆ log_lhood() [2/2]

double itpp::MOG_diag::log_lhood ( const vec &  x_in)
virtualinherited

calculate the log likelihood of IT++ vector x_in

Reimplemented from itpp::MOG_generic.

Definition at line 112 of file mog_diag.cpp.

References itpp::MOG_generic::check_size(), itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::log_lhood_internal(), and itpp::MOG_generic::valid.

◆ lhood() [1/2]

double itpp::MOG_diag::lhood ( const double *  c_x_in)
inherited

calculate the likelihood of C vector c_x_in

Definition at line 170 of file mog_diag.cpp.

References itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::lhood_internal(), and itpp::MOG_generic::valid.

◆ lhood() [2/2]

double itpp::MOG_diag::lhood ( const vec &  x_in)
virtualinherited

calculate the likelihood of IT++ vector x_in

Reimplemented from itpp::MOG_generic.

Definition at line 160 of file mog_diag.cpp.

References itpp::MOG_generic::check_size(), itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::lhood_internal(), and itpp::MOG_generic::valid.

◆ avg_log_lhood() [1/2]

double itpp::MOG_diag::avg_log_lhood ( const double **  c_x_in,
int  N 
)
inherited

calculate the average log likelihood of an array of C vectors ( c_x_in )

Definition at line 181 of file mog_diag.cpp.

References itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::log_lhood_internal(), and itpp::MOG_generic::valid.

◆ avg_log_lhood() [2/2]

double itpp::MOG_diag::avg_log_lhood ( const Array< vec > &  X_in)
virtualinherited

calculate the average log likelihood of an array of IT++ vectors ( X_in )

Reimplemented from itpp::MOG_generic.

Definition at line 195 of file mog_diag.cpp.

References itpp::MOG_generic::check_size(), itpp::MOG_generic::do_checks, it_assert, itpp::MOG_diag::log_lhood_internal(), itpp::Array< T >::size(), and itpp::MOG_generic::valid.

◆ setup_means()

void itpp::MOG_diag::setup_means ( )
protectedvirtualinherited

additional processing of mean vectors, done as the last step of mean initialisation

Reimplemented from itpp::MOG_generic.

Definition at line 231 of file mog_diag.cpp.

References itpp::MOG_diag::c_means, itpp::MOG_diag::disable_c_access(), itpp::MOG_diag::enable_c_access(), itpp::MOG_generic::means, and itpp::MOG_generic::setup_means().

◆ setup_covs()

void itpp::MOG_diag::setup_covs ( )
protectedvirtualinherited

◆ setup_weights()

void itpp::MOG_diag::setup_weights ( )
protectedvirtualinherited

additional processing of the weight vector, done as the last step of weight initialisation

Reimplemented from itpp::MOG_generic.

Definition at line 254 of file mog_diag.cpp.

References itpp::MOG_diag::c_log_weights, itpp::MOG_diag::c_weights, itpp::MOG_diag::disable_c_access(), itpp::MOG_diag::enable_c_access(), itpp::MOG_generic::log_weights, itpp::MOG_generic::setup_weights(), and itpp::MOG_generic::weights.

◆ setup_misc()

void itpp::MOG_diag::setup_misc ( )
protectedvirtualinherited

additional processing of miscellaneous parameters, done as the last step of overall initialisation

Reimplemented from itpp::MOG_generic.

Definition at line 266 of file mog_diag.cpp.

References itpp::MOG_generic::convert_to_diag_internal(), itpp::MOG_diag::disable_c_access(), itpp::MOG_diag::enable_c_access(), itpp::MOG_generic::full, itpp::MOG_generic::K, and itpp::MOG_generic::setup_misc().

◆ log_lhood_single_gaus_internal() [1/3]

double itpp::MOG_diag::log_lhood_single_gaus_internal ( const double *  c_x_in,
const int  k 
) const
protectedinherited

◆ log_lhood_single_gaus_internal() [2/3]

double itpp::MOG_diag::log_lhood_single_gaus_internal ( const vec &  x_in,
const int  k 
) const
protectedinherited

ADD DOCUMENTATION HERE.

Definition at line 53 of file mog_diag.cpp.

References itpp::MOG_diag::log_lhood_single_gaus_internal().

◆ log_lhood_single_gaus_internal() [3/3]

double itpp::MOG_generic::log_lhood_single_gaus_internal ( const vec &  x_in,
const int  k 
)
protectedvirtualinherited

◆ log_lhood_internal() [1/2]

double itpp::MOG_diag::log_lhood_internal ( const double *  c_x_in)
protectedinherited

◆ log_lhood_internal() [2/2]

double itpp::MOG_diag::log_lhood_internal ( const vec &  x_in)
protectedvirtualinherited

ADD DOCUMENTATION HERE.

Reimplemented from itpp::MOG_generic.

Definition at line 106 of file mog_diag.cpp.

References itpp::MOG_diag::log_lhood_internal().

◆ lhood_internal() [1/2]

double itpp::MOG_diag::lhood_internal ( const double *  c_x_in)
protectedinherited

◆ lhood_internal() [2/2]

double itpp::MOG_diag::lhood_internal ( const vec &  x_in)
protectedvirtualinherited

ADD DOCUMENTATION HERE.

Reimplemented from itpp::MOG_generic.

Definition at line 158 of file mog_diag.cpp.

References itpp::MOG_diag::lhood_internal().

◆ enable_c_access() [1/4]

double ** itpp::MOG_diag::enable_c_access ( Array< vec > &  A_in)
protectedinherited

◆ enable_c_access() [2/4]

int ** itpp::MOG_diag::enable_c_access ( Array< ivec > &  A_in)
protectedinherited

Enable C style access to an Array of vectors (ivec)

Definition at line 292 of file mog_diag.cpp.

References itpp::Array< T >::size().

◆ enable_c_access() [3/4]

double * itpp::MOG_diag::enable_c_access ( vec &  v_in)
protectedinherited

Enable C style access to a vector (vec)

Definition at line 303 of file mog_diag.cpp.

◆ enable_c_access() [4/4]

int * itpp::MOG_diag::enable_c_access ( ivec &  v_in)
protectedinherited

Enable C style access to a vector (ivec)

Definition at line 304 of file mog_diag.cpp.

◆ disable_c_access() [1/4]

double ** itpp::MOG_diag::disable_c_access ( double **  A_in)
protectedinherited

◆ disable_c_access() [2/4]

int ** itpp::MOG_diag::disable_c_access ( int **  A_in)
protectedinherited

Disable C style access to an Array of vectors (ivec)

Definition at line 301 of file mog_diag.cpp.

◆ disable_c_access() [3/4]

double * itpp::MOG_diag::disable_c_access ( double *  v_in)
protectedinherited

Disable C style access to a vector (vec)

Definition at line 306 of file mog_diag.cpp.

◆ disable_c_access() [4/4]

int * itpp::MOG_diag::disable_c_access ( int *  v_in)
protectedinherited

Disable C style access to a vector (ivec)

Definition at line 307 of file mog_diag.cpp.

◆ zero_all_ptrs()

void itpp::MOG_diag::zero_all_ptrs ( )
protectedinherited

◆ free_all_ptrs()

void itpp::MOG_diag::free_all_ptrs ( )
protectedinherited

◆ init() [1/5]

void itpp::MOG_generic::init ( )
inherited

Initialise the model to be empty.

Note
The likelihood functions are not useable until the model's parameters are set

Definition at line 43 of file mog_generic.cpp.

References itpp::MOG_generic::cleanup().

Referenced by itpp::MOG_generic::join(), itpp::MOG_generic::load(), itpp::MOG_diag_EM_sup::ml(), and run().

◆ init() [2/5]

void itpp::MOG_generic::init ( const int &  K_in,
const int &  D_in,
bool  full_in = false 
)
inherited

initialise the model so that all Gaussians have zero mean and unit variance for all dimensions

Parameters
K_inNumber of Gaussians
D_inDimensionality
full_inIf true, use full covariance matrices; if false, use diagonal covariance matrices. Default = false.

Definition at line 46 of file mog_generic.cpp.

References itpp::MOG_generic::D, itpp::MOG_generic::do_checks, itpp::MOG_generic::full, it_assert, itpp::MOG_generic::K, itpp::MOG_generic::paranoid, itpp::MOG_generic::set_diag_covs_unity_internal(), itpp::MOG_generic::set_full_covs_unity_internal(), itpp::MOG_generic::set_means_zero_internal(), itpp::MOG_generic::set_weights_uniform_internal(), itpp::MOG_generic::setup_misc(), and itpp::MOG_generic::valid.

◆ init() [3/5]

void itpp::MOG_generic::init ( Array< vec > &  means_in,
bool  full_in = false 
)
inherited

Initialise the model using user supplied mean vectors.

Parameters
means_inArray of mean vectors
full_inIf true, use full covariance matrices; if false, use diagonal covariance matrices. Default = false.
Note
The number of mean vectors specifies the number of Gaussians. The covariance matrices are set to the identity matrix. The weights for all Gaussians are the same, equal to 1/K, where K is the number of Gaussians

Definition at line 69 of file mog_generic.cpp.

References itpp::MOG_generic::check_array_uniformity(), itpp::MOG_generic::D, itpp::MOG_generic::do_checks, itpp::MOG_generic::full, it_assert, itpp::MOG_generic::K, itpp::MOG_generic::paranoid, itpp::MOG_generic::set_diag_covs_unity_internal(), itpp::MOG_generic::set_full_covs_unity_internal(), itpp::MOG_generic::set_means(), itpp::MOG_generic::set_weights_uniform_internal(), itpp::MOG_generic::setup_misc(), itpp::Array< T >::size(), and itpp::MOG_generic::valid.

◆ init() [4/5]

void itpp::MOG_generic::init ( Array< vec > &  means_in,
Array< vec > &  diag_covs_in,
vec &  weights_in 
)
inherited

Initialise the model using user supplied parameters (diagonal covariance version)

Parameters
means_inArray of mean vectors
diag_covs_inArray of vectors representing diagonal covariances
weights_invector of weights
Note
The number of mean vectors, covariance vectors and weights must be the same

Definition at line 89 of file mog_generic.cpp.

References itpp::MOG_generic::check_array_uniformity(), itpp::MOG_generic::D, itpp::MOG_generic::do_checks, itpp::MOG_generic::full, it_assert, itpp::MOG_generic::K, itpp::MOG_generic::paranoid, itpp::MOG_generic::set_diag_covs_internal(), itpp::MOG_generic::set_means_internal(), itpp::MOG_generic::set_weights_internal(), itpp::MOG_generic::setup_misc(), itpp::Array< T >::size(), and itpp::MOG_generic::valid.

◆ init() [5/5]

void itpp::MOG_generic::init ( Array< vec > &  means_in,
Array< mat > &  full_covs_in,
vec &  weights_in 
)
inherited

Initialise the model using user supplied parameters (full covariance version)

Parameters
means_inArray of mean vectors
full_covs_inArray of covariance matrices
weights_invector of weights
Note
The number of mean vectors, covariance matrices and weights must be the same

Definition at line 110 of file mog_generic.cpp.

References itpp::MOG_generic::check_array_uniformity(), itpp::MOG_generic::D, itpp::MOG_generic::do_checks, itpp::MOG_generic::full, it_assert, itpp::MOG_generic::K, itpp::MOG_generic::paranoid, itpp::MOG_generic::set_full_covs_internal(), itpp::MOG_generic::set_means_internal(), itpp::MOG_generic::set_weights_internal(), itpp::MOG_generic::setup_misc(), itpp::Array< T >::size(), and itpp::MOG_generic::valid.

◆ is_valid()

bool itpp::MOG_generic::is_valid ( ) const
inlineinherited

Returns true if the model's parameters are valid.

Definition at line 154 of file mog_generic.h.

Referenced by itpp::MOG_generic::join(), itpp::MOG_diag_EM_sup::ml(), and run().

◆ is_full()

bool itpp::MOG_generic::is_full ( ) const
inlineinherited

Returns true if the model has full covariance matrices.

Definition at line 157 of file mog_generic.h.

References itpp::full().

Referenced by itpp::MOG_generic::join().

◆ get_K()

int itpp::MOG_generic::get_K ( ) const
inlineinherited

Return the number of Gaussians.

Definition at line 160 of file mog_generic.h.

Referenced by itpp::MOG_generic::join().

◆ get_D()

int itpp::MOG_generic::get_D ( ) const
inlineinherited

Return the dimensionality.

Definition at line 163 of file mog_generic.h.

Referenced by itpp::MOG_generic::join().

◆ get_weights()

vec itpp::MOG_generic::get_weights ( ) const
inlineinherited

Obtain a copy of the weight vector.

Definition at line 166 of file mog_generic.h.

Referenced by itpp::MOG_generic::join(), itpp::MOG_diag_EM_sup::ml(), and run().

◆ get_means()

Array< vec > itpp::MOG_generic::get_means ( ) const
inlineinherited

Obtain a copy of the array of mean vectors.

Definition at line 169 of file mog_generic.h.

Referenced by itpp::MOG_generic::join(), itpp::MOG_diag_EM_sup::ml(), and run().

◆ get_diag_covs()

Array< vec > itpp::MOG_generic::get_diag_covs ( ) const
inlineinherited

Obtain a copy of the array of diagonal covariance vectors.

Definition at line 172 of file mog_generic.h.

References itpp::full().

Referenced by itpp::MOG_generic::join(), itpp::MOG_diag_EM_sup::ml(), and run().

◆ get_full_covs()

Array< mat > itpp::MOG_generic::get_full_covs ( ) const
inlineinherited

Obtain a copy of the array of full covariance matrices.

Definition at line 175 of file mog_generic.h.

References itpp::full().

Referenced by itpp::MOG_generic::join().

◆ set_means()

void itpp::MOG_generic::set_means ( Array< vec > &  means_in)
inherited

Set the means of the model.

Note
The number of means must match the number of Gaussians in the model

Definition at line 351 of file mog_generic.cpp.

References itpp::MOG_generic::set_means_internal(), and itpp::MOG_generic::valid.

Referenced by itpp::MOG_generic::init().

◆ set_diag_covs()

void itpp::MOG_generic::set_diag_covs ( Array< vec > &  diag_covs_in)
inherited

Set the diagonal covariance vectors of the model.

Note
The number of diagonal covariance vectors must match the number of Gaussians in the model

Definition at line 365 of file mog_generic.cpp.

References itpp::MOG_generic::set_diag_covs_internal(), and itpp::MOG_generic::valid.

◆ set_full_covs()

void itpp::MOG_generic::set_full_covs ( Array< mat > &  full_covs_in)
inherited

Set the full covariance matrices of the model.

Note
The number of covariance matrices must match the number of Gaussians in the model

Definition at line 372 of file mog_generic.cpp.

References itpp::MOG_generic::set_full_covs_internal(), and itpp::MOG_generic::valid.

◆ set_weights()

void itpp::MOG_generic::set_weights ( vec &  weights_in)
inherited

Set the weight vector of the model.

Note
The number of elements in the weight vector must match the number of Gaussians in the model

Definition at line 379 of file mog_generic.cpp.

References itpp::MOG_generic::set_weights_internal(), and itpp::MOG_generic::valid.

◆ set_means_zero()

void itpp::MOG_generic::set_means_zero ( )
inherited

Set the means in the model to be zero.

Definition at line 358 of file mog_generic.cpp.

References itpp::MOG_generic::set_means_zero_internal(), and itpp::MOG_generic::valid.

◆ set_diag_covs_unity()

void itpp::MOG_generic::set_diag_covs_unity ( )
inherited

Set the diagonal covariance vectors to be unity.

Definition at line 386 of file mog_generic.cpp.

References itpp::MOG_generic::set_diag_covs_unity_internal(), and itpp::MOG_generic::valid.

◆ set_full_covs_unity()

void itpp::MOG_generic::set_full_covs_unity ( )
inherited

Set the full covariance matrices to be unity.

Definition at line 393 of file mog_generic.cpp.

References itpp::MOG_generic::set_full_covs_unity_internal(), and itpp::MOG_generic::valid.

◆ set_weights_uniform()

void itpp::MOG_generic::set_weights_uniform ( )
inherited

Set all the weights to 1/K, where K is the number of Gaussians.

Definition at line 400 of file mog_generic.cpp.

References itpp::MOG_generic::set_weights_uniform_internal(), and itpp::MOG_generic::valid.

◆ set_checks()

void itpp::MOG_generic::set_checks ( bool  do_checks_in)
inlineinherited

Enable/disable internal checks for likelihood functions.

Parameters
do_checks_inIf true, checks are enabled; if false, checks are disabled
Note
Disabling checks will provide a speedup in the likelihood functions. Disable them only when you're happy that everything is working correctly.

Definition at line 214 of file mog_generic.h.

◆ set_paranoid()

void itpp::MOG_generic::set_paranoid ( bool  paranoid_in)
inlineinherited

Enable/disable paranoia about numerical stability.

Parameters
paranoid_inIf true, calculate likelihoods using a safer, but slower method.

Definition at line 219 of file mog_generic.h.

◆ save()

void itpp::MOG_generic::save ( const std::string &  name_in) const
virtualinherited

Save the model's parameters to a model file.

Parameters
name_inThe model's filename

Definition at line 438 of file mog_generic.cpp.

References itpp::it_file::close(), itpp::MOG_generic::diag_covs, itpp::MOG_generic::full, itpp::MOG_generic::full_covs, itpp::MOG_generic::means, itpp::MOG_generic::valid, and itpp::MOG_generic::weights.

◆ join()

void itpp::MOG_generic::join ( const MOG_generic B_in)
virtualinherited

Mathematically join the model with a user supplied model.

Parameters
B_inuser supplied model
Note
The Arrays of mean vectors and covariance vectors/matrices from the two models are simply concatenated, while the weights of the resultant model are a function of the original weights and numbers of Gaussians from both models. Specifically, $ w_{new} = [ \alpha \cdot w_{A} ~~~ \beta \cdot w_{B} ]^T $, where $ w_{new} $ is the new weight vector, $ w_{A} $ and $ w_{B} $ are the weight vectors from model A and B, while $ \alpha = K_A / (K_A + KB_in) $ and $ \beta = 1-\alpha $. In turn, $ K_A $ and $ KB_in $ are the numbers of Gaussians in model A and B, respectively.

See On transforming statistical models... for more information.

Definition at line 453 of file mog_generic.cpp.

References itpp::concat(), itpp::MOG_generic::D, itpp::MOG_generic::diag_covs, itpp::MOG_generic::full, itpp::MOG_generic::full_covs, itpp::MOG_generic::get_D(), itpp::MOG_generic::get_diag_covs(), itpp::MOG_generic::get_full_covs(), itpp::MOG_generic::get_K(), itpp::MOG_generic::get_means(), itpp::MOG_generic::get_weights(), itpp::MOG_generic::init(), itpp::MOG_generic::is_full(), itpp::MOG_generic::is_valid(), it_assert, itpp::MOG_generic::K, itpp::MOG_generic::means, itpp::MOG_generic::valid, and itpp::MOG_generic::weights.

◆ convert_to_diag()

void itpp::MOG_generic::convert_to_diag ( )
virtualinherited

Convert the model to use diagonal covariances.

Note
If the model is already diagonal, nothing is done. If the model has full covariance matrices, this results in irreversible information loss (in effect the off-diagonal covariance elements are now zero)

Definition at line 499 of file mog_generic.cpp.

References itpp::MOG_generic::convert_to_diag_internal(), and itpp::MOG_generic::valid.

Referenced by itpp::MOG_diag::load().

◆ check_size() [1/2]

bool itpp::MOG_generic::check_size ( const vec &  x_in) const
protectedinherited

◆ check_size() [2/2]

bool itpp::MOG_generic::check_size ( const Array< vec > &  X_in) const
protectedinherited

Check if all vectors in Array X_in have the same dimensionality as the model.

Definition at line 137 of file mog_generic.cpp.

References itpp::MOG_generic::check_array_uniformity(), and itpp::MOG_generic::check_size().

◆ check_array_uniformity()

bool itpp::MOG_generic::check_array_uniformity ( const Array< vec > &  A) const
protectedinherited

Check if all vectors in Array X_in have the same dimensionality.

Definition at line 144 of file mog_generic.cpp.

References itpp::Array< T >::size(), and itpp::size().

Referenced by itpp::MOG_generic::check_size(), itpp::MOG_generic::init(), and itpp::MOG_diag_EM_sup::ml().

◆ set_means_internal()

void itpp::MOG_generic::set_means_internal ( Array< vec > &  means_in)
protectedinherited

◆ set_diag_covs_internal()

void itpp::MOG_generic::set_diag_covs_internal ( Array< vec > &  diag_covs_in)
protectedinherited

◆ set_full_covs_internal()

void itpp::MOG_generic::set_full_covs_internal ( Array< mat > &  full_covs_in)
protectedinherited

◆ set_weights_internal()

void itpp::MOG_generic::set_weights_internal ( vec &  _weigths)
protectedinherited

◆ set_means_zero_internal()

void itpp::MOG_generic::set_means_zero_internal ( )
protectedinherited

◆ set_diag_covs_unity_internal()

void itpp::MOG_generic::set_diag_covs_unity_internal ( )
protectedinherited

◆ set_full_covs_unity_internal()

void itpp::MOG_generic::set_full_covs_unity_internal ( )
protectedinherited

◆ set_weights_uniform_internal()

void itpp::MOG_generic::set_weights_uniform_internal ( )
protectedinherited

◆ convert_to_diag_internal()

void itpp::MOG_generic::convert_to_diag_internal ( )
protectedinherited

◆ convert_to_full_internal()

void itpp::MOG_generic::convert_to_full_internal ( )
protectedinherited

Member Data Documentation

◆ max_iter

int itpp::MOG_diag_kmeans_sup::max_iter
protected

Maximum number of iterations.

Definition at line 87 of file mog_diag_kmeans.h.

Referenced by iterate(), and run().

◆ trust

double itpp::MOG_diag_kmeans_sup::trust
protected

trust factor, where 0 <= trust <= 1.

Note
The higher the trust factor, the more we trust the estimates of covariance matrices and weights.

Definition at line 92 of file mog_diag_kmeans.h.

Referenced by calc_covs(), calc_weights(), and run().

◆ verbose

bool itpp::MOG_diag_kmeans_sup::verbose
protected

Whether we print the progress.

Definition at line 95 of file mog_diag_kmeans.h.

Referenced by dezombify_means(), iterate(), and run().

◆ N

int itpp::MOG_diag_kmeans_sup::N
protected

number of training vectors

Definition at line 98 of file mog_diag_kmeans.h.

Referenced by assign_to_means(), calc_weights(), initial_means(), normalise_vectors(), run(), and unnormalise_vectors().

◆ c_X

double** itpp::MOG_diag_kmeans_sup::c_X
protected

'C' pointers to training vectors

Definition at line 101 of file mog_diag_kmeans.h.

Referenced by assign_to_means(), calc_covs(), dezombify_means(), initial_means(), normalise_vectors(), recalculate_means(), run(), and unnormalise_vectors().

◆ means_old

Array<vec> itpp::MOG_diag_kmeans_sup::means_old
protected

means from the previous iteration, used to measure progress

Definition at line 104 of file mog_diag_kmeans.h.

Referenced by run().

◆ c_means_old

double** itpp::MOG_diag_kmeans_sup::c_means_old
protected

'C' pointers to old means

Definition at line 107 of file mog_diag_kmeans.h.

Referenced by iterate(), measure_change(), and run().

◆ partitions

Array<ivec> itpp::MOG_diag_kmeans_sup::partitions
protected

contains indices of vectors assigned to each mean

Definition at line 110 of file mog_diag_kmeans.h.

Referenced by run().

◆ c_partitions

int** itpp::MOG_diag_kmeans_sup::c_partitions
protected

'C' pointers to partition vectors

Definition at line 113 of file mog_diag_kmeans.h.

Referenced by assign_to_means(), calc_covs(), dezombify_means(), recalculate_means(), and run().

◆ count

ivec itpp::MOG_diag_kmeans_sup::count
protected

keeps a count of the number of vectors assigned to each mean

Definition at line 116 of file mog_diag_kmeans.h.

Referenced by assign_to_means(), dezombify_means(), and run().

◆ c_count

int* itpp::MOG_diag_kmeans_sup::c_count
protected

'C' pointer to the count vector

Definition at line 119 of file mog_diag_kmeans.h.

Referenced by assign_to_means(), calc_covs(), calc_weights(), dezombify_means(), recalculate_means(), and run().

◆ c_means

double** itpp::MOG_diag::c_means
protectedinherited

◆ c_diag_covs

double** itpp::MOG_diag::c_diag_covs
protectedinherited

◆ c_diag_covs_inv_etc

double** itpp::MOG_diag::c_diag_covs_inv_etc
protectedinherited

◆ c_weights

double* itpp::MOG_diag::c_weights
protectedinherited

◆ c_log_weights

double* itpp::MOG_diag::c_log_weights
protectedinherited

◆ c_log_det_etc

double* itpp::MOG_diag::c_log_det_etc
protectedinherited

◆ do_checks

bool itpp::MOG_generic::do_checks
protectedinherited

◆ valid

bool itpp::MOG_generic::valid
protectedinherited

◆ full

bool itpp::MOG_generic::full
protectedinherited

◆ paranoid

bool itpp::MOG_generic::paranoid
protectedinherited

◆ K

int itpp::MOG_generic::K
protectedinherited

◆ D

int itpp::MOG_generic::D
protectedinherited

◆ means

Array<vec> itpp::MOG_generic::means
protectedinherited

◆ diag_covs

Array<vec> itpp::MOG_generic::diag_covs
protectedinherited

◆ full_covs

Array<mat> itpp::MOG_generic::full_covs
protectedinherited

◆ weights

vec itpp::MOG_generic::weights
protectedinherited

◆ log_max_K

double itpp::MOG_generic::log_max_K
protectedinherited

Pre-calcualted std::log(std::numeric_limits<double>::max() / K), where K is the number of Gaussians.

Definition at line 310 of file mog_generic.h.

Referenced by itpp::MOG_diag::lhood_internal(), itpp::MOG_generic::lhood_internal(), itpp::MOG_diag::log_lhood_internal(), itpp::MOG_generic::log_lhood_internal(), itpp::MOG_diag_EM_sup::ml_update_params(), and itpp::MOG_generic::setup_misc().

◆ log_det_etc

vec itpp::MOG_generic::log_det_etc
protectedinherited

Gaussian specific pre-calcualted constants.

Note
Vector of pre-calculated $ -\frac{D}{2}\log(2\pi) -\frac{1}{2}\log(|\Sigma|) $ for each Gaussian, where $ D $ is the dimensionality and $ |\Sigma| $ is the determinant for the Gaussian's covariance matrix $ \Sigma $.

Definition at line 317 of file mog_generic.h.

Referenced by itpp::MOG_generic::cleanup(), itpp::MOG_generic::log_lhood_single_gaus_internal(), itpp::MOG_diag::setup_covs(), and itpp::MOG_generic::setup_covs().

◆ log_weights

vec itpp::MOG_generic::log_weights
protectedinherited

◆ full_covs_inv

Array<mat> itpp::MOG_generic::full_covs_inv
protectedinherited

Pre-calcuated inverted version of each full covariance matrix.

Definition at line 323 of file mog_generic.h.

Referenced by itpp::MOG_generic::cleanup(), itpp::MOG_generic::log_lhood_single_gaus_internal(), and itpp::MOG_generic::setup_covs().

◆ diag_covs_inv_etc

Array<vec> itpp::MOG_generic::diag_covs_inv_etc
protectedinherited

Pre-calcuated inverted version of each diagonal covariance vector, where the covariance elements are first multiplied by two.

Definition at line 326 of file mog_generic.h.

Referenced by itpp::MOG_generic::cleanup(), itpp::MOG_generic::log_lhood_single_gaus_internal(), itpp::MOG_diag::setup_covs(), and itpp::MOG_generic::setup_covs().


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

Generated on Tue Jan 24 2023 00:00:00 for IT++ by Doxygen 1.9.6