mvnX: Univariate or Multivariate Normal Fit

Description Usage Arguments Details Value See Also Examples

View source: R/mclust.R

Description

Computes the mean, covariance, and log-likelihood from fitting a single Gaussian (univariate or multivariate normal).

Usage

1
2
3
4
mvnX(data, prior = NULL, warn = NULL, ...)
mvnXII(data, prior = NULL, warn = NULL, ...)
mvnXXI(data, prior = NULL, warn = NULL, ...)
mvnXXX(data, prior = 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.

prior

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

warn

A logical value indicating whether or not a warning should be issued whenever a singularity is encountered. The default is given by mclust.options("warn").

...

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

Details

mvnXII

computes the best fitting Gaussian with the covariance restricted to be a multiple of the identity.

mvnXXI

computes the best fitting Gaussian with the covariance restricted to be diagonal.

mvnXXX

computes the best fitting Gaussian with ellipsoidal (unrestricted) covariance.

Value

A list including the following components:

modelName

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

parameters
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.

loglik

The log likelihood for the data in the mixture model.

Attributes:

"WARNING" An appropriate warning if problems are encountered in the computations.

See Also

mvn, mstepE

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
## Not run: 
n <- 1000

set.seed(0)
x <- rnorm(n, mean = -1, sd = 2)
mvnX(x) 

mu <- c(-1, 0, 1)

set.seed(0)
x <- sweep(matrix(rnorm(n*3), n, 3) %*% (2*diag(3)), 
           MARGIN = 2, STATS = mu, FUN = "+")
mvnXII(x) 

set.seed(0)
x <- sweep(matrix(rnorm(n*3), n, 3) %*% diag(1:3), 
           MARGIN = 2, STATS = mu, FUN = "+")
mvnXXI(x)

Sigma <- matrix(c(9,-4,1,-4,9,4,1,4,9), 3, 3)
set.seed(0)
x <- sweep(matrix(rnorm(n*3), n, 3) %*% chol(Sigma), 
           MARGIN = 2, STATS = mu, FUN = "+")
mvnXXX(x) 

## End(Not run)

Example output

Package 'mclust' version 5.3
Type 'citation("mclust")' for citing this R package in publications.
$modelName
[1] "X"

$prior
NULL

$n
[1] 1000

$d
[1] 1

$G
[1] 1

$parameters
$parameters$pro
[1] 1

$parameters$mean
[1] -1.031659

$parameters$variance
$parameters$variance$modelName
[1] "X"

$parameters$variance$d
[1] 1

$parameters$variance$G
[1] 1

$parameters$variance$sigmasq
[1] 3.980071



$loglik
[1] -2109.588

attr(,"returnCode")
[1] 0
$modelName
[1] "XII"

$prior
NULL

$n
[1] 1000

$d
[1] 3

$G
[1] 1

$parameters
$parameters$pro
[1] 1

$parameters$mean
            [,1]
[1,] -1.03165915
[2,] -0.04957289
[3,]  1.13628546

$parameters$variance
$parameters$variance$modelName
[1] "XII"

$parameters$variance$d
[1] 3

$parameters$variance$G
[1] 1

$parameters$variance$sigmasq
[1] 3.963291

$parameters$variance$Sigma
         [,1]     [,2]     [,3]
[1,] 3.963291 0.000000 0.000000
[2,] 0.000000 3.963291 0.000000
[3,] 0.000000 0.000000 3.963291

$parameters$variance$sigma
, , 1

         [,1]     [,2]     [,3]
[1,] 3.963291 0.000000 0.000000
[2,] 0.000000 3.963291 0.000000
[3,] 0.000000 0.000000 3.963291


$parameters$variance$scale
[1] 3.963291



$loglik
[1] -6322.428

attr(,"returnCode")
[1] 0
$modelName
[1] "XXI"

$prior
NULL

$n
[1] 1000

$d
[1] 3

$G
[1] 1

$parameters
$parameters$pro
[1] 1

$parameters$mean
            [,1]
[1,] -1.01582957
[2,] -0.04957289
[3,]  1.20442820

$parameters$variance
$parameters$variance$modelName
[1] "XXI"

$parameters$variance$d
[1] 3

$parameters$variance$G
[1] 1

$parameters$variance$Sigma
          [,1]    [,2]     [,3]
[1,] 0.9950176 0.00000 0.000000
[2,] 0.0000000 4.27032 0.000000
[3,] 0.0000000 0.00000 8.188836

$parameters$variance$sigma
, , 1

          [,1]    [,2]     [,3]
[1,] 0.9950176 0.00000 0.000000
[2,] 0.0000000 4.27032 0.000000
[3,] 0.0000000 0.00000 8.188836


$parameters$variance$scale
[1] 3.264659

$parameters$variance$shape
[1] 0.3047846 1.3080448 2.5083282



$loglik
[1] -6031.548

attr(,"returnCode")
[1] 0
$modelName
[1] "XXX"

$prior
NULL

$n
[1] 1000

$d
[1] 3

$G
[1] 1

$parameters
$parameters$pro
[1] 1

$parameters$mean
            [,1]
[1,] -1.04748872
[2,] -0.04550547
[3,]  1.12277306

$parameters$variance
$parameters$variance$modelName
[1] "XXX"

$parameters$variance$d
[1] 3

$parameters$variance$G
[1] 1

$parameters$variance$Sigma
          [,1]      [,2]     [,3]
[1,]  8.955159 -4.084953 1.015574
[2,] -4.084953  9.572449 4.417112
[3,]  1.015574  4.417112 8.800769

$parameters$variance$cholSigma
         [,1]      [,2]       [,3]
[1,] 2.992517 -1.365056  0.3393713
[2,] 0.000000 -2.776521 -1.7577291
[3,] 0.000000  0.000000 -2.3655833

$parameters$variance$cholsigma
         [,1]      [,2]       [,3]
[1,] 2.992517 -1.365056  0.3393713
[2,] 0.000000 -2.776521 -1.7577291
[3,] 0.000000  0.000000 -2.3655833

$parameters$variance$sigma
, , 1

          [,1]      [,2]     [,3]
[1,]  8.955159 -4.084953 1.015574
[2,] -4.084953  9.572449 4.417112
[3,]  1.015574  4.417112 8.800769




$loglik
[1] -7235.154

attr(,"returnCode")
[1] 0

mclust documentation built on Nov. 22, 2017, 5:05 p.m.