mvee_REX {OptimalDesign} | R Documentation |
Minimum-volume enclosing ellipsoid
Description
Computes the shape matrix H
and the center z
of the minimum-volume ellipsoid enclosing a finite set of data-points.
Usage
mvee_REX(Data, alg.AA="REX", eff=0.999999, it.max=Inf, t.max=60,
picture=FALSE, echo=TRUE, track=TRUE)
Arguments
Data |
the |
alg.AA |
the underlying computational method for approximate D-optimal design; possible values are |
eff |
the minimum required efficiency. |
it.max |
a limit on the number of iterations of the underlying D-optimum approximate design algorithm. |
t.max |
a limit on the time of computation. |
picture |
Should a picture be plotted? (For the picture, the data need to be either two- or three-dimensional.) |
echo |
Print the call of the function? |
track |
Display the progress of the computation? |
Details
The problem of the minimum-volume data-enclosing ellipsoid (MVEE) is computationally equivalent to the problem of D-optimal approximate design for an artificial problem based on the data. This procedure performs the computation and the proper conversion of the D-optimal approximate design to the MVEE parameters (the center and the shape matrix).
Value
Output is a list with components:
call |
the call of the function |
H |
the shape matrix of the MVEE |
z |
the center of the MVEE |
bpts |
a set containing the boundary points of the MVEE |
vol |
the volume of the MVEE |
eff.best |
the actual precision of the result (1 is the perfect precision) |
t.iter |
the number of iterations of the underlying D-optimum design algorithm |
t.act |
the actual time of the computation |
Note
Note: The affine hull of the rows of X
should be the full space of dimension d
. For the choice of the algorithm, see the comments in od_REX
.
Author(s)
Radoslav Harman, Lenka Filova
References
Harman R, Filova L, Richtarik P (2019). A randomized exchange algorithm for computing optimal approximate designs of experiments. Journal of the American Statistical Association, 1-30.
See Also
Examples
# Generate random 1000 points in a 3-dimensional space
# and compute the MVEE
Data <- matrix(rnorm(3000), ncol = 3)
mvee_REX(Data, picture = FALSE)