get_resp_data function

Functions for developers

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.

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

Returns

• 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

Details

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