\HeaderA{isoMDS}{Kruskal's Non-metric Multidimensional Scaling}{isoMDS}
\aliasA{Shepard}{isoMDS}{Shepard}
\keyword{multivariate}{isoMDS}
\begin{Description}\relax
One form of non-metric multidimensional scaling
\end{Description}
\begin{Usage}
\begin{verbatim}
isoMDS(d, y = cmdscale(d, k), k = 2, maxit = 50, trace = TRUE,
       tol = 1e-3, p = 2)

Shepard(d, x, p = 2)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{d}] distance structure of the form returned by \code{dist}, or a full,
symmetric matrix.  Data are assumed to be dissimilarities or relative
distances, but must be positive except for self-distance.  Both
missing and infinite values are allowed.

\item[\code{y}] An initial configuration. If none is supplied, \code{cmdscale} is used
to provide the classical solution, unless there are missing or
infinite dissimilarities.

\item[\code{k}] The desired dimension for the solution, passed to \code{cmdscale}.

\item[\code{maxit}] The maximum number of iterations.

\item[\code{trace}] Logical for tracing optimization. Default \code{TRUE}.

\item[\code{tol}] convergence tolerance.

\item[\code{p}] Power for Minkowski distance in the configuration space.
\item[\code{x}] A final configuration.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This chooses a k-dimensional (default k = 2) configuration to minimize
the stress, the square root of the ratio of the sum of squared
differences between the input distances and those of the configuration
to the sum of configuration distances squared. However, the input
distances are allowed a monotonic transformation.

An iterative algorithm is used, which will usually converge in around
10 iterations. As this is necessarily an \eqn{O(n^2)}{} calculation, it is slow
for large datasets. Further, since for the default \eqn{p = 2}{}
the configuration is only determined
up to rotations and reflections (by convention the centroid is at the
origin), the result can vary considerably from machine to machine.
\end{Details}
\begin{Value}
Two components:

\begin{ldescription}
\item[\code{points}] A two-column vector of the fitted configuration.

\item[\code{stress}] The final stress achieved (in percent).

\end{ldescription}
\end{Value}
\begin{Section}{Side Effects}
If \code{trace} is true, the initial stress and the current stress
are printed out every 5 iterations.
\end{Section}
\begin{References}\relax
T. F. Cox and M. A. A. Cox (1994, 2001)
\emph{Multidimensional Scaling}. Chapman \& Hall.

Ripley, B. D. (1996)
\emph{Pattern Recognition and Neural Networks}. Cambridge University Press.

Venables, W. N. and Ripley, B. D. (2002)
\emph{Modern Applied Statistics with S.} Fourth edition.  Springer.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{cmdscale}{cmdscale}}, \code{\LinkA{sammon}{sammon}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(swiss)
swiss.x <- as.matrix(swiss[, -1])
swiss.dist <- dist(swiss.x)
swiss.mds <- isoMDS(swiss.dist)
plot(swiss.mds$points, type = "n")
text(swiss.mds$points, labels = as.character(1:nrow(swiss.x)))
swiss.sh <- Shepard(swiss.dist, swiss.mds$points)
plot(swiss.sh, pch = ".")
lines(swiss.sh$x, swiss.sh$yf, type = "S")
\end{ExampleCode}
\end{Examples}

