segments              package:graphics              R Documentation

_A_d_d _L_i_n_e _S_e_g_m_e_n_t_s _t_o _a _P_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     Draw line segments between pairs of points.

_U_s_a_g_e:

     segments(x0, y0, x1, y1,
              col = par("fg"), lty = par("lty"), lwd = par("lwd"),
              ...)

_A_r_g_u_m_e_n_t_s:

  x0, y0: coordinates of points *from* which to draw.

  x1, y1: coordinates of points *to* which to draw.

col, lty, lwd: usual graphical parameters as in 'par', possibly
          vectors.  'NA' values in 'col' cause the segment to be
          omitted.

     ...: further graphical parameters (from 'par'), such as 'xpd' and
          the line characteristics 'lend', 'ljoin' and 'lmitre'.

_D_e_t_a_i_l_s:

     For each 'i', a line segment is drawn between the point '(x0[i],
     y0[i])' and the point '(x1[i], y1[i])'.  The coordinate vectors
     will be recycled to the length of the longest.

     The graphical parameters 'col', 'lty' and 'lwd' can be vectors of
     length greater than one and will be recycled if necessary.

_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:

     'arrows',  'polygon' for slightly easier and less flexible line
     drawing, and 'lines' for the usual polygons.

_E_x_a_m_p_l_e_s:

     x <- stats::runif(12); y <- stats::rnorm(12)
     i <- order(x,y); x <- x[i]; y <- y[i]
     plot(x, y, main="arrows(.) and segments(.)")
     ## draw arrows from point to point :
     s <- seq(length(x)-1)# one shorter than data
     arrows(x[s], y[s], x[s+1], y[s+1], col= 1:3)
     s <- s[-length(s)]
     segments(x[s], y[s], x[s+2], y[s+2], col= 'pink')