Skip to contents

Fetch Tables(s) from the Item Response Warehouse

Source: R/fetch.R
irw_fetch.Rd

Retrieves one or more tables from IRW and returns them as tibbles. If the table includes a character resp column, the function attempts to coerce it into numeric. Strings like "NA", "", and NA are treated as missing values. A warning is issued only if other non-numeric values are encountered.

Usage

irw_fetch(name, sim = FALSE, dedup = FALSE)

Arguments

name

Character vector of one or more table names (IRW table IDs).

sim

Logical, optional. If TRUE, fetches from the IRW simulation table. Defaults to FALSE.

dedup

Logical, optional. If TRUE, deduplicates responses based on timing variables. Defaults to FALSE.

  • If a 'date' column is present, no deduplication is performed.

  • If only a 'wave' column is present, one random response is retained per (id, item) pair within each wave.

  • If neither 'date' nor 'wave' is present, one random response is retained per (id, item) pair.

Value

If a single name is provided, returns a tibble. If multiple, returns a named list of tibbles (or error messages, if retrieval failed).

Examples

if (FALSE) { # \dontrun{
irw_fetch("environment_ltm")
irw_fetch("gilbert_meta_3", sim = TRUE)
irw_fetch("pks_probability", dedup = TRUE)
} # }