This vignettes covers the psychometric models that are implemented in the irt package.

Item Models

Name	Description	Parameters
Rasch	Rasch Model	b
1PL	One-Parameter Logistic Model	b, D
2PL	Two-Parameter Logistic Model	a, b, D
3PL	Three-Parameter Logistic Model	a, b, c, D
4PL	Four-Parameter Logistic Model	a, b, c, d, D
GRM	Graded Response Model	a, b, D
PCM	Partial Credit Model	b
GPCM	Generalized Partial Credit Model	a, b, D
GPCM2	Reparameterized Generalized Partial Credit Model	a, b, d, D

Rasch Model

For an examinee $i$ with ability $\theta_i$, the probability of correct response to an item $j$ is:

`wB$$P\left(X_{ij} = 1 | \theta_i;b_j\right) = \frac{e^{(\theta_i - b_j)}}{1 + e^{(\theta_i - b_j)}}$$

where , $b_j$ is the item difficulty (or threshold) of item $j$.

User needs to specify only the item difficulty parameter:

library(irt)

itm_rasch <- item(b = -1.29)
itm_rasch
#> A 'Rasch' item.
#> Model:   Rasch (Rasch Model)
#> Model Parameters:
#>   b = -1.29
#> 
#> --------------------------

The probability of each response option at $\theta = -.65$ is:

prob(ip = itm_rasch, theta = -0.65)
#>              0         1
#> [1,] 0.3452465 0.6547535

The item characteristic curve of this item is:

plot(itm_rasch)

One-Parameter Logistic Model

For an examinee $i$ with ability $\theta_i$, the probability of correct response to an item $j$ is:

`wB$$P\left(X_{ij} = 1 | \theta_i;b_j\right) = \frac{e^{D(\theta_i - b_j)}}{1 + e^{D(\theta_i - b_j)}}$$

where , $b_j$ is the item difficulty (or threshold) of item $j$. D is the scaling constant (the default value is 1).

User needs to specify the following parameters:

itm_1pl <- item(b = 0.83, D = 1)
itm_1pl
#> A '1PL' item.
#> Model:   1PL (One-Parameter Logistic Model)
#> Model Parameters:
#>   b = 0.83
#>   D = 1
#> 
#> --------------------------

The probability of each response option at $\theta = .73$ is:

prob(ip = itm_1pl, theta = 0.73)
#>              0         1
#> [1,] 0.5249792 0.4750208

The item characteristic curve of this item is:

plot(itm_1pl)

Two-Parameter Logistic Model

For an examinee $i$ with ability $\theta_i$, the probability of correct response to an item $j$ is:

`wB$$P\left(X_{ij} = 1 | \theta_i;a_j, b_j\right) = \frac{e^{Da_j(\theta_i - b_j)}}{1 + e^{Da_j(\theta_i - b_j)}}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_j$ is the item difficulty (or threshold). D is the scaling constant (the default value is 1).

User needs to specify all of the parameter values:

itm_2pl <- item(a = .94, b = -1.302, D = 1)
itm_2pl
#> A '2PL' item.
#> Model:   2PL (Two-Parameter Logistic Model)
#> Model Parameters:
#>   a = 0.94
#>   b = -1.302
#>   D = 1
#> 
#> --------------------------

The probability of each response option at $\theta = -0.53$ is:

prob(ip = itm_2pl, theta = -0.53)
#>              0         1
#> [1,] 0.3261434 0.6738566

The item characteristic curve of this item is:

plot(itm_2pl)

Three-Parameter Logistic Model

For an examinee $i$ with ability $\theta_i$, the probability of correct response to an item $j$ is:

`wB$$P\left(X_{ij} = 1 | \theta_i;a_j, b_j, c_j\right) = c_j + (1 - c_j)\frac{e^{Da_j(\theta_i - b_j)}}{1 + e^{Da_j(\theta_i - b_j)}}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_j$ is the item difficulty (or threshold), and $c_j$ is the lower asymptote (or pseudo-guessing) value. D is the scaling constant (the default value is 1).

