mclust: me.weighted – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

me.weighted

EM algorithm with weights starting with M-step for parameterized MVN mixture models

Description

Implements the EM algorithm for fitting MVN mixture models parameterized by eigenvalue decomposition, when observations have weights, starting with the maximization step.

Usage

me.weighted(data, modelName, z, weights = NULL, prior = NULL, 
            control = emControl(), Vinv = NULL, warn = NULL, ...)

Arguments

`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.
`modelName`	A character string indicating the model. The help file for `mclustModelNames` describes the available models.
`z`	A matrix whose `[i,k]`th entry is an initial estimate of the conditional probability of the ith observation belonging to the kth component of the mixture.
`weights`	A vector of positive weights, where the `[i]`th entry is the weight for the ith observation. If any of the weights are greater than one, then they are scaled so that the maximum weight is one.
`prior`	Specification of a conjugate prior on the means and variances. See the help file for `priorControl` for further information. The default assumes no prior.
`control`	A list of control parameters for EM. The defaults are set by the call `emControl`.
`Vinv`	If the model is to include a noise term, `Vinv` is an estimate of the reciprocal hypervolume of the data region. If set to a negative value or 0, the model will include a noise term with the reciprocal hypervolume estimated by the function `hypvol`. The default is not to assume a noise term in the model through the setting `Vinv=NULL`.
`warn`	A logical value indicating whether or not certain warnings (usually related to singularity) should be issued when the estimation fails. The default is set by `warn` using `mclust.options`.
`...`	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).
`z`	A matrix whose `[i,k]`th entry is the conditional probability of the ith observation belonging to the kth component of the mixture.
`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. `Vinv` The estimate of the reciprocal hypervolume of the data region used in the computation when the input indicates the addition of a noise component to the model.
`loglik`	The log likelihood for the data in the mixture model.
`Attributes:`	`"info"` Information on the iteration. `"WARNING"` An appropriate warning if problems are encountered in the computations.

Author(s)

Thomas Brendan Murphy

Examples

w <- rep(1,150)
w[1] <- 0
me.weighted(data = iris[,-5], modelName = "VVV", 
            z = unmap(iris[,5]), weights = w)

mclust

Gaussian Mixture Modelling for Model-Based Clustering, Classification, and Density Estimation

v5.4.10

GPL (>= 2)

Authors

Chris Fraley [aut], Adrian E. Raftery [aut] (<https://orcid.org/0000-0002-6589-301X>), Luca Scrucca [aut, cre] (<https://orcid.org/0000-0003-3826-0484>), Thomas Brendan Murphy [ctb] (<https://orcid.org/0000-0002-5668-7046>), Michael Fop [ctb] (<https://orcid.org/0000-0003-3936-2757>)

Initial release

2022-05-20