mokken (version 3.0.3)

MLcoefZ: Computation of Z-Values for two-level scalability coefficients

Description

Computes Zij-values of item pairs, Zi-values of items, and Z-value of the entire scale, which are used to test whether Hij, Hi, and H, respectively (within- and between-rater versions), are significantly greater a specified lowerbound using the delta method (Koopman, Zijlstra, & Van der Ark, 2020a). The test uses range-preserving asymptotic theory (Koopman, Zijlstra, & Van der Ark, 2020b).

Usage

MLcoefZ(X, lowerbound = 0)

Arguments

X

matrix or data frame of numeric data containing the responses of nrow(X) respondents to ncol(X) - 1 items. The first column of X is assumed to be a subject column, see ?MLcoefH() for details. Missing values are not allowed

lowerbound

Value of the null hypothesis to which the scalability are compared to compute the Z-score (see details), 0 <= lowerbound < 1. The default is 0.

Value

Zij

matrix containing the Z-values of the item-pairs

Zi

vector containing Z-values of the items

Z

Z-value of the entire scale

Details

The range-preserving Z-score for the estimated item-pair coefficient \(Hij\) with standard error \(SE(Hij)\) is computed as $$Z = -(log(1 - Hij) - log(1 - lowerbound)) / (SE(Hij) / (1 - Hij)) (Koopman, Zijlstra, Van der Ark, 2020b)$$ Unlike MLcoefH, standard errors are not provided.

References

Koopman, L. Zijlstra, B. J. H, & Van der Ark, L. A. (2020a). A two-step procedure for scaling multilevel data using Mokken's scalability coefficients. Manuscript submitted for publication.

Koopman, L. Zijlstra, B. J. H, & Van der Ark, L. A. (2020b). Range-preserving confidence intervals for scalability coefficients in Mokken scale analysis. Manuscript submitted for publication.

See Also

MLcoefH

Examples

# NOT RUN {
data(SWMD)

# Compute the Z-score using lowerbound 0
MLcoefZ(SWMD)

# Using lowerbound .1
MLcoefZ(SWMD, lowerbound = .1)
# }