arrows {graphics} R Documentation

## Add Arrows to a Plot

### Description

Draw arrows between pairs of points.

### Usage

```arrows(x0, y0, x1, y1, length = 0.25, angle = 30, code = 2,
col = par("fg"), lty = NULL, lwd = par("lwd"), xpd = NULL)
```

### Arguments

 `x0, y0` coordinates of points from which to draw. `x1, y1` coordinates of points to which to draw. `length` length of the edges of the arrow head (in inches). `angle` angle from the shaft of the arrow to the edge of the arrow head. `code` integer code, determining kind of arrows to be drawn. `col, lty, lwd, xpd` graphical parameters as in `par`.

### Details

For each `i`, an arrow is drawn between the point ```(x0[i], y0[i])``` and the point `(x1[i],y1[i])`.

If `code=1` an arrowhead is drawn at `(x0[i],y0[i])` and if `code=2` an arrowhead is drawn at `(x1[i],y1[i])`. If `code=3` a head is drawn at both ends of the arrow. Unless `length = 0`, when no head is drawn.

The graphical parameters `col`, `lty` and `lwd` can be vectors of length greater than one and will be recycled if necessary. `NA` values of `col` are replaced by `par("col")`.

The direction of a zero-length arrow is indeterminate, and hence so is the direction of the arrowheads. To allow for rounding error, arrowheads are omitted (with a warning) on any arrow of length less than 1/1000 inch.

### Note

The first four arguments in the comparable S function are named `x1,y1,x2,y2`.

### References

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

`segments` to draw segments.

### 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 graphics version 2.2.1 Index]