ANTsR (version 0.7.2.0)

sparseDistanceMatrix: Create sparse distance, covariance or correlation matrix

Description

Exploit k-nearest neighbor algorithms to estimate a sparse similarity matrix. Critical to the validity of this function is the basic mathematical relationships between euclidean distance and correlation and between correlation and covariance. For applications of such matrices, one may see relevant publications by Mauro Maggioni and other authors.

Usage

sparseDistanceMatrix(x, k = 3, r = Inf, sigma = NA,
  kmetric = c("euclidean", "correlation", "covariance", "gaussian"),
  eps = 1e-06, ncores = NA, sinkhorn = TRUE)

Arguments

x

input matrix, should be n (samples) by p (measurements)

k

number of neighbors

r

radius of epsilon-ball

sigma

parameter for kernel PCA.

kmetric

similarity or distance metric determining k nearest neighbors

eps

epsilon error for rapid knn

ncores

number of cores to use

sinkhorn

boolean

Value

matrix sparse p by p matrix is output with p by k nonzero entries

References

http://www.math.jhu.edu/~mauro/multiscaledatageometry.html

Examples

# NOT RUN {
mat = matrix( rnorm(60), ncol=10 )
smat = sparseDistanceMatrix( mat, 2 )
r16 = antsImageRead( getANTsRData( 'r16' ) )
mask = getMask( r16 )
mat <- getNeighborhoodInMask(image = r16, mask = mask, radius = c(0,0),
  physical.coordinates=TRUE, spatial.info=TRUE )
smat = sparseDistanceMatrix( t(mat$indices), 10 ) # close points
# }