R: Extract various elements from 'est_irt', 'est

getirt {irtQ}

R Documentation

Extract various elements from 'est_irt', 'est_mg', and 'est_item' objects

Description

This method extracts various internal objects from an object of class est_irt, est_mg, or est_item .

Usage

getirt(x, ...)

## S3 method for class 'est_irt'
getirt(x, what, ...)

## S3 method for class 'est_mg'
getirt(x, what, ...)

## S3 method for class 'est_item'
getirt(x, what, ...)

Arguments

`x`	An object of class `est_irt`, `est_mg`, or `est_item`.
`...`	Further arguments passed to or from other methods.
`what`	A character string indicating what to extract.

Details

Objects which can be extracted from the object of class est_irt include:

estimates: A data frame containing both the item parameter estimates and the corresponding standard errors of estimates.
par.est: A data frame containing the item parameter estimates.
se.est: A data frame containing the standard errors of the item parameter estimates. Note that the standard errors are estimated using the cross-production approximation method (Meilijson, 1989).
pos.par: A data frame containing the position number of each item parameter being estimated. The position information is useful when interpreting the variance-covariance matrix of item parameter estimates.
covariance: A matrix of variance-covariance matrix of item parameter estimates.
loglikelihood: A sum of the log-likelihood values of the observed data set (marginal log-likelihood) across all items in the data set.
aic: A model fit statistic of Akaike information criterion based on the loglikelihood.
bic: A model fit statistic of Bayesian information criterion based on the loglikelihood.
group.par: A data frame containing the mean, variance, and standard deviation of latent variable prior distribution.
weights: A two-column data frame containing the quadrature points (in the first column) and the corresponding weights (in the second column) of the (updated) latent variable prior distribution.
posterior.dist: A matrix of normalized posterior densities for all the response patterns at each of the quadrature points. The row and column indicate each individual's response pattern and the quadrature point, respectively.
data: A data frame of the examinees' response data set.
scale.D: A scaling factor in IRT models.
ncase: A total number of response patterns.
nitem: A total number of items included in the response data.
Etol: A convergence criteria for E steps of the EM algorithm.
MaxE: The maximum number of E steps in the EM algorithm.
aprior: A list containing the information of the prior distribution for item slope parameters.
bprior: A list containing the information of the prior distribution for item difficulty (or threshold) parameters.
gprior: A list containing the information of the prior distribution for item guessing parameters.
npar.est: A total number of the estimated parameters.
niter: The number of EM cycles completed.
maxpar.diff: A maximum item parameter change when the EM cycles were completed.
EMtime: Time (in seconds) spent for the EM cycles.
SEtime: Time (in seconds) spent for computing the standard errors of the item parameter estimates.
TotalTime: Time (in seconds) spent for total compuatation.
test.1: Status of the first-order test to report if the gradients has vanished sufficiently for the solution to be stable.
test.2: Status of the second-order test to report if the information matrix is positive definite, which is a prerequisite for the solution to be a possible maximum.
var.note: A note to report if the variance-covariance matrix of item parameter estimates is obtainable from the information matrix.
fipc: A logical value to indicate if FIPC was used.
fipc.method: A method used for the FIPC.
fix.loc: A vector of integer values specifying the locations of the fixed items when the FIPC was implemented.

Objects which can be extracted from the object of class est_mg include:

