lines {tutoR}R Documentation

Add Connected Line Segments to a Plot - tutoR mask

Description

A generic function taking coordinates given in various ways and joining the corresponding points with line segments.

Usage

lines(x, y, ...)

Arguments

x, y coordinate vectors of points to join.
... Further parameters are as follows.
type: character indicating the type of plotting; actually any of the types as in plot.
col: color to use. This can be vector of length greater than one, but only the first value will be used for lines (but all will be used for symbols).
lty: line type to use.
...: Further graphical parameters (see par) may also be supplied as arguments, particularly, line width, lwd and, for type = "b", pch.

Details

The tutoR mask for lines validates inputs received, as with the tutoR plot() mask.

The coordinates can be passed to lines in a plotting structure (a list with x and y components), a time series, etc. See xy.coords.

The coordinates can contain NA values. If a point contains NA in either its x or y value, it is omitted from the plot, and lines are not drawn to or from such points. Thus missing values can be used to achieve breaks in lines.

For type = "h", col can be a vector and will be recycled as needed.

lwd can be a vector: its first element will apply to lines but the whole vector to symbols (recycled as necessary).

References

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

See Also

lines.default, points, particularly for type %in% c("p","b","o"), plot, and the underlying “primitive” plot.xy.

par for how to specify colors.

Examples

# draw a smooth line through a scatter plot
plot(cars, main="Stopping Distance versus Speed")
lines(lowess(cars))

[Package tutoR version 0.3.2 Index]