Rdimtools (version 1.0.0)

do.dve: Distinguishing Variance Embedding

Description

Distinguishing Variance Embedding (DVE) is an unsupervised nonlinear manifold learning method. It can be considered as a balancing method between Maximum Variance Unfolding and Laplacian Eigenmaps. The algorithm unfolds the data by maximizing the global variance subject to the locality-preserving constraint. Instead of defining certain kernel, it applies local scaling scheme in that it automatically computes adaptive neighborhood-based kernel bandwidth.

Usage

do.dve(
  X,
  ndim = 2,
  type = c("proportion", 0.1),
  preprocess = c("null", "center", "scale", "cscale", "decorrelate", "whiten")
)

Arguments

X

an \((n\times p)\) matrix or data frame whose rows are observations and columns represent independent variables.

ndim

an integer-valued target dimension.

type

a vector of neighborhood graph construction. Following types are supported; c("knn",k), c("enn",radius), and c("proportion",ratio). Default is c("proportion",0.1), connecting about 1/10 of nearest data points among all data points. See also aux.graphnbd for more details.

preprocess

an additional option for preprocessing the data. Default is "null". See also aux.preprocess for more details.

Value

a named list containing

Y

an \((n\times ndim)\) matrix whose rows are embedded observations.

trfinfo

a list containing information for out-of-sample prediction.

References

wang_combining_2009Rdimtools

qinggang_distinguishing_2010Rdimtools

Examples

# NOT RUN {
## generate swiss-roll dataset of size 200
X <- aux.gensamples(dname="crown",n=200)

## try different nbd size
out1 <- do.dve(X, type=c("proportion",0.4))
out2 <- do.dve(X, type=c("proportion",0.6))
out3 <- do.dve(X, type=c("proportion",0.8))

## Visualize
opar <- par(no.readonly=TRUE)
par(mfrow=c(1,3))
plot(out1$Y, main="DVE::20% connected")
plot(out2$Y, main="DVE::50% connected")
plot(out3$Y, main="DVE::80% connected")
par(opar)
# }
# NOT RUN {
# }