rpe_create_source_with_items {rock}

Create a source with items to code for Response Process Evaluation

Description

This function creates a plain text file, a .rock source, that can be coded when conducting Response Process Evaluation.

Usage

rpe_create_source_with_items(
  data,
  iterationId,
  batchId,
  populationId,
  itemVarNames,
  metaquestionIdentifiers,
  metaquestionVarNames,
  itemContents,
  metaquestionContents,
  coderId,
  caseIds = NULL,
  outputFile = NULL,
  preventOverwriting = rock::opts$get("preventOverwriting"),
  encoding = rock::opts$get("encoding"),
  silent = rock::opts$get("silent")
)

Arguments

data

A (wide) data frame containing at least the participants' answers to the items and to the meta questions (but optionally, the iteration, batch, and population).

iterationId, batchId, populationId

If the iteration, batch, and population identifiers are contained in the data frame passed as data, the variable names holding that information for each participant; otherwise, either a single value or a vector of length nrow(data) that contains that information for each participant.

itemVarNames

The variable names with the participants' responses to the items, in a named character vector, with each element's name being the item's identifier, and each element the variable name in data holding the participants' responses to the item.

metaquestionIdentifiers

A named list of unnamed character vectors, with each character vector element specifying the identifier of a meta question, and each list element (i.e. the name of each character vector) specifying the item identifier that the meta questions in the corresponding character vector belong to.

metaquestionVarNames

The variable names with the participants' responses to the meta questions, in a named character vector, with each element's name being the meta question's identifier, and each element the variable name in data holding the participants' responses to the meta question.

itemContents

A named character vector with each item's content, with the values being the content and the names the item identifiers.

metaquestionContents

A named character vector with each meta question's content, with the values being the content and the names the meta question identifiers.

coderId

The identifier of the coder that will code this source.

caseIds

The variable name with the participants' case identifiers (i.e. a unique identifier for each participant).

outputFile

Optionally, a file to write the source to.

preventOverwriting

Whether to overwrite existing files (FALSE) or prevent that from happening (TRUE).

encoding

The encoding to use when writing the source(s).

silent

Whether to the silent (TRUE) or chatty (FALSE).

Value

The created source, as a character vector (invisibly);