hIRT (version 0.3.0)

hgrm2: Hierarchical Graded Response Models with Known Item Parameters

Description

hgrm2 fits a hierarchical graded response model where the item parameters are known and supplied by the user.

Usage

hgrm2(y, x = NULL, z = NULL, item_coefs, control = list())

Arguments

y

A data frame or matrix of item responses.

x

An optional model matrix, including the intercept term, that predicts the mean of the latent preference. If not supplied, only the intercept term is included.

z

An optional model matrix, including the intercept term, that predicts the variance of the latent preference. If not supplied, only the intercept term is included.

item_coefs

A list of known item parameters. The parameters of item \(j\) are given by the \(j\)th element, which should be a vector of length \(H_j\), containing \(H_j - 1\) item difficulty parameters (in descending order) and one item discrimination parameter.

control

A list of control values

max_iter

The maximum number of iterations of the EM algorithm. The default is 150.

eps

Tolerance parameter used to determine convergence of the EM algorithm. Specifically, iterations continue until the Euclidean distance between \(\beta_{n}\) and \(\beta_{n-1}\) falls under eps, where \(\beta\) is the vector of item discrimination parameters. eps=1e-4 by default.

max_iter2

The maximum number of iterations of the conditional maximization procedures for updating \(\gamma\) and \(\lambda\). The default is 15.

eps2

Tolerance parameter used to determine convergence of the conditional maximization procedures for updating \(\gamma\) and \(\lambda\). Specifically, iterations continue until the Euclidean distance between two consecutive log likelihoods falls under eps2. eps2=1e-3 by default.

K

Number of Gauss-Legendre quadrature points for the E-step. The default is 21.

C

[-C, C] sets the range of integral in the E-step. C=3 by default.

Value

An object of class hgrm.

coefficients

A data frame of parameter estimates, standard errors, z values and p values.

scores

A data frame of EAP estimates of latent preferences and their approximate standard errors.

vcov

Variance-covariance matrix of parameter estimates.

log_Lik

The log-likelihood value at convergence.

N

Number of units.

J

Number of items.

H

A vector denoting the number of response categories for each item.

ylevels

A list showing the levels of the factorized response categories.

p

The number of predictors for the mean equation.

q

The number of predictors for the variance equation.

control

List of control values.

call

The matched call.

Examples

# NOT RUN {
y <- nes_econ2008[, -(1:3)]
x <- model.matrix( ~ party * educ, nes_econ2008)
z <- model.matrix( ~ party, nes_econ2008)

n <- nrow(nes_econ2008)
id_train <- sample.int(n, n/4)
id_test <- setdiff(1:n, id_train)

y_train <- y[id_train, ]
x_train <- x[id_train, ]
z_train <- z[id_train, ]

mod_train <- hgrm(y_train, x_train, z_train)

y_test <- y[id_test, ]
x_test <- x[id_test, ]
z_test <- z[id_test, ]

item_coefs <- lapply(coef_item(mod_train), `[[`, "Estimate")

model_test <- hgrm2(y_test, x_test, z_test, item_coefs = item_coefs)
# }