lines {graphics} | R Documentation |

## Add Connected Line Segments to a Plot

### Description

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

### Usage

lines(x, ...)
## Default S3 method:
lines(x, y = NULL, type = "l", col = par("col"),
lty = par("lty"), ...)

### Arguments

`x, y` |
coordinate vectors of points to join. |

`type` |
character indicating the type of plotting; actually any of
the `type` s 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 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

`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

*graphics* version 2.2.1

Index]