percentile {exametrika} | R Documentation |
Student Percentile Ranks
Description
The percentile function calculates each student's relative standing in the group, expressed as a percentile rank (1-100). This function is applicable only to binary response data.
The percentile rank indicates the percentage of scores in the distribution that fall below a given score. For example, a percentile rank of 75 means the student performed better than 75% of the group.
Usage
percentile(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 of percentile ranks (1-100) for each student, where:
100: Highest performing student(s)
50: Median performance
1: Lowest performing student(s)
Note
This function is implemented using a binary data compatibility wrapper and will raise an error if used with polytomous data.
Percentile ranks are calculated using the empirical cumulative distribution function of standardized scores. Tied scores receive the same percentile rank. The values are rounded up to the nearest integer to provide ranks from 1 to 100.
Examples
# using sample dataset
percentile(J5S10)