Learn R Programming

misty (version 0.4.6)

aov.b: Between-Subject Analysis of Variance

Description

This function performs an one-way between-subject analysis of variance (ANOVA) including Tukey HSD post hoc test for multiple comparison and provides descriptive statistics, effect size measures, and a plot showing error bars for confidence intervals with jittered data points.

Usage

aov.b(formula, data, posthoc = TRUE, conf.level = 0.95, hypo = TRUE,
      descript = TRUE, effsize = FALSE, weighted = FALSE, correct = FALSE,
      plot = FALSE, point.size = 4, error.width = 0.1, xlab = NULL, ylab = NULL,
      ylim = NULL, breaks = ggplot2::waiver(), jitter = TRUE,
      jitter.size = 1.25, jitter.width = 0.05, jitter.alpha = 0.1,
      title = "",  subtitle = "Confidence Interval",
      digits = 2, p.digits = 4, as.na = NULL, check = TRUE,
      output = TRUE, ...)

Value

Returns an object of class misty.object, which is a list with following entries: function call (call), type of analysis type, list with the input specified in x

(data), specification of function arguments (args), and result table(s) (result).

Arguments

formula

a formula of the form y ~ group where y is a numeric variable giving the data values and group a numeric variable, character variable or factor with more than two values or factor levels giving the corresponding groups.

data

a matrix or data frame containing the variables in the formula formula.

posthoc

logical: if TRUE, Tukey HSD post hoc test for multiple comparison is conducted.

conf.level

a numeric value between 0 and 1 indicating the confidence level of the interval for Cohen's d. Note that this argument is only used when conducting Welch's two-sample t-test.

hypo

logical: if TRUE, null and alternative hypothesis are shown on the console.

descript

logical: if TRUE, descriptive statistics are shown on the console.

effsize

logical: if TRUE, effect size measure Cohen's d for Welch's two-sample t-test (see cohens.d), \(\eta^2\) and \(\omega^2\) for the ANOVA and Cohen's d for the post hoc tests are shown on the console..

weighted

logical: if TRUE, the weighted pooled standard deviation is used to compute Cohen's d.

correct

logical: if TRUE, correction factor to remove positive bias in small samples is used.

plot

logical: if TRUE, a plot showing error bars for confidence intervals is drawn.

point.size

a numeric value indicating the size aesthetic for the point representing the mean value.

error.width

a numeric value indicating the horizontal bar width of the error bar.

xlab

a character string specifying the labels for the x-axis.

ylab

a character string specifying the labels for the y-axis.

ylim

a numeric vector of length two specifying limits of the limits of the y-axis.

breaks

a numeric vector specifying the points at which tick-marks are drawn at the y-axis.

jitter

logical: if TRUE (default), jittered data points are drawn.

jitter.size

a numeric value indicating the size aesthetic for the jittered data points.

jitter.width

a numeric value indicating the amount of vertical and horizontal jitter.

jitter.alpha

a numeric value indicating the opacity of the jittered data points.

title

a character string specifying the text for the title for the plot.

subtitle

a character string specifying the text for the subtitle for the plot.

digits

an integer value indicating the number of decimal places to be used for displaying descriptive statistics and confidence interval.

p.digits

an integer value indicating the number of decimal places to be used for displaying the p-value.

as.na

a numeric vector indicating user-defined missing values, i.e. these values are converted to NA before conducting the analysis.

check

logical: if TRUE, argument specification is checked.

output

logical: if TRUE, output is shown on the console.

...

further arguments to be passed to or from methods.

Author

Takuya Yanagida takuya.yanagida@univie.ac.at

Details

Note that by default Tukey HSD post hoc test reports Cohen's d based on the weighted standard deviation (i.e., weighted = TRUE) when requesting an effect size measure (i.e., effsize = TRUE) following the recommendation by Delacre et al. (2021).

References

Rasch, D., Kubinger, K. D., & Yanagida, T. (2011). Statistics in psychology - Using R and SPSS. John Wiley & Sons.

Delacre, M., Lakens, D., Ley, C., Liu, L., & Leys, C. (2021). Why Hedges' g*s based on the non-pooled standard deviation should be reported with Welch's t-test. https://doi.org/10.31234/osf.io/tu6mp

See Also

test.t, test.z, test.levene, test.welch, cohens.d, ci.mean.diff, ci.mean