1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
|
\name{distratio}
\alias{distratio}
%- Also NEED an `\alias' for EACH other topic documented here.
\title{Distance ratio test statistics for distance based clustering}
\description{
Calculates the ratio between the \code{prop} smallest and largest
distances of a distance matrix.
}
\usage{
distratio(distmat, prop = 0.25)
}
%- maybe also `usage' for other objects documented here.
\arguments{
\item{distmat}{symmetric distance matrix.}
\item{prop}{numerical. Proportion between 0 and 1.}
}
\details{
Rounding is by \code{floor} for small and \code{ceiling} for large
distances.
}
\value{
A list with components
\item{dr}{ratio of \code{prop} smallest to \code{prop} largest distances.}
\item{lowmean}{mean of \code{prop} smallest distances.}
\item{himean}{mean of \code{prop} smallest distances.}
\item{prop}{see above.}
}
\references{
Hennig, C. and Hausdorf, B. (2004) Distance-based parametric bootstrap
tests for clustering of species ranges.
\emph{Computational Statistics and Data Analysis} 45, 875-896.
}
\author{Christian Hennig
\email{christian.hennig@unibo.it}
\url{https://www.unibo.it/sitoweb/christian.hennig/en}}
\seealso{\code{\link{prabtest}}}
\examples{
options(digits=4)
data(kykladspecreg)
j <- jaccard(t(kykladspecreg))
distratio(j)
}
\keyword{cluster}% at least one, from doc/KEYWORDS
% \keyword{ ~kwd2 }% __ONLY ONE__ keyword per line
|