# mean2.ttest: Two-sample Student's t-test for Univariate Means In SHT: Statistical Hypothesis Testing Toolbox

 mean2.ttest R Documentation

## Two-sample Student's t-test for Univariate Means

### Description

Given two univariate samples x and y, it tests

H_0 : μ_x^2 ≤ft\lbrace =,≥q,≤q \right\rbrace μ_y^2\quad vs\quad H_1 : μ_x^2 ≤ft\lbrace \neq,<,>\right\rbrace μ_y^2

using the procedure by Student (1908) and Welch (1947).

### Usage

mean2.ttest(
x,
y,
alternative = c("two.sided", "less", "greater"),
paired = FALSE,
var.equal = FALSE
)


### Arguments

 x a length-n data vector. y a length-m data vector. alternative specifying the alternative hypothesis. paired a logical; whether consider two samples as paired. var.equal a logical; if FALSE, use Welch's correction.

### Value

a (list) object of S3 class htest containing:

statistic

a test statistic.

p.value

p-value under H_0.

alternative

alternative hypothesis.

method

name of the test.

data.name

name(s) of provided sample data.

### References

\insertRef

student_probable_1908SHT

\insertRef

student_probable_1908aSHT

\insertRef

welch_generalization_1947SHT

### Examples


## empirical Type 1 error
niter   = 1000
counter = rep(0,niter)  # record p-values
for (i in 1:niter){
x = rnorm(57)  # sample x from N(0,1)
y = rnorm(89)  # sample y from N(0,1)

counter[i] = ifelse(mean2.ttest(x,y)\$p.value < 0.05, 1, 0)
}

## print the result
cat(paste("\n* Example for 'mean2.ttest'\n","*\n",
"* number of rejections   : ", sum(counter),"\n",
"* total number of trials : ", niter,"\n",
"* empirical Type 1 error : ",round(sum(counter/niter),5),"\n",sep=""))



SHT documentation built on Nov. 3, 2022, 9:06 a.m.