\Header{abline}{Add a Straight Line to a Plot}
\keyword{aplot}{abline}
\begin{Description}\relax
This function adds one or more straight lines through the current plot.
\end{Description}
\begin{Usage}
\begin{verbatim}
abline(a, b, untf = FALSE, ...)
abline(h=, untf = FALSE, ...)
abline(v=, untf = FALSE, ...)
abline(coef=, untf = FALSE, ...)
abline(reg=, untf = FALSE, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{a,b}] the intercept and slope.
\item[\code{untf}] logical asking to \emph{untransform}.  See Details.
\item[\code{h}] the y-value for a horizontal line.
\item[\code{v}] the x-value for a vertical line.
\item[\code{coef}] a vector of length two giving the intercept and slope.
\item[\code{reg}] an object with a \code{coef} component. See Details.
\item[\code{...}] graphical parameters.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The first form specifies the line in intercept/slope form
(alternatively \code{a} can be specified on its own and is taken to
contain the slope and intercept in vector form).

The \code{h=} and \code{v=} forms draw horizontal and vertical lines
at the specified coordinates.

The \code{coef} form specifies the line by a vector containing the
slope and intercept.

\code{reg} is a regression object which contains \code{reg\$coef}.  If
it is of length 1 then the value is taken to be the slope of a line
through the origin, otherwise, the first 2 values are taken to be the
intercept and slope.

If \code{untf} is true, and one or both axes are log-transformed, then
a curve is drawn corresponding to a line in original coordinates,
otherwise a line is drawn in the transformed coordinate system. The
\code{h} and \code{v} parameters always refer to original coordinates.

The graphical parameters \code{col} and \code{lty} can be specified as
arguments to \code{abline}; see \code{par} for details.
\end{Details}
\begin{References}\relax
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
\emph{The New S Language}.
Wadsworth \& Brooks/Cole.
\end{References}
\begin{SeeAlso}\relax
\code{\Link{lines}} and \code{\Link{segments}} for connected and
arbitrary lines given by their \emph{endpoints}.
\code{\Link{par}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(cars)
z <- lm(dist ~ speed, data = cars)
plot(cars)
abline(z)
\end{ExampleCode}
\end{Examples}

