Draw Labeled Vectors in 2D or 3D

Graphics utility functions to draw vectors from an origin to a collection of points (using arrows in 2D or lines3d in 3D) with labels for each (using text or texts3d).

Usage

vectors(
  x,
  origin = c(0, 0),
  labels = rownames(x),
  scale = 1,
  col = "blue",
  lwd = 1,
  cex = 1,
  length = 0.1,
  angle = 13,
  pos = NULL,
  ...
)

Arguments

x: A two-column matrix or a three-column matrix containing the end points of the vectors
origin: Starting point(s) for the vectors
labels: Labels for the vectors
scale: A multiplier for the length of each vector
col: color(s) for the vectors.
lwd: line width(s) for the vectors.
cex: color(s) for the vectors.
length: For vectors, length of the edges of the arrow head (in inches).
angle: For vectors, angle from the shaft of the arrow to the edge of the arrow head.
pos: For vectors, position of the text label relative to the vector head. If pos==NULL, labels are positioned labels outside, relative to arrow ends.
...: other graphical parameters, such as lty, xpd, ...

Value

None

Details

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

Author

Michael Friendly

Examples


plot(c(-3, 3), c(-3,3), type="n")
X <- matrix(rnorm(10), ncol=2)
rownames(X) <- LETTERS[1:5]
vectors(X, scale=2, col=palette())