nrs: Number Right Score

View source: R/02_TestItemFunctions.R

nrsR Documentation

Number Right Score

Description

The Number-Right Score (NRS) function calculates the weighted sum of correct responses for each examinee. This function is applicable only to binary response data.

For each examinee, the score is computed as:

NRS_i = \sum_{j=1}^J z_{ij}u_{ij}w_j

where:

  • z_{ij} is the missing response indicator (0/1)

  • u_{ij} is the response (0/1)

  • w_j is the item weight

Usage

nrs(U, na = NULL, Z = NULL, w = NULL)

## Default S3 method:
nrs(U, na = NULL, Z = NULL, w = NULL)

## S3 method for class 'binary'
nrs(U, na = NULL, Z = NULL, w = NULL)

Arguments

U

Either an object of class "exametrika" or raw data. When raw data is given, it is converted to the exametrika class with the dataFormat function.

na

Values to be treated as missing values.

Z

Missing indicator matrix of type matrix or data.frame. Values of 1 indicate observed responses, while 0 indicates missing data.

w

Item weight vector specifying the relative importance of each item.

Value

A numeric vector containing the Number-Right Score for each examinee. The score represents the weighted sum of correct answers, where:

  • Maximum score is the sum of all item weights

  • Minimum score is 0

  • Missing responses do not contribute to the score

Note

This function is implemented using a binary data compatibility wrapper and will raise an error if used with polytomous data.

Examples

# using sample dataset
nrs(J15S500)

exametrika documentation built on Aug. 21, 2025, 5:27 p.m.