psych (version 1.8.3.3)

error.dots: 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

Value

Returns (invisibily) either a describeBy or describe object

Details

Adapted from the dot.chart function to include error bars and to use the output ofdescribe, 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

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

# NOT RUN {
error.dots(bfi[1:25], xlab="Mean score for the item")

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

# }