\Header{plot.augPred}{Plot an augPred Object}
\keyword{models}{plot.augPred}
\begin{Description}\relax
A Trellis \code{xyplot} of predictions versus the primary covariate is
generated, with a different panel for each value of the grouping
factor. Predicted values are joined by lines, with  
different line types (colors) being used for each level of
grouping. Original observations are represented by circles.
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'augPred':
plot(x, key, grid, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] an object of class \code{augPred}.
\item[\code{key}] an optional logical value, or list. If \code{TRUE}, a legend
is included at the top of the plot indicating which symbols (colors)
correspond to which prediction levels. If \code{FALSE}, no legend
is included. If given as a list, \code{key} is passed down as an
argument to the \code{trellis} function generating the plots
(\code{xyplot}). Defaults to \code{TRUE}.
\item[\code{grid}] an optional logical value indicating whether a grid should
be added to plot. Default is \code{FALSE}.
\item[\code{...}] optional arguments passed down to the \code{trellis}
function generating the plots.
\end{ldescription}
\end{Arguments}
\begin{Value}
A Trellis plot of predictions versus the primary covariate, with panels
determined by the grouping factor.
\end{Value}
\begin{Author}\relax
Jose Pinheiro \email{Jose.Pinheiro@pharma.novartis.com} and Douglas Bates \email{bates@stat.wisc.edu}
\end{Author}
\begin{SeeAlso}\relax
\code{\Link{augPred}}, \code{\Link{xyplot}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(Orthodont)
fm1 <- lme(Orthodont)
plot(augPred(fm1, level = 0:1, length.out = 2))
\end{ExampleCode}
\end{Examples}

