This help topic is for R version 1.1. For the current version of R, try https://stat.ethz.ch/R-manual/R-patched/library/ctest/html/mantelhaen.test.html
mantelhaen.test {ctest}R Documentation

Mantel-Haenszel Chi-Square Test for Count Data

Description

mantelhaen.test performs a Mantel-Haenszel chi-square test of the null that x and y are conditionally independent in each stratum.

Usage

mantelhaen.test(x, y = NULL, z = NULL, correct = TRUE)

Arguments

x

either an array of dimension 2 by 2 by s, where s is the number of strata, or a dichotomous factor object.

y

a dichotomous factor object; ignored if x is an array.

z

a factor object idenitifying to which stratum the corresponding elements in x and y belong; ignored if x is an array.

correct

a logical indicating whether to apply continuity correction when computing the test statistic.

Details

If x is an array, it must be of dimension 2 by 2 by s, and the entries should be nonnegative integers. NA's are not allowed. Otherwise, x, y and z must have the same length. Triples containing NA's are removed. Both x and y must be dichotomous (take exactly 2 values).

Value

A list with class "htest" containing the following components:

statistic

the Mantel-Haenszel chi-square statistic.

parameter

always 1, the degrees of freedom of the approximate chi-square distribution of the test statistic.

p.value

the p-value of the test.

method

a string indicating the method employed, and whether or not continuity correction was used.

data.name

a character string giving the names of the data.

References

Alan Agresti (1990). Categorical data analysis. New York: Wiley. Pages 230–234.

Examples

data(UCBAdmissions)
mantelhaen.test(UCBAdmissions)
## No evidence for association between admission and gender
## when adjusted for department