As can be seen from the equation above, the user needs to specify all of the parameter values:

itm_3pl <- item(a = 1.51, b = 2.04, c = .16, D = 1.7)
itm_3pl
#> A '3PL' item.
#> Model:   3PL (Three-Parameter Logistic Model)
#> Model Parameters:
#>   a = 1.51
#>   b = 2.04
#>   c = 0.16
#>   D = 1.7
#> 
#> --------------------------

The probability of each response option at $\theta = 1.5$ is:

prob(ip = itm_3pl, theta = 1.5)
#>              0         1
#> [1,] 0.6719846 0.3280154

The item characteristic curve of this item:

plot(itm_3pl)

Four-Parameter Logistic Model

For an examinee $i$ with ability $\theta_i$, the probability of correct response to an item $j$ is:

`wB$$P\left(X_{ij} = 1 | \theta_i;a_j, b_j, c_j, d_j\right) = c_j + (d_j - c_j)\frac{e^{Da_j(\theta_i - b_j)}}{1 + e^{Da_j(\theta_i - b_j)}}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_j$ is the item difficulty (or threshold), $c_j$ is the lower asymptote (or pseudo-guessing) value and $d_j$ is the upper asymptote. D is the scaling constant (the default value is 1).

As can be seen from the equation above, the user needs to specify all of the parameter values:

itm_4pl <- item(a = 1.2, b = -.74, c = .22, d = .99, D = 1.7)
itm_4pl
#> A '4PL' item.
#> Model:   4PL (Four-Parameter Logistic Model)
#> Model Parameters:
#>   a = 1.2
#>   b = -0.74
#>   c = 0.22
#>   d = 0.99
#>   D = 1.7
#> 
#> --------------------------

The probability of each response option at $\theta = 1.2$ is:

prob(ip = itm_4pl, theta = 1.2)
#>               0        1
#> [1,] 0.02443797 0.975562

The item characteristic curve of this item is:

plot(itm_4pl)

Graded Response Model (GRM)

For an examinee $i$ with ability $\theta_i$, the probability of responding at or above the category $k$ to an item $j$ with possible scores $k = 0, 1, \ldots, m_j$:

`wB$$P^*\left(X_{ij} = k | \theta_i;a_j, b_j\right) = \frac{e^{Da_j(\theta_i - b_{jk})} }{1 + e^{Da_j(\theta_i - b_{jk})}}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_{jk}$ is the threshold parameter. Note that the probability of responding at or above the lowest category is $P^*\left(X_{ij} = 0\right) = 1$. Responding at a category $k$ can be calculated as:

$$P(X_{ij}=k|\theta_i) = P^*(X_{ij} = k) - P^*(X_{ij} = k+1)$$

The user needs to specify the following parameter values:

itm_grm <- item(a = 0.84, b = c(-1, -.2, .75, 1.78), D = 1.7, model = "GRM")
itm_grm
#> A 'GRM' item.
#> Model:   GRM (Graded Response Model)
#> Model Parameters:
#>   a = 0.84
#>   b = -1;  -0.2;  0.75;  1.78
#>   D = 1.7
#> 
#> --------------------------

The probability of each response option at $\theta = 1.13$ is:

prob(ip = itm_grm, theta = 1.13)
#>               0          1         2         3       4
#> [1,] 0.04557977 0.08461474 0.2373791 0.3491363 0.28329

The option characteristic curves of this item is:

plot(itm_grm)

Generalized Partial Credit Model (GPCM)

For an examinee $i$ with ability $\theta_i$, the probability of a response $k$ to an item $j$ with possible scores $k = 0, 1, \ldots, m_j$:

