\HeaderA{data.matrix}{Data Frame to Numeric Matrix}{data.matrix}
\keyword{array}{data.matrix}
\begin{Description}\relax
Return the matrix obtained by converting all the variables in a data
frame to numeric mode and then binding them together as the columns of
a matrix.  Factors and ordered factors are replaced by their internal
codes.
\end{Description}
\begin{Usage}
\begin{verbatim}
data.matrix(frame)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{frame}] a data frame whose components are logical vectors,
factors or numeric vectors.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Supplying a data frame with columns which are not numeric, factor or logical
is an error.  A warning is given if any non-factor column has a class,
as then information can be lost.
\end{Details}
\begin{Value}
If \code{frame} is a data frame, a numeric matrix of the same
dimensions as \code{frame}, with dimnames taken from the row.names and
names.

Otherwise, the result of \code{\LinkA{as.matrix}{as.matrix}}.
\end{Value}
\begin{References}\relax
Chambers, J. M. (1992)
\emph{Data for models.}
Chapter 3 of \emph{Statistical Models in S}
eds J. M. Chambers and T. J. Hastie, Wadsworth \& Brooks/Cole.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{as.matrix}{as.matrix}},
\code{\LinkA{data.frame}{data.frame}},
\code{\LinkA{matrix}{matrix}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
DF <- data.frame(a=1:3, b=letters[10:12],
                 c=seq(as.Date("2004-01-01"), by = "week", len = 3))
data.matrix(DF[1:2])
data.matrix(DF) # gives a warning and quotes dates as #days since 1970.
\end{ExampleCode}
\end{Examples}

