get_resp_data {dexter}

Functions for developers

Description

These functions are meant for people who want to develop their own models based on the data management structure of dexter. The benefit is some extra speed and less memory usage compared to using get_responses or get_testscores. The return value of get_resp_data can be used as the 'dataSrc' argument in analysis functions.

Usage

get_resp_data(
  dataSrc,
  qtpredicate = NULL,
  extra_columns = NULL,
  summarised = FALSE,
  env = NULL,
  protect_x = TRUE,
  retain_person_id = TRUE,
  merge_within_persons = FALSE,
  parms_check = NULL,
  raw = FALSE
)

get_resp_matrix(dataSrc, qtpredicate = NULL, env = NULL)

Arguments

dataSrc

data.frame, integer matrix, dexter database or 'dx_resp_data' object

qtpredicate

quoted predicate, e.g. quote(booklet_id=='bk01')

extra_columns

to be returned in addition to person_id, booklet_id, item_score, item_id

summarised

if TRUE, no item scores are returned, just booklet scores

env

environment for evaluation of qtpredicate, defaults to caller environment

protect_x

best set TRUE (default)

retain_person_id

whether to retain the original person_id levels or just use arbitrary integers

merge_within_persons

merge different booklets for the same person together

parms_check

data.frame of item_id, item_score to check for coverage of data

raw

if raw is TRUE, no sum scores, booklets, or design is provided and arguments, 'parms_check' and 'summarised' are ignored

Details

Regular users are advised not to use these functions as incorrect use can crash your R-session or lead to unexpected results.

Value

get_resp_data

returns a list with class 'dx_resp_data' with elements

x

when summarised is FALSE, a tibble(person_id, booklet_id, item_id, item_score, booklet_score [, extra_columns]), sorted in such a way that all rows pertaining to the same person-booklet are together

when summarised is TRUE, a tibble(person_id, booklet_id, booklet_score [, extra_columns])

design

tibble(booklet_id, item_id), sorted

get_resp_matrix

returns a matrix of item scores as commonly used in other IRT packages, facilitating easy connection of your own package to the data management capabilities of dexter