Mean and covariance of incomplete multivariate normal data
ecmnmle( with no output arguments,
this mode displays the convergence of the ECM algorithm in a plot by estimating
objective function values for each iteration of the ECM algorithm until termination.
estimates the mean and covariance of a data set (
Covariance] = ecmnmle(
Data). If the
data set has missing values, this routine implements the ECM algorithm of Meng and
Rubin  with enhancements by Sexton and Swensen . ECM stands for a conditional
maximization form of the EM algorithm of Dempster, Laird, and Rubin .
Compute Mean and Covariance of Incomplete Multivariate Normal Data
This example shows how to compute the mean and covariance of incomplete multivariate normal data for five years of daily total return data for 12 computer technology stocks, with six hardware and six software companies
The time period for this data extends from April 19, 2000 to April 18, 2005. The sixth stock in Assets is Google (GOOG), which started trading on August 19, 2004. So, all returns before August 20, 2004 are missing and represented as
NaNs. Also, Amazon (AMZN) had a few days with missing values scattered throughout the past five years.
ans = 12×1 0.0008 0.0008 -0.0005 0.0002 0.0011 0.0038 -0.0003 -0.0000 -0.0003 -0.0000 ⋮
This plot shows that, even with almost 87% of the Google data being
NaN values, the algorithm converges after only four iterations.
[Mean,Covariance] = ecmnmle(Data)
Mean = 12×1 0.0008 0.0008 -0.0005 0.0002 0.0011 0.0038 -0.0003 -0.0000 -0.0003 -0.0000 ⋮
Covariance = 12×12 0.0012 0.0005 0.0006 0.0005 0.0005 0.0003 0.0005 0.0003 0.0006 0.0003 0.0005 0.0006 0.0005 0.0024 0.0007 0.0006 0.0010 0.0004 0.0005 0.0003 0.0006 0.0004 0.0006 0.0012 0.0006 0.0007 0.0013 0.0007 0.0007 0.0003 0.0006 0.0004 0.0008 0.0005 0.0008 0.0008 0.0005 0.0006 0.0007 0.0009 0.0006 0.0002 0.0005 0.0003 0.0007 0.0004 0.0005 0.0007 0.0005 0.0010 0.0007 0.0006 0.0016 0.0006 0.0005 0.0003 0.0006 0.0004 0.0007 0.0011 0.0003 0.0004 0.0003 0.0002 0.0006 0.0022 0.0001 0.0002 0.0002 0.0001 0.0003 0.0016 0.0005 0.0005 0.0006 0.0005 0.0005 0.0001 0.0009 0.0003 0.0005 0.0004 0.0005 0.0006 0.0003 0.0003 0.0004 0.0003 0.0003 0.0002 0.0003 0.0005 0.0004 0.0003 0.0004 0.0004 0.0006 0.0006 0.0008 0.0007 0.0006 0.0002 0.0005 0.0004 0.0011 0.0005 0.0007 0.0007 0.0003 0.0004 0.0005 0.0004 0.0004 0.0001 0.0004 0.0003 0.0005 0.0006 0.0004 0.0005 ⋮
Data — Data
Data, specified as an
NUMSAMPLES samples of a
NUMSERIES-dimensional random vector. Missing values are
InitMethod — Initialization methods to compute initial estimates for mean and covariance of data
'nanskip' (default) | character vector
(Optional) Initialization methods to compute the initial estimates for the mean and covariance of data, specified as a character vector. The initialization methods are:
'nanskip'— Skip all records with
'twostage'— Estimate mean. Fill
NaNs with the mean. Then estimate the covariance.
'diagonal'— Form a diagonal covariance.
MaxIterations — Maximum number of iterations
50 (default) | numeric
(Optional) Maximum number of iterations for the expectation conditional maximization (ECM) algorithm, specified as a numeric.
Tolerance — Convergence tolerance
1.0e-8 (default) | numeric
(Optional) Convergence tolerance for the ECM algorithm, specified as a
maximum iterations specified by
MaxIterations and do
not evaluate the objective function at each step unless in display
Covar0 — Estimate for the covariance
 (default) | matrix
Mean — Maximum likelihood parameter estimates for mean of
Maximum likelihood parameter estimates for the mean of the
Data using ECM algorithm, returned as a
1 column vector.
Covariance — Maximum likelihood parameter estimates for covariance of
Maximum likelihood parameter estimates for the covariance of the
Data using ECM algorithm, returned as a
The general model is
where each row of
Data is an observation of
Each observation of Z is assumed to be iid (independent, identically distributed) multivariate normal, and missing values are assumed to be missing at random (MAR). See Little and Rubin  for a precise definition of MAR.
This routine estimates the mean and covariance from given data. If data values are missing, the routine implements the ECM algorithm of Meng and Rubin  with enhancements by Sexton and Swensen .
If a record is empty (every value in a sample is
routine ignores the record because it contributes no information. If such records
exist in the data, the number of nonempty samples used in the estimation is ≤
The estimate for the covariance is a biased maximum likelihood estimate (MLE). To
convert to an unbiased estimate, multiply the covariance by
Count – 1), where
Count is the number of nonempty samples used in the
This routine requires consistent values for
NUMSERIES. It must have enough nonmissing values to converge.
Finally, it must have a positive-definite covariance matrix. Although the references
provide some necessary and sufficient conditions, general conditions for existence
and uniqueness of solutions in the missing-data case, do not exist. The main failure
mode is an ill-conditioned covariance matrix estimate. Nonetheless, this routine
works for most cases that have less than 15% missing data (a typical upper bound for
This routine has three initialization methods that cover most cases, each with its advantages and disadvantages. The ECM algorithm always converges to a minimum of the observed negative log-likelihood function. If you override the initialization methods, you must ensure that the initial estimate for the covariance matrix is positive-definite.
The following is a guide to the supported initialization methods.
nanskipmethod works well with small problems (fewer than 10 series or with monotone missing data patterns). It skips over any records with
NaNs and estimates initial values from complete-data records only. This initialization method tends to yield fastest convergence of the ECM algorithm. This routine switches to the
twostagemethod if it determines that significant numbers of records contain
twostagemethod is the best choice for large problems (more than 10 series). It estimates the mean for each series using all available data for each series. It then estimates the covariance matrix with missing values treated as equal to the mean rather than as
NaNs. This initialization method is robust but tends to result in slower convergence of the ECM algorithm.
diagonalmethod is a worst-case approach that deals with problematic data, such as disjoint series and excessive missing data (more than 33% of data missing). Of the three initialization methods, this method causes the slowest convergence of the ECM algorithm. If problems occur with this method, use display mode to examine convergence and modify either
Tolerance, or try alternative initial estimates with
Covar0. If all else fails, try
Mean0 = zeros(NumSeries); Covar0 = eye(NumSeries,NumSeries);
Given estimates for mean and covariance from this routine, you can estimate standard errors with the companion routine
The ECM algorithm does not work for all patterns of missing values. Although it works in most cases, it can fail to converge if the covariance becomes singular. If this occurs, plots of the log-likelihood function tend to have a constant upward slope over many iterations as the log of the negative determinant of the covariance goes to zero. In some cases, the objective fails to converge due to machine precision errors. No general theory of missing data patterns exists to determine these cases. An example of a known failure occurs when two time series are proportional wherever both series contain nonmissing values.
 Little, Roderick J. A. and Donald B. Rubin. Statistical Analysis with Missing Data. 2nd Edition. John Wiley & Sons, Inc., 2002.
 Meng, Xiao-Li and Donald B. Rubin. “Maximum Likelihood Estimation via the ECM Algorithm.” Biometrika. Vol. 80, No. 2, 1993, pp. 267–278.
 Sexton, Joe and Anders Rygh Swensen. “ECM Algorithms that Converge at the Rate of EM.” Biometrika. Vol. 87, No. 3, 2000, pp. 651–662.
 Dempster, A. P., N. M. Laird, and Donald B. Rubin. “Maximum Likelihood from Incomplete Data via the EM Algorithm.” Journal of the Royal Statistical Society. Series B, Vol. 39, No. 1, 1977, pp. 1–37.
Introduced before R2006a