passage {exametrika} | R Documentation |
Passage Rate of Student
Description
The Passage Rate for each student is calculated as their Number-Right Score (NRS) divided by the number of items presented to them. This function is applicable only to binary response data.
The passage rate is calculated as:
P_i = \frac{\sum_{j=1}^J z_{ij}u_{ij}w_j}{\sum_{j=1}^J z_{ij}}
where:
-
z_{ij}
is the missing response indicator (0/1) -
u_{ij}
is the response (0/1) -
w_j
is the item weight
Usage
passage(U, na = NULL, Z = NULL, w = NULL, ...)
Arguments
U |
U is a data matrix of the type matrix or data.frame. |
na |
na argument specifies the numbers or characters to be treated as missing values. |
Z |
Z is a missing indicator matrix of the type matrix or data.frame |
w |
w is item weight vector |
... |
Internal parameters for maintaining compatibility with the binary data processing system. Not intended for direct use. |
Value
A numeric vector containing the passage rate for each student. Values range from 0 to 1 (or maximum weight) where:
1: Perfect score on all attempted items
0: No correct answers
NA: No items attempted
Note
This function is implemented using a binary data compatibility wrapper and will raise an error if used with polytomous data.
The passage rate accounts for missing responses by only considering items that were actually presented to each student. This provides a fair comparison between students who attempted different numbers of items.
Examples
# using sample dataset
passage(J15S500)