abline               package:graphics               R Documentation

_A_d_d _a _S_t_r_a_i_g_h_t _L_i_n_e _t_o _a _P_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     This function adds one or more straight lines through the current
     plot.

_U_s_a_g_e:

     abline(a, b, untf = FALSE, ...)
     abline(h=, untf = FALSE, ...)
     abline(v=, untf = FALSE, ...)
     abline(coef=, untf = FALSE, ...)
     abline(reg=, untf = FALSE, ...)

_A_r_g_u_m_e_n_t_s:

     a,b: the intercept and slope.

    untf: logical asking to _untransform_.  See Details.

       h: the y-value for a horizontal line.

       v: the x-value for a vertical line.

    coef: a vector of length two giving the intercept and slope.

     reg: an object with a 'coef' component. See Details.

     ...: graphical parameters.

_D_e_t_a_i_l_s:

     The first form specifies the line in intercept/slope form
     (alternatively 'a' can be specified on its own and is taken to
     contain the slope and intercept in vector form).

     The 'h=' and 'v=' forms draw horizontal and vertical lines at the
     specified coordinates.

     The 'coef' form specifies the line by a vector containing the
     slope and intercept.

     'reg' is a regression object which contains '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 '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 'h' and 'v' parameters always refer to original coordinates.

     The graphical parameters 'col' and 'lty' can be specified as
     arguments to 'abline'; see 'par' for details.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

_S_e_e _A_l_s_o:

     'lines' and 'segments' for connected and arbitrary lines given by
     their _endpoints_. 'par'.

_E_x_a_m_p_l_e_s:

     z <- lm(dist ~ speed, data = cars)
     plot(cars)
     abline(z)