estimates: A list containing two internal objects (i.e., overall and group) of the item parameter estimates and the corresponding standard errors of estimates. The first internal object (overall) is a data frame of the item parameter and standard error estimates for the combined data set across all groups. Accordingly, the data frame includes unique items across all groups. The second internal object (group) is a list of group specific data frames containing item parameter and standard error estimates
par.est: A list containing two internal objects (i.e., overall and group) of the item parameter estimates. The format of the list is the same with the internal object of 'estimates'
se.est: A list containing two internal objects (i.e., overall and group) of the standard errors of item parameter estimates. The format of the list is the same with the internal object of 'estimates'. Note that the standard errors are estimated using the cross-production approximation method (Meilijson, 1989).
pos.par: A data frame containing the position number of each item parameter being estimated. This item position data frame was created based on the combined data sets across all groups (see the first internal object of 'estimates'). The position information is useful when interpreting the variance-covariance matrix of item parameter estimates.
covariance: A matrix of variance-covariance matrix of item parameter estimates. This matrix was created based on the combined data sets across all groups (see the first internal object of 'estimates')
loglikelihood: A list containing two internal objects (i.e., overall and group) of the log-likelihood values of observed data set (marginal log-likelihood). The format of the list is the same with the internal object of 'estimates'. Specifically, the first internal object (overall) contains a sum of the log-likelihood values of the observed data set across all unique items of all groups. The second internal object (group) shows the group specific log-likelihood values.
aic: A model fit statistic of Akaike information criterion based on the loglikelihood of all unique items..
bic: A model fit statistic of Bayesian information criterion based on the loglikelihood of all unique items.
group.par: A list containing the summary statistics (i.e., a mean, variance, and standard deviation) of latent variable prior distributions across all groups.
weights: a list of the two-column data frames containing the quadrature points (in the first column) and the corresponding weights (in the second column) of the (updated) latent variable prior distributions for all groups.
posterior.dist: A matrix of normalized posterior densities for all the response patterns at each of the quadrature points. The row and column indicate each individual's response pattern and the quadrature point, respectively.
data: A list containing two internal objects (i.e., overall and group) of the examinees' response data sets. The format of the list is the same with the internal object of 'estimates'.
scale.D: A scaling factor in IRT models.
ncase: A list containing two internal objects (i.e., overall and group) with the total number of response patterns. The format of the list is the same with the internal object of 'estimates'.
nitem: A list containing two internal objects (i.e., overall and group) with the total number of items included in the response data set. The format of the list is the same with the internal object of 'estimates'.
Etol: A convergence criteria for E steps of the EM algorithm.
MaxE: The maximum number of E steps in the EM algorithm.
aprior: A list containing the information of the prior distribution for item slope parameters.
gprior: A list containing the information of the prior distribution for item guessing parameters.
npar.est: A total number of the estimated parameters across all unique items.
niter: The number of EM cycles completed.
maxpar.diff: A maximum item parameter change when the EM cycles were completed.
EMtime: Time (in seconds) spent for the EM cycles.
SEtime: Time (in seconds) spent for computing the standard errors of the item parameter estimates.
TotalTime: Time (in seconds) spent for total compuatation.
test.1: Status of the first-order test to report if the gradients has vanished sufficiently for the solution to be stable.
test.2: Status of the second-order test to report if the information matrix is positive definite, which is a prerequisite for the solution to be a possible maximum.
var.note: A note to report if the variance-covariance matrix of item parameter estimates is obtainable from the information matrix.
fipc: A logical value to indicate if FIPC was used.
fipc.method: A method used for the FIPC.
fix.loc: A list containing two internal objects (i.e., overall and group) with the locations of the fixed items when the FIPC was implemented. The format of the list is the same with the internal object of 'estimates'.

Objects which can be extracted from the object of class est_item include:

estimates: A data frame containing both the item parameter estimates and the corresponding standard errors of estimates.
par.est: A data frame containing the item parameter estimates.
se.est: A data frame containing the standard errors of the item parameter estimates. Note that the standard errors are estimated using observed information functions.
pos.par: A data frame containing the position number of each item parameter being estimated. The position information is useful when interpreting the variance-covariance matrix of item parameter estimates.
covariance: A matrix of variance-covariance matrix of item parameter estimates.
loglikelihood: A sum of the log-likelihood values of the complete data set across all estimated items.
data: A data frame of the examinees' response data set.
score: A vector of the examinees' ability values used as the fixed effects.
scale.D: A scaling factor in IRT models.
convergence: A string indicating the convergence status of the item parameter estimation.
nitem: A total number of items included in the response data.
deleted.item: The items which have no item response data. Those items are excluded from the item parameter estimation.
npar.est: A total number of the estimated parameters.
n.response: An integer vector indicating the number of item responses for each item used to estimate the item parameters.
TotalTime: Time (in seconds) spent for total compuatation.

See est_irt, est_mg, and est_item for more details.

Value

The internal objects extracted from an object of class est_irt, est_mg, or est_item.

Methods (by class)

est_irt: An object created by the function est_irt.
est_mg: An object created by the function est_mg.
est_item: An object created by the function est_item.

Author(s)

Hwanggyu Lim hglim83@gmail.com

Examples


# fit the 2PL model to LSAT6 data
mod.2pl <- est_irt(data=LSAT6, D=1, model="2PLM", cats=2)

# extract the item parameter estimates
(est.par <- getirt(mod.2pl, what="par.est"))

# extract the standard error estimates
(est.se <- getirt(mod.2pl, what="se.est"))

# extract the variance-covariance matrix of item parameter estimates
(cov.mat <- getirt(mod.2pl, what="covariance"))

[Package irtQ version 0.2.0 Index]