Learn R Programming

dclone (version 1.2-0)

errlines: Plot error bars

Description

The function plots error bars to existing plot.

Usage

errlines(x, ...)
## S3 method for class 'default':
errlines(x, y, type = "l", code = 0, 
width = 0, vertical = TRUE, col = 1, bg = NA, ...)

Arguments

x
Numeric vector with coordinates along the horizontal axis (if vertical = FALSE, this sets the vertical axis).
y
A matrix-like object with 2 columns for lower and upper values on the vertical axis (if vertical = FALSE, this sets the horizontal axis).
type
Character, "l" for lines, "b" for boxes to be drawn.
code
Integer code, determining kind of ticks to be drawn. See Details.
width
Numeric, width of the ticks (if type = "l") or width of the boxes (if type = "b").
vertical
Logical, if errorbars should be plotted vertically or horizontally.
col
Color of the error lines to be drawn, recicled.
bg
If type = "b" the bacground color of the boxes. By default, no background color used.
...
Other arguments passed to the function lines.

Value

  • Adds error bars to an existing plot as a side effect. Returns NULL invisibly.

Details

The errlines function uses lines to draw error bars to existing plot. If code = 0 no ticks are drawn, if code = 1, only lower ticks are drawn, if code = 2 only lower ticks are drawn, if code = 3 both lower and upper ticks are drawn.

See Also

lines, arrows, segments

Examples

Run this code
x <- 1:10
a <- rnorm(10,10)
a <- a[order(a)]
b <- runif(10)
y <- cbind(a-b, a+b+rev(b))
opar <- par(mfrow=c(2, 3))
plot(x, a, ylim = range(y))
errlines(x, y)
plot(x, a, ylim = range(y))
errlines(x, y, width = 0.5, code = 1)
plot(x, a, ylim = range(y), col = 1:10)
errlines(x, y, width = 0.5, code = 3, col = 1:10)
plot(x, a, ylim = range(y))
errlines(x, y, width = 0.5, code = 2, type = "b")
plot(x, a, ylim = range(y))
errlines(x, y, width = 0.5, code = 3, type = "b")
plot(x, a, ylim = range(y), type = "n")
errlines(x, y, width = 0.5, code = 3, type = "b", bg = 1:10)
errlines(x, cbind(a-b/2, a+b/2+rev(b)/2))
points(x, a)
par(opar)

Run the code above in your browser using DataLab