segments {graphics}R Documentation

Add Line Segments to a Plot

Description

Draw line segments between pairs of points.

Usage

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

Arguments

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.
... further graphical parameters (from par).

Details

For each i, a line segment is drawn between the point (x0[i], y0[i]) and the point (x1[i],y1[i]).

The graphical parameters col and lty can be used to specify a color and line texture for the line segments (col may be a vector).

References

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

See Also

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

Examples

x <- runif(12); y <- 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')

[Package Contents]