DAKS (version 2.1-3)

z_test: One- and Two-Sample Z-Tests for diff Values

Description

z_test performs one- and two-sample Z-tests for the diff values.

Usage

z_test(dataset, imp, imp_alt = NULL, alternative = c("two.sided", "less", "greater"), mu = 0,  conf.level = 0.95, v)

Arguments

dataset

a required data frame or matrix consisting of binary, $1$ or $0$, numeric data.

imp

a required object of class set representing the set of implications (ought to be a quasi order).

imp_alt

an optional set of implications, representing the alternative quasi order.

alternative

a character string specifying the alternative hypothesis, must be one of "two.sided" (default), "less", or "greater".

mu

a number indicating the true value of the mean (or difference in means if you are performing a two sample test).

conf.level

confidence level of the interval.

v

a required numeric giving the inductive item tree analysis algorithm to be performed; v = 1 (minimized corrected) and v = 2 (corrected).

Value

If the arguments are of required types, z_test returns a named list consisting of the following seven components:

Z.value

the value of the Z-statistic.

p.value

the p-value for the test.

conf

a confidence interval for the mean appropriate to the specified alternative hypothesis.

diff_value

the corresponding diff values for the used quasi orders according to the specified method.

alternative

a character string specifying the alternative hypothesis.

mu

a number indicating the true value of the mean (or difference in means if you are performing a two sample test).

conf.level

the level of the confidence interval.

Details

This function performs a Z-test for the diff values of one or two quasi orders.

References

Sargin, A. and Uenlue, A. (2009) Inductive item tree analysis: Corrections, improvements, and comparisons. Mathematical Social Sciences, 58, 376--392. Uenlue, A. and Sargin, A. (2010) DAKS: An R package for data analysis methods in knowledge space theory. Journal of Statistical Software, 37(2), 1--31. URL http://www.jstatsoft.org/v37/i02/.

See Also

iita, the interface that provides the three (sample) inductive item tree analysis methods under one umbrella; variance for estimated asymptotic variances of diff coefficients. See also DAKS-package for general information about this package.

Examples

sel_set<-ind_gen(ob_counter(pisa[, 1:3]))
z_test(pisa[, 1:3], sel_set[[2]], sel_set[[3]], v = 1)