ANOMgen {ANOM}

Generic Function for Drawing ANOM Decision Charts

Description

Graphical representation of the analysis of means: convert simultaneous confidence intervals (that were computed with ANY method) into ANOM decision limits and draw a decision chart as commonly used in technometrics.

Usage

ANOMgen(mu, n=NULL, gm=NULL, lo, up, names, alternative="two.sided",
        xlabel="Group", ylabel="Endpoint", printn=TRUE, p=NULL, bg="white",
        bgrid=TRUE, axlsize=18, axtsize=25, npsize=5, psize=5, lwidth=1,
        dlstyle="dashed", fillcol="darkgray")

Arguments

mu

A numeric vector of group means.

n

A numeric vector of sample sizes per group. Either n or gm must be provided.

gm

A single numeric value giving the grand mean of all groups. Either n or gm must be provided.

lo

A numeric vector of lower (simultaneous) confidence interval bounds for comparisons to the grand mean.

up

A numeric vector of upper (simultaneous) confidence interval bounds for comparisons to the grand mean.

names

An (optional) vector of characters specifying the groups' names.

alternative

A character string indicating the direction of the alternative hypothesis. Default is "two.sided", but may be changed to one-sided alternatives (either "greater" or "less").

xlabel

A character string specifying the label of the horizontal axis.

ylabel

A character string specifying the label of the vertical axis.

printn

A logical. Should per-group sample sizes be included in the chart? Default is TRUE. If n ist left at NULL, the function automatically sets printn to FALSE.

p

An (optional) numeric vector of (simultaneous) p-values to be printed.

bg

A character string. Should the plot's background be "white" (default) or "gray" (or "grey")?

bgrid

A logical. Should background grid lines be plotted? Default is TRUE.

axlsize

A numerical value specifying the font size of the axis labels. Default is 18.

axtsize

A numerical value specifying the font size of the axis titles. Default is 25.

npsize

A numerical value specifying the font size of the sample sizes and p-values (if printed). Default is 5.

psize

A numerical value specifying the size of the points (group means). Default is 5.

lwidth

A numerical value specifying the width of the lines (grand mean, decision limits, vertical connections). Default is 1.

dlstyle

A character string specifying the style of the decision limits. Default is "dashed".

fillcol

A character string specifying the color of the area of no significant deviation from the grand mean. Default is "darkgray".

Details

This is a generic tool that translates (simultaneous) confidence intervals into ANOM decision limits.

Value

An ANOM decision chart.

Note

The confidence intervals must arise from comparisons to the grand mean; otherwise the ANOM chart is meaningless!

Author(s)

Philip Pallmann [e-mail]

References

Pallmann, P. and Hothorn, L. A. (2016) Analysis of means (ANOM): A generalized approach using R. Journal of Applied Statistics, 43(8), 1541–1560.

Examples

### A toy example (n given, two-sided)
groupmeans <- c(2.8, 2.3, 3.4, 5.6)
samplesizes <- c(5, 5, 10, 5)
low <- c(-1.2, -1.7, -0.4, 1.6)
upp <- c(-0.2, -0.7, 0.2, 2.6)
names <- c("1st", "2nd", "3rd", "4th")
ANOMgen(mu=groupmeans, n=samplesizes, lo=low, up=upp, names=names, alternative="two.sided")

### Another toy example (gm given, one-sided, with p-values)
groupmeans <- c(2.8, 2.3, 3.4, 5.6)
gm <- 3.5
low <- rep(-Inf, 4)
upp <- c(-0.2, -0.7, 0.2, 2.6)
names <- c("1st", "2nd", "3rd", "4th")
pvalues <- c(0.01, 0.003, 0.8, 1)
ANOMgen(mu=groupmeans, gm=gm, lo=low, up=upp, names=names, alternative="less", p=pvalues)