| dists {cba} | R Documentation |
This function computes and return the auto-distance matrix between the rows of a matrix, as well as the cross-distance matrix between two matrices.
dists(x, y = NULL, method = "minkowski", p = 2)
x |
a numeric matrix object |
y |
NULL, or a numeric matrix object |
method |
a mnemonic string referencing the distance measure |
p |
Minkowski metric parameter |
The interface is fashioned after dist: you have to specify a
method to use, i.e. a (not so) mnemonic name.
Methods that are also implemented in dist are:
minkowski, maximum, canberra, and binary.
See the documentation there. Note that for binary the
arguments x (and y) must be logical.
Additional methods implemented are:
ebinary:fbinary:angular:
Missing values are allowed but are excluded from all computations
involving the rows within which they occur. However, rows (and columns)
of NAs are not dropped as in dist.
For compatibility the distance is zero instead of NA in the case
two (near) zero vectors are involved in the computation of binary,
ebinary, and angular. Note that this is inconsistent with
the coding of NA by as.dummy.
Auto distances are returned as an object of class dist and
cross-distances as an object of class matrix.
The interface is experimental and may change in the future.
Christian Buchta
dist for compatibility information.
### binary data x <- matrix(sample(c(FALSE,TRUE),8,rep=TRUE), ncol=2) dists(x, method="binary") ### for real-valued data dists(x, method="ebinary") ### for positive real-valued data dists(x, method="fbinary") ### cross distances dists(x, x, method="binary") ### this is the same but less efficient as.matrix(dists(x, method="binary"))