mclust (version 5.3)

mstep: M-step for parameterized Gaussian mixture models.

Description

Maximization step in the EM algorithm for parameterized Gaussian mixture models.

Usage

mstep(modelName, data, z, prior = NULL, warn = NULL, …)

Arguments

modelName

A character string indicating the model. The help file for mclustModelNames describes the available models.

data

A numeric vector, matrix, or data frame of observations. Categorical variables are not allowed. If a matrix or data frame, rows correspond to observations and columns correspond to variables.

z

A matrix whose [i,k]th entry is the conditional probability of the ith observation belonging to the kth component of the mixture. In analyses involving noise, this should not include the conditional probabilities for the noise component.

prior

Specification of a conjugate prior on the means and variances. The default assumes no prior.

warn

A logical value indicating whether or not certain warnings (usually related to singularity) should be issued when the estimation fails. The default is given by mclust.options("warn").

…

Catches unused arguments in indirect or list calls via do.call.

Value

A list including the following components:

modelName

A character string identifying the model (same as the input argument).

parameters

pro

A vector whose kth component is the mixing proportion for the kth component of the mixture model. If the model includes a Poisson term for noise, there should be one more mixing proportion than the number of Gaussian components.

mean

The mean for each component. If there is more than one component, this is a matrix whose kth column is the mean of the kth component of the mixture model.

variance

A list of variance parameters for the model. The components of this list depend on the model specification. See the help file for mclustVariance for details.

Attributes:

"info" For those models with iterative M-steps ("VEI" and "VEV"), information on the iteration. "WARNING" An appropriate warning if problems are encountered in the computations.

References

C. Fraley and A. E. Raftery (2002). Model-based clustering, discriminant analysis, and density estimation. Journal of the American Statistical Association 97:611-631.

C. Fraley, A. E. Raftery, T. B. Murphy and L. Scrucca (2012). mclust Version 4 for R: Normal Mixture Modeling for Model-Based Clustering, Classification, and Density Estimation. Technical Report No. 597, Department of Statistics, University of Washington.

See Also

mstepE, …, mstepVVV, emControl, me, estep, mclust.options.

Examples

# NOT RUN {
mstep(modelName = "VII", data = iris[,-5], z = unmap(iris[,5]))
# }