`wB$$P\left(X_{ij} = k | \theta_i;a_j, b_j\right) = \frac{\text{exp} \left( \sum_{v = 0}^{k}Da_j(\theta_i - b_{jv}) \right) } {{\sum_{h = 0}^{m_j} \text{exp} \left[ \sum_{v = 0}^{h} Da_j(\theta_i - b_{jv}) \right] }}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_{jv}$ are the step difficulty parameters. Note that $b_{jv}$ values are not necessarily ordered from smallest to the largest. D is the scaling constant (the default value is 1). $\sum_{v = 0}^0 Da_j(\theta_i - b_{jv}) = 0$.

The user needs to specify the following parameter values:

itm_gpcm <- item(a = 1.1, b = c(-.74, .3, .91, 2.19), D = 1.7, model = "GPCM")
itm_gpcm
#> A 'GPCM' item.
#> Model:   GPCM (Generalized Partial Credit Model)
#> Model Parameters:
#>   a = 1.1
#>   b = -0.74;  0.3;  0.91;  2.19
#>   D = 1.7
#> 
#> --------------------------

The probability of each response option at $\theta = -0.53$ is:

prob(ip = itm_gpcm, theta = -0.53)
#>              0         1         2           3            4
#> [1,] 0.3551121 0.5259117 0.1113895 0.007540084 4.659945e-05

The option characteristic curves of this item is:

plot(itm_gpcm)

Partial Credit Model (PCM)

For an examinee $i$ with ability $\theta_i$, the probability of a
response $k$ to an item $j$ with possible scores $k = 0, 1, \ldots, m_j$:

`wB$$P\left(X_{ij} = k | \theta_i;b_j\right) = \frac{\text{exp} \left( \sum_{v = 0}^{k}(\theta_i - b_{jv}) \right) } {{\sum_{h = 0}^{m_j} \text{exp} \left[ \sum_{v = 0}^{h} (\theta_i - b_{jv}) \right] }}$$

where $b_{jv}$ are the step difficulty parameters. $\sum_{v = 0}^0 (\theta_i - b_{jv}) = 0$.

The user needs to specify the following parameter values:

itm_pcm <- item(b = c(-1.38, -.18, 1.1), model = "PCM")
itm_pcm
#> A 'PCM' item.
#> Model:   PCM (Partial Credit Model)
#> Model Parameters:
#>   b = -1.38;  -0.18;  1.1
#> 
#> --------------------------

The probability of each response option at $\theta = -1.09$ is:

prob(ip = itm_pcm, theta = -1.09)
#>              0         1         2          3
#> [1,] 0.3407646 0.4554072 0.1833124 0.02051573

The option characteristic curves of this item is:

plot(itm_pcm)

Reparameterized Generalized Partial Credit Model (GPCM2)

For an examinee $i$ with ability $\theta_i$, the probability of a response $k$ to an item $j$ with possible scores $k = 0, 1, \ldots, m_j$:

`wB$$P\left(X_{ij} = k | \theta_i;a_j, b_j, d_j\right) = \frac{\text{exp} \left( \sum_{v = 0}^{k}Da_j(\theta_i - b_j + d_{jv}) \right) } {{\sum_{h = 0}^{m_j} \text{exp} \left[ \sum_{v = 0}^{h} Da_j(\theta_i - b_j + d_{jv}) \right] }}$$

where $a_j$ is the item discrimination (or slope) of item $j$, $b_j$ is the overall location parameter and $d_{jv}$ are the threshold parameters. D is the scaling constant (the default value is 1).

The user needs to specify the following parameter values:

itm_gpcm2 <- item(a = .71, b = .37, d = c(-.18, .11, 1.29), D = 1, 
                  model = "GPCM2")
itm_gpcm2
#> A 'GPCM2' item.
#> Model:   GPCM2 (Reparameterized Generalized Partial Credit Model)
#> Model Parameters:
#>   a = 0.71
#>   b = 0.37
#>   d = -0.18;  0.11;  1.29
#>   D = 1
#> 
#> --------------------------

The probability of each response option at $\theta 1.3$ is:

prob(ip = itm_gpcm2, theta = 1.3)
#>               0          1       2         3
#> [1,] 0.04254421 0.07246065 0.15163 0.7333651

The option characteristic curves of this item is:

plot(itm_gpcm2)