R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Add Error Bars to an Existing Plot

ErrBars

R Documentation

Add Error Bars to an Existing Plot

Description

Add error bars to an existing plot.

Usage

ErrBars(from, to = NULL, pos = NULL, mid = NULL, horiz = FALSE, col = par("fg"), 
        lty = par("lty"), lwd = par("lwd"), code = 3, length = 0.05,
        pch = NA, cex.pch = par("cex"), col.pch = par("fg"), bg.pch = par("bg"),
        ...)

Arguments

`from`	coordinates of points from which to draw (the lower end of the error bars). If `to` is left to `NULL` and `from` is a k x 2 dimensional matrix, the first column will be interpreted as `from` and the second as `to`.
`to`	coordinates of points to which to draw (the upper end of the error bars).
`pos`	numeric, position of the error bars. This will either be the x-coordinate in case of vertical error bars and the y-coordinate in case of horizontal error bars.
`mid`	numeric, position of midpoints. Defaults to the mean of `from` and `to`.
`horiz`	logical, determining whether horizontal error bars are needed (default is FALSE).
`col`	the line color.
`lty`	the line type.
`lwd`	line width.
`code`	integer code, determining kind of arrows to be drawn. 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` (default) a head is drawn at both ends of the arrow. Unless `length = 0`, when no head is drawn.
`length`	the length of the end lines.
`pch`	plotting character for the midpoints. The position of the points is given by `mid`. If `mid` is left to `NULL` the points will be plotted in the middle of `from` and `to`. No points will be plotted if this is set to NA, which is the default.
`cex.pch`	the character extension for the plotting characters. Default is `par("cex")`.
`col.pch`	the color of the plotting characters. Default is `par("fg")`.
`bg.pch`	the background color of the plotting characters (if pch is set to 21:25). Default is `par("bg")`.
`...`	the dots are passed to the `arrows` function.

Details

A short wrapper for plotting error bars by means of arrows.

Author(s)

Andri Signorell <andri@signorell.net>

Examples


par(mfrow=c(2,2))
b <- barplot(1:5, ylim=c(0,6))
ErrBars(from=1:5-rep(0.5,5), to=1:5+rep(0.5,5), pos=b, length=0.2)

# just on one side
b <- barplot(1:5, ylim=c(0,6))
ErrBars(from=1:5, to=1:5+rep(0.5,5), pos=b, length=0.2, col="red", code=2, lwd=2)

b <- barplot(1:5, xlim=c(0,6), horiz=TRUE)
ErrBars(from=1:5, to=1:5+rep(0.2,5), pos=b, horiz=TRUE,  length=0.2, col="red", code=2, lwd=2)

par(xpd=FALSE)
dotchart(1:5, xlim=c(0,6))
ErrBars(from=1:5-rep(0.2,5), to=1:5+rep(0.2,5), horiz=TRUE, length=0.1)

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(DescTools)
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/DescTools/ErrBars.Rd_%03d_medium.png", width=480, height=480)
> ### Name: ErrBars
> ### Title: Add Error Bars to an Existing Plot
> ### Aliases: ErrBars
> ### Keywords: aplot
> 
> ### ** Examples
> 
> 
> par(mfrow=c(2,2))
> b <- barplot(1:5, ylim=c(0,6))
> ErrBars(from=1:5-rep(0.5,5), to=1:5+rep(0.5,5), pos=b, length=0.2)
> 
> # just on one side
> b <- barplot(1:5, ylim=c(0,6))
> ErrBars(from=1:5, to=1:5+rep(0.5,5), pos=b, length=0.2, col="red", code=2, lwd=2)
> 
> b <- barplot(1:5, xlim=c(0,6), horiz=TRUE)
> ErrBars(from=1:5, to=1:5+rep(0.2,5), pos=b, horiz=TRUE,  length=0.2, col="red", code=2, lwd=2)
> 
> par(xpd=FALSE)
> dotchart(1:5, xlim=c(0,6))
> ErrBars(from=1:5-rep(0.2,5), to=1:5+rep(0.2,5), horiz=TRUE, length=0.1)
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>