dataFormat.long: dataFormat for long-type data

Description

A function to reshape long data into a dataset suitable for exametrika.

Usage

dataFormat.long(
  data,
  na = NULL,
  Sid = NULL,
  Qid = NULL,
  Resp = NULL,
  w = NULL,
  response.type = NULL
)

Value

U: For binary response data. A matrix with rows representing the sample size and columns representing the number of items, where elements are either 0 or 1. \(u_{ij}=1\) indicates that student i correctly answered item j, while \(u_{ij}=0\) means that student i answered item j incorrectly.

For polytomous response data. A matrix with rows representing the sample size and columns representing the number of items, where elements are non-negative integers. When input data is in factor format, the factor levels are converted to consecutive integers starting from 1, and the original factor labels are stored in factor_labels.

The ID label given by the designated column or function.

ItemLabel

The item names given by the provided column names or function.

Missing indicator matrix. \(z_{ij}=1\) indicates that item j is presented to Student i, while \(z_{ij}=0\) indicates item j is NOT presented to Student i.

Item weight vector

response.type

Character string indicating the type of response data: "binary" for binary responses or "polytomous" for polytomous responses.

factor_labels

List containing the original factor labels when polytomous responses are provided as factors. NULL if no factor data is present.

Arguments

data: is a data matrix of the type matrix or data.frame. This must contain at least three columns to identify the student, the item, and the response. Additionally, it can include a column for the weight of the items.
na: na argument specifies the numbers or characters to be treated as missing values.
Sid: Specify the column number containing the student ID label vector.
Qid: Specify the column number containing the Question label vector.
Resp: Specify the column number containing the Response value vector.
w: Specify the column number containing the weight vector.
response.type: type of response data: "binary" or "polytomous" (can be abbreviated as "poly"). If NULL, the type is automatically determined from the data.