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, effect=NULL, 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 (particularly if doing describeBy or StatsBy plots).
`se` | Source of a standard error
`group` | A grouping variable, if desired. Will group the data on group for one variable (var)
`sd` | if FALSE, confidence intervals in terms of standard errors, otherwise draw one standard deviation
`effect` | Should the data be compared to a specified group (with mean set to 0) in effect size units?
`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 https://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], xlab="Mean score for the item")

    error.dots(ability,eyes=TRUE, xlab="Mean score for the item")

[Package psych version 1.8.4 Index]