This function performs one-sample, two-sample, and paired-sample t-tests and provides descriptive statistics, effect size measure, and a plot showing error bars for confidence intervals with jittered data points.
test.t(x, ...)# S3 method for default
test.t(x, y = NULL, mu = 0, paired = FALSE,
alternative = c("two.sided", "less", "greater"),
conf.level = 0.95, hypo = TRUE, descript = TRUE, effsize = FALSE,
weighted = TRUE, cor = TRUE, ref = NULL, correct = FALSE,
plot = FALSE, point.size = 4, error.width = 0.1,
xlab = NULL, ylab = NULL, ylim = NULL, breaks = ggplot2::waiver(),
line = TRUE, line.type = 3, line.size = 0.8,
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, ...)
# S3 method for formula
test.t(formula, data, alternative = c("two.sided", "less", "greater"),
conf.level = 0.95, hypo = TRUE, descript = TRUE, effsize = FALSE,
weighted = TRUE, cor = TRUE, ref = NULL, 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, ...)
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 and y (data), data used to plot
the results (plot.data), specification of function arguments (args),
and result table (result).
a numeric vector of data values.
a numeric vector of data values.
a numeric value indicating the population mean under the null hypothesis. Note that the argument mu is only used when computing a one sample t-test.
logical: if TRUE, paired-samples t-test is computed.
a character string specifying the alternative hypothesis, must be one of "two.sided" (default), "greater" or "less".
logical: if TRUE, null and alternative hypothesis are shown on the console.
logical: if TRUE, descriptive statistics are shown on the console.
logical: if TRUE, effect size measure Cohen's d is shown on the console, see cohens.d function.
logical: if TRUE (default), the weighted pooled standard deviation is used to compute Cohen's d for a two-sample design (i.e., paired = FALSE), while standard deviation of the difference scores is used to compute Cohen's d for a paired-sample design (i.e., paired = TRUE).
logical: if TRUE (default), paired = TRUE, and weighted = FALSE, Cohen's d for a paired-sample design while controlling for the correlation between the two sets of measurement is computed. Note that this argument is only used in a paired-sample design (i.e., paired = TRUE) when specifying weighted = FALSE.
character string "x" or "y" for specifying the reference reference group when using the default test.t() function or a numeric value or character string indicating the reference group in a two-sample design when using the formula test.t() function. The standard deviation of the reference variable or reference group is used to standardized the mean difference to compute Cohen's d. Note that this argument is only used in a two-sample design (i.e., paired = FALSE).
logical: if TRUE, correction factor to remove positive bias in small samples is used.
a numeric value between 0 and 1 indicating the confidence level of the interval.
logical: if TRUE, a plot showing error bars for confidence intervals is drawn.
a numeric value indicating the size aesthetic for the point representing the mean value.
a numeric value indicating the horizontal bar width of the error bar.
a character string specifying the labels for the x-axis.
a character string specifying the labels for the y-axis.
a numeric vector of length two specifying limits of the limits of the y-axis.
a numeric vector specifying the points at which tick-marks are drawn at the y-axis.
logical: if TRUE (default), a horizontal line is drawn at mu for the one-sample t-test or at 0 for the paired-sample t-test.
an integer value or character string specifying the line type for the line representing the population mean under the null hypothesis, i.e., 0 = blank, 1 = solid, 2 = dashed, 3 = dotted, 4 = dotdash, 5 = longdash, 6 = twodash.
a numeric value indicating the size aesthetic for the line representing the population mean under the null hypothesis.
logical: if TRUE (default), jittered data points are drawn.
a numeric value indicating the size aesthetic for the jittered data points.
a numeric value indicating the amount of vertical and horizontal jitter.
a numeric value indicating the opacity of the jittered data points.
a character string specifying the text for the title for the plot.
a character string specifying the text for the subtitle for the plot.
an integer value indicating the number of decimal places to be used for displaying descriptive statistics and confidence interval.
an integer value indicating the number of decimal places to be used for displaying the p-value.
a numeric vector indicating user-defined missing values, i.e. these values are converted to NA before conducting the analysis.
logical: if TRUE, argument specification is checked.
logical: if TRUE, output is shown on the console.
in case of two sample t-test (i.e., paired = FALSE), a formula of the form y ~ group where group is a numeric variable, character variable or factor with two values or factor levels giving the corresponding groups.
a matrix or data frame containing the variables in the formula formula.
further arguments to be passed to or from methods.
Takuya Yanagida takuya.yanagida@univie.ac.at
Rasch, D., Kubinger, K. D., & Yanagida, T. (2011). Statistics in psychology - Using R and SPSS. John Wiley & Sons.
aov.b, test.welch, test.z,
test.levene, cohens.d, ci.mean.diff,
ci.mean