visualSubsetRecode: Inspect data subsets visually and recode instantaneously

In sachseka/eatPrep: Prepare Data for IRT Analyses

Inspect data subsets visually and recode instantaneously

Description

This function facilitates the manual inspection and recoding of data subsets. For example, if a class of students in a large assessment is flagged with an issue such as 'audio was broken,' you may want to verify the validity of their response patterns. If their responses seem invalid, you can choose to recode the entire class to a value like 'missing coding impossible' (mci), which is typically treated as NA during IRT scaling later on. The function allows you to visually review all flagged subsets sequentially and make interactive decisions on whether to recode their data.

Usage

visualSubsetRecode(dat, subsetInfo, ID = "ID", toRecodeVal=-91,
                      useGroups = NULL, positions = FALSE, comments = FALSE)

Arguments

dat	A data frame containing individuals and variables in a wide format. See prepDat in examples for an example.
subsetInfo	A data frame with the following columns (names are important!): [ID]: ID-name as specified via ID argument. Is ID name in the first data set and identifies individual persons who are flagged. "datCols": Indicates the variable(s) on which the person identified by the ID has been flagged. [useGroups] (optional): group-name as specified via useGroups argument. Identifies groups of persons that should be displayed together during the review process. See subsetInfoMax in examples for an example.
ID	A character vector of length 1 indicating the name of the case identifier variable in dat. Default is "ID".
toRecodeVal	Optional: A scalar indicating recode string.
useGroups	Optional: A character string indicating the name of the group identifier column in subsetInfo. Used for group level subsetting.
positions	Logical: Whether subsetInfo contains columns "blockPosition" and "subunitBlockPosition" (names are important!). These will be displayed when visually inspecting the data and more options to the menu will be added.
comments	Logical: Whether subsetInfo contains column "comment" (name is important!). These will be displayed when visually inspecting the data.

Value

The function returns a list containing two data frames. The first data frame is the modified input data, identical to the original except for the changes made during the review process. The second data frame, stored in subsetInfo, documents the choices made during the recoding process.

Author(s)

Karoline Sachse

Examples

data(inputList)
data(inputDat)

prepDat <- automateDataPreparation (inputList = inputList, datList = inputDat,
                                    readSpss = FALSE, checkData = FALSE, mergeData = TRUE,
                                    recodeData = TRUE, aggregateData = TRUE,
                                    scoreData = TRUE, writeSpss = FALSE, verbose = FALSE)

subsetInfoMin <- data.frame(ID=c("person100", "person101", "person102", "person103", "person101",
                                 "person100", "person101", "person102", "person103", "person101",
                                 "person101"),
                            datCols=c("I01", "I02", "I03", "I01", "I02", "I03",
                                      "I04", NA, "I02", "I03", "I04"))

## Not run: datVisRec <- visualSubsetRecode(dat=prepDat, subsetInfo=subsetInfoMin, ID="ID",
                                toRecodeVal="mci", useGroups=NULL)
## End(Not run)

subsetInfoMax <- data.frame(ID=c("person100", "person101", "person102", "person103", "person101",
                              "person100", "person101", "person102", "person103", "person101",
                              "person101"),
                         IDgroup=c(1,1,1,1,1,2,2,2,2,2,2),
                         datCols=c("I01", "I02", "I03", "I01", "I02", "I03",
                                   "I04", NA, "I02", "I03", "I04"))

## Not run: datVisRec2 <- visualSubsetRecode(dat=prepDat, subsetInfo=subsetInfoMax, ID="ID",
                                 toRecodeVal="mci", useGroups="IDgroup")
## End(Not run)

sachseka/eatPrep documentation built on June 9, 2025, 9:36 a.m.