NAME
get_independent_GMM_with_shift_2 - Finds a Gaussian mixture model (GMM) for data possibly containing discrete
SYNOPSIS
#include "r/r_cluster.h"
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-I/home/kobus/include
-L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
int get_independent_GMM_with_shift_2
(
int max_left_shift,
int max_right_shift,
int num_clusters,
const Matrix *feature_mp,
const Vector *initial_delta_vp,
const Vector *initial_a_vp,
const Matrix *initial_u_mp,
const Matrix *initial_var_mp,
Vector **delta_vpp,
Matrix **P_shift_mpp,
Vector **a_vpp,
Matrix **u_mpp,
Matrix **var_mpp,
Matrix **P_cluster_mpp
);
DESCRIPTION
random global shifts in feature dimensions.
This routine finds a Gaussian mixture model (GMM) for the data on the
assumption that the features are independent. It allows for the possibility
of a data point being shifted by a random discrete amount after having been
generated from its Gaussian. The shifts are assumed to be independent of the
Gaussians from which the data points are generated. Unlike the counterpart
routine, the shifts are not necessarily assumed to occur with wrap-arounds.
Instead, the shifts could result in any arbitrary values into the feature
dimensions that free up due to the shift. The model is fit with EM. Some
features are controlled via the set facility.
This routine performs subspace clustering in that it considers only a subset
of feature dimensions that are guaranteed to be not prone to corruption by
noise due to the assumed nature of shift. The subspace of feature dimensions
is determined by the max_left_shift and max_right_shift parameters as
explained below.
In particular, it fits:
p(x) = sum sum a-sub-i * delta-sub-j * g(u-sub-i, v-sub-i, x(- s-sub-j))
i j
where a-sub-i is the prior probability for the mixuture component (cluster),
u-sub-i is the mean vector for component i, v-sub-i is the variance for the
component, and g(u,v,x) is a Gaussian with diagonal covariance (i.e., the
features are assumed to be independent, given the cluster). delta-sub-j is
the prior probability of shift j and x(- s-sub-j) indicates a global reverse
(negative sign) shift of x by the amount corresponding to s-sub-j.
max_left_shift and max_right_shift specify the maximum amount of global
discrete random left and right shift respectively a data point can experience
after being generated from its Gaussian. Unlike the counterpart routine, each
of these parameters can have only non-negative values. The total number of
possible shifts for any data point is S = (max_left_shift + max_right_shift + 1)
including the zero shift.
Based on max_left_shift and max_right_shift, a subspace of the entire
feature space exists that is guaranteed to be unaffected by the arbitrary
noise that a random shift introduces. It is of dimension
T = M - (max_left_shift + max_right_shift), where M is the dimensionality of
the full feature space. So, the EM procedure determines clusters in this
subspace rather than the full space.
The argument num_clusters is the number of requested mixture components
(clusters), K.
The data matrix feature_mp is an N by M matrix where N is the number of data
points, and M is the number of features.
The model parameters are put into *delta_vpp, *a_vpp, *u_mpp, and *var_mpp. Any of
delta_vpp, a_vpp, u_mpp, or var_mpp is NULL if that value is not needed.
The vector *delta_vpp contains the inferred probability distribution over
shifts computed using all the training data points. It is of size S. The
elements of *delta_vpp can be viewed as shift priors. The assumed order of
shifts in this vector or any other output pertaining to shifts is:
(max_left_shift, max_left_shift-1,...., 0,...., max_right_shift-1, max_right_shift)
The vector *a_vpp contains the inferred cluster priors. It is of size K.
Both u-sub-i and v-sub-i are vectors, and they are put into the i'th row of
*u_mpp and *var_mpp, respectively. The matrices are thus K by T.
If P_cluster_mpp, is not NULL, then the soft clustering (cluster membership) for each
data point is returned. In that case, *P_cluster_mpp will be N by K.
If P_shift_mpp is not NULL, then the posterior probability distribution over
the possible discrete shifts for each data point is returned. In that case,
*P_shift_mpp will be N by S.
Initial values of the parameters to be used as the starting values for the EM
iterations can be specified using initial_delta_vp, initial_a_vp,
initial_u_mp and initial_var_mp. If they are all NULL, then a
random initialization scheme is used. It is assumed that the initial
parameters are specified either in the full feature space or the reduced
space in which the final clusters are sought. In case of full space, the
routine retrieves the parameters corresponding to the target subspace.
RETURNS
If the routine fails (due to storage allocation), then ERROR is returned
with an error message being set. Otherwise NO_ERROR is returned.
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Prasad Gabbur, Kobus Barnard.
DOCUMENTER
Kobus Barnard
SEE ALSO
set_em_cluster_options
,
get_independent_GMM
,
get_independent_GMM_using_CEM
,
get_independent_GMM_with_shift
,
get_GMM_blk_compound_sym_cov
,
get_GMM_blk_compound_sym_cov_1