ItemEntropy: Item Entropy

View source: R/02_TestItemFunctions.R

ItemEntropyR Documentation

Item Entropy

Description

The item entropy is an indicator of the variability or randomness of the responses. This function is applicable only to binary response data.

The entropy value represents the uncertainty or information content of the response pattern for each item, measured in bits. Maximum entropy (1 bit) occurs when correct and incorrect responses are equally likely (p = 0.5).

Usage

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

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

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

## S3 method for class 'ordinal'
ItemEntropy(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.

Details

The item entropy is calculated as:

e_j = -p_j\log_2p_j-(1-p_j)\log_2(1-p_j)

where p_j is the correct response rate for item j.

The entropy value has the following properties:

  • Maximum value of 1 bit when p = 0.5 (most uncertainty)

  • Minimum value of 0 bits when p = 0 or 1 (no uncertainty)

  • Higher values indicate more balanced response patterns

  • Lower values indicate more predictable response patterns

Value

A numeric vector of entropy values for each item, measured in bits. Values range from 0 to 1, where:

  • 1: maximum uncertainty (p = 0.5)

  • 0: complete certainty (p = 0 or 1)

  • Values near 1 indicate items with balanced response patterns

  • Values near 0 indicate items with extreme response patterns

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
ItemEntropy(J5S10)

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