R: Show a dot.chart with error bars for different groups or...

error.dots {psych} | R Documentation

## Show a dot.chart with error bars for different groups or variables

### Description

Yet one more of the graphical ways of showing data with error bars for different groups. A dot.chart with error bars for different groups or variables is found using from `describe`, `describeBy`, or `statsBy`.

### Usage

    error.dots(x, var = NULL, se = NULL, group = NULL, sd = FALSE, head = 12, tail = 12,
     sort = TRUE, decreasing = TRUE, main = NULL, alpha = 0.05, eyes = FALSE, min.n = NULL,
     max.labels = 40, labels = NULL, groups = NULL, gdata = NULL, cex = par("cex"),
      pt.cex = cex, pch = 21, gpch = 21, bg = par("bg"), color = par("fg"),
       gcolor = par("fg"), lcolor = "gray", xlab = NULL, ylab = NULL, xlim = NULL, ...)

### Arguments

`x` | A data frame or matrix of raw data, or the resulting object from `describe`, `describeBy`, or `statsBy`
`var` | The variable to show
`se` | Source of a standard error
`group` | A grouping variable, if desired. Not implemented.
`sd` | if FALSE, confidence intervals in terms of standard errors, otherwise draw one standard deviation
`head` | The number of largest values to report
`tail` | The number of smallest values to report
`sort` | Sort the groups/variables by value
`decreasing` | Should they be sorted in increasing or decreasing order (from top to bottom)
`main` | The caption for the figure
`alpha` | p value for confidence intervals
`eyes` | Draw catseyes for error limits
`min.n` | If using describeBy or statsBy, what should be the minimum sample size to draw
`max.labels` | Length of labels (truncate after this value)
`labels` | Specify the labels versus find them from the row names
`groups` | ignored
`gdata` | ignored
`cex` | The standard meaning of cex for graphics
`pt.cex` | ignored
`pch` | Plot character
`gpch` | ignored
`bg` | background color
`color` | Color
`gcolor` | ignored
`lcolor` | ignored?
`xlab` | Label the x axis, if NULL, the variable name is used
`ylab` | If NULL, then the group rownames are used
`xlim` | If NULL, then calculated to show nice values
`...` | And any other graphic parameters we have forgotten

### Details

Adapted from the dot.chart function to include error bars and to use the output of`describe`, `describeBy`, and `statsBy` To speed up multiple plots, the function can work from the output of a previous run. Thus describeBy will be done and the results can be show for multiple variables

### Value

Returns (invisibily) either a describeBy or describe object

### Author(s)

William Revelle

### References

Used in particular for showing http:\sapa-project.org output.

### See Also

`describe`, `describeBy`, or `statsBy` as well as `error.bars`, `error.bars.by`, or `statsBy`

### Examples

    error.dots(bfi[1:25])

[Package psych version 1.7.8 Index]