IRW Collections

Collections are labelled groupings of IRW tables. Ask for a type of data — randomized trials, Big Five inventories, anything with a Q matrix — and get back the tables, ready to fetch.

A table belongs to as many collections as apply: frac20 is in both math and q_matrix.

WarningPlease check a collection before relying on it

Membership is our judgment, and you should verify it for your own purposes. Most collections are assigned by a rule — the presence of a column, or a pattern matched against the construct name each table was annotated with. A pattern over free text will sometimes catch a table you would exclude, and miss one you would include. continuous_response and the exact-instrument collections are assigned by hand, table by table, which makes them a judgment of a different kind rather than a safer one: most exact-instrument members were identified from wording IRW supplied, not from the study’s own materials (see Exact instruments). Every membership records the basis on which it was decided — see irw_collection_members() — so you can inspect a collection and form your own view; please do so before using one as the sample for an analysis.

Coverage is also uneven. Collections built from the tag annotations searched only the 3,287 of 5,604 tables whose tags include a construct name, and that field is much sparser in the newer warehouses. 12 of the 44 collections below are marked tagged-subset-only for that reason: they are useful starting points, but they are not exhaustive, and they lean toward older tables. Treat them as “the ones we know of”, not “all of them”. The rest searched every documented table.

Corrections are welcome — open an issue on ben-domingue/irw.

Using a collection

Code
library(irw)

irw_collections()                    # what exists: kind, definition, coverage, size
tabs <- irw_collection("depression") # table names, and a note on coverage

# Narrow to a modellable corpus. Note irw_filter()'s default density = c(0.5, 1),
# which drops more tables than the sample-size cut alone would.
tabs <- irw_filter(collection = "depression", n_participants = c(500, Inf))

dat <- irw_fetch(tabs)               # named list, one long-format table each
irw_save_bibtex(tabs, output_file = "depression.bib")

# Cross-collection questions -- what no single filter argument reaches.
# Math assessments administered in booklets: linking and DIF work.
intersect(irw_collection("math"), irw_collection("multistage"))

# Note c(...) is a UNION, not an intersection:
irw_filter(collection = c("rct", "response_time"))

irw_collection_members(tables = "frac20")   # which collections is this table in?

# Exact-instrument collections: keep only tables whose own item text was checked.
m <- irw_collection_members(collection = "phq9")
m[startsWith(m$basis, "wording"), ]
Code
import irw

irw.collections()
tabs = irw.collection("depression")

tabs = irw.filter(collection="depression", n_participants=[500, None])
dat  = irw.fetch(tabs)               # dict keyed by table name

sorted(set(irw.collection("math", quiet=True)) &
       set(irw.collection("multistage", quiet=True)))

irw.filter(collection=["rct", "response_time"])   # union, not intersection
irw.collection_members(tables="frac20")

m = irw.collection_members(collection="phq9")
m[m.basis.str.startswith("wording")]

Study & instrument design

How the study was run, and what structure the data carries. Derived from the columns each table actually has, so these cover every documented table; the exceptions are continuous_response and trials, which are hand-curated.
clustered
Clustered
Carries cluster_id: respondents are nested in groups.
123 tablesof all 5,604
continuous_response
Continuous response
Responses fall on a (near-)continuous response scale (a slider, a 0-100 rating, a visual analogue scale, a magnitude estimate: the respondent places a judgement on a continuum, which need not have fixed ends) rather than a small ordered set. Measured quantities (income, minutes, counts, amounts consumed) are not response scales and are never members (#1700). Membership is per table, so a table qualifies only if most of its items (at least half) are continuous; a table with a few sliders among Likert or binary items is not a member, and its continuous items are not listed here (#1700). Not derivable: item_format and n_categories disagree on most candidates, so membership is curated. Seeded from irw_site/continuous_scout_candidates.csv; see continuous_response.review.csv for unpromoted candidates.
24 tableshand-curated
intensive_longitudinal
Intensive longitudinal
Has both date and wave. Timestamped repeated measures: daily diaries, panel waves and experience sampling are all included, so this is not an EMA collection.
85 tablesof all 5,604
item_position
Item position
Carries position: administration order is recorded per response.
117 tablesof all 5,604
longitudinal
Longitudinal
Flagged longitudinal by 01_metadata.R. That flag greps the concatenated variable string, so it also matches names like cov_birthdate and cov_startdate; 9 of its members match only that way.
832 tablesof all 5,604
multistage
Multistage / booklet
Carries booklet or block_id: items were administered in structured blocks.
164 tablesof all 5,604
q_matrix
Q matrix
Carries qmatrix* columns, the IRW standard item-by-attribute encoding for cognitive diagnostic modeling (datastandard.md).
11 tablesof all 5,604
rater_mediated
Rater-mediated
Carries rater: responses are attributed to a judge, not only to a respondent.
49 tablesof all 5,604
rct
RCT
Carries a treat column: an experimental assignment is recorded alongside the responses.
239 tablesof all 5,604
response_time
Response time
Carries rt: per-response latencies are available.
170 tablesof all 5,604
trials
Trials (cognitive tasks)
Repeated-trial cognitive and executive-function tasks: flanker, Stroop, hearts and flowers, go/no-go, SART, Simon, stop-signal, task switching, span tasks, and speeded perceptual or lexical decisions. Each row is one trial; item is the stimulus or condition, resp is accuracy, and rt and trial_* columns carry latency and trial detail. Fixed-item ability tests (Raven, CRT), memory tests and questionnaires about attention are not members. Hand-curated: the trial_* prefix is neither necessary (older tables predate it) nor sufficient (sports attempts and practice logs carry it too).
52 tableshand-curated

Instrument family

Which measure was administered. These group together tables that record the same instrument under different names — the Big Five tables alone are spread across more than forty spellings of the construct name.
affect_panas
PANAS affect
The Positive and Negative Affect Schedule.
27 tablesof 3,287 searched
big_five
Big Five / FFM
Five-factor and HEXACO personality inventories, including tables covering a single subscale.
80 tablesof 3,287 searched
dark_triad
Dark Triad
Narcissism, Machiavellianism and psychopathy measures.
40 tablesof 3,287 searched
intl_assessment
International assessments
Large-scale international assessments: PISA, TIMSS, PIRLS, NAEP.
33 tablesof 3,287 searched
mindfulness
Mindfulness
Mindfulness inventories including FFMQ and MAAS.
24 tablesof 3,287 searched
promis
PROMIS
The PROMIS instrument family.
40 tablesof 3,287 searched
self_esteem
Self-esteem
Rosenberg and other self-esteem scales.
27 tablesof 3,287 searched

Exact instruments

Each of these lists the tables that administered one specific instrument: the full scale, at least 80% of its items, or one whole subscale. Short forms, lengthened adaptations and reworded versions are left out. Every membership was decided table by table, and its basis says how the table was identified:

  • wording: the study’s own item text matches the instrument. Identity is observed.
  • supplied: IRW identified the instrument and supplied its canonical wording, so a wording match only confirms that identification. Identity is asserted.
  • name: there is no usable English item text; only the table’s metadata names the instrument.
A note after the basis marks a partial table (partial: 18/20 items) or a single subscale (subscale: anxiety (7/21)). For the strictly verified set, keep members whose basis starts with wording. The method is written up in the collections README.
PHQ-9phq934 tables · 2 wording
PANASpanas28 tables · 4 wording

the Positive and Negative Affect Schedule (20 items)

Table Basis Note
kraft_todd_2017_panas wording
PEMAIW_Qiu_2020_PANAS wording
stoyel_2021_neg_affect wording subscale: negative affect (10/20)
stoyel_2021_pos_affect wording subscale: positive affect (10/20)
CV_OASIS_ODSIS_PPE_Novak_2020_PANAS supplied
estevezlopez_2016_panas supplied
florida_twins_behavior_panas supplied
florida_twins_panas supplied
FomoNegativeAffect_cremer_2026_panas supplied
kotsou_2016_panas supplied
lee_2024_panas supplied
liu_2018_panas supplied
medvedev_2018_pan supplied
threat_isler_2024_exp1_cog_panas supplied
threat_isler_2024_exp1_incentive_panas supplied
threat_isler_2024_exp2_cog_panas supplied
threat_isler_2024_exp2_picture_panas supplied
threat_isler_2024_exp3_cog_panas supplied
threat_isler_2024_exp4_cog_panas supplied
wolters2026_panas_na supplied subscale: negative affect (10/20)
wolters2026_panas_pa supplied subscale: positive affect (10/20)
fcupanas_cffsdas_reyna_2018 name
jovanovic_2026_conscientiousness_panas_na name subscale: negative affect (10/20)
pierro_2018_negaffect_s3 name subscale: negative affect (10/20)
pierro_2018_posaffect_s3 name subscale: positive affect (10/20)
PPPASBPNSSedaisw_Pedro_2022_PANAS name
qi_2025_panas name partial: 18/20 items
rahm_2017_panas name
GAD-7gad727 tables · 2 wording
Rosenberg Self-Esteem Scalerses25 tables · 2 wording
Satisfaction With Life Scaleswls22 tables · 0 wording
DASS-21dass2120 tables · 2 wording

the Depression Anxiety Stress Scales, 21-item form

Perceived Stress Scale (PSS-10)pss1020 tables · 0 wording
CES-Dcesd12 tables · 4 wording

the Center for Epidemiologic Studies Depression Scale (20 items)

BFI-44bfi4410 tables · 0 wording

the Big Five Inventory, 44 items (John, Donahue & Kentle 1991)

Table Basis Note
amatus_cipora_2024_bfi_n supplied subscale: neuroticism (8/44)
celik_2026_bfi name
conner_2017_bfi name
CV_OASIS_ODSIS_PPE_Novak_2020_BFI name subscale: neuroticism (8/44)
ibrahim_2015_bfi name
kushnir2017_bfi name
robison_2026_retesting_bfi name
talaifar_2025_study1_bfi name
teq_novak_2021_bfin name subscale: neuroticism (8/44)
woodall_2020_bfi44 name
TIPItipi9 tables · 6 wording

the Ten-Item Personality Inventory

General Self-Efficacy Scalegse8 tables · 1 wording

the General Self-Efficacy Scale (10 items; Schwarzer & Jerusalem)

ERQerq7 tables · 1 wording

the Emotion Regulation Questionnaire (10 items; Gross & John 2003)

Table Basis Note
ecps_sahm_2024_emotion wording
li_2024_bdyz supplied subscale: suppression (4/10)
moe2025_erq supplied
morales_2021_erq supplied
zhao_2024_erq supplied
garciabatista_2021_erq name
SV-MAIA2_Randelovic_2021_ERQ name
Insomnia Severity Indexisi7 tables · 0 wording

the Insomnia Severity Index (7 items)

Table Basis Note
ali_2021_isi supplied
kim_2025_isi supplied
han_2026_isi name
hellstrom_2019_isi name
isi_insomnia_wang2025 name
nguyen_2026_isi name
su_2024_isi name
MSPSSmspss6 tables · 1 wording

the Multidimensional Scale of Perceived Social Support (12 items)

Table Basis Note
ehealth_rioux_2025_mssps wording
chen2022b_socsupport supplied
jeilani_2024_social_outcomes supplied subscale: significant other (4/12)
laksmita_2020_mspss supplied
nguyen_2026_mspss supplied
qi_2024_mspss name
BFI-10bfi105 tables · 0 wording

the 10-item Big Five Inventory (Rammstedt & John 2007)

Table Basis Note
c19prc_uk_mcbride_2021_bfi10 name
doherty_2023_bfi10 name
heekerens2025_bfi_extraversion name subscale: extraversion (2/10)
heekerens2025_bfi_neuroticism name subscale: neuroticism (2/10)
heekerens2025_bfi_openness name subscale: openness (2/10)
Brief COPEbrief_cope5 tables · 1 wording

the Brief COPE (28 items; Carver 1997)

Table Basis Note
koirala_2024_brief_cope wording
graves_2021_brief_cope supplied
hannachi_2025_eco_anxiety_cope name
IJLS_Eersel_2024_DenialAcceptance name subscales: denial and acceptance (4/28)
menaldi_2023_brief_cope name
Fear of COVID-19 Scalefcv19s5 tables · 0 wording

the Fear of COVID-19 Scale (7 items; Ahorsu et al. 2020)

LOT-Rlotr5 tables · 0 wording

the Life Orientation Test-Revised (10 items, of which 6 are scored and 4 are fillers; a table with the 6 scored items counts)

Table Basis Note
conner_2017_lot name scored items: 6/10 (fillers not deposited)
IJLS_Eersel_2024_Optimism name scored items: 6/10 (fillers not deposited)
liu_2018_lot_r name
lorenz_2016_optimism2 name
SABFI2_Gallardo_Pujol_2018_LOT name scored items: 6/10 (fillers not deposited)
PCL-5pcl55 tables · 2 wording

the PTSD Checklist for DSM-5 (20 items)

Table Basis Note
BPAQ_Christopher_2024_PCL5 wording
wesselmann_2018_pcl wording
armour_2017_pcl5 supplied
orovou_2021_pcl5 supplied
pcl5_xiong_2025 supplied
Short Dark Triadsd35 tables · 2 wording

the Short Dark Triad (SD3, 27 items)

Table Basis Note
dinic_2025_shortdarktriad wording
short_dark_triad wording
qi_2025_dark_triad supplied
sd3ypl_klimczak_2019_sd3 name partial: 26/27 items
west_2021_retaliatory_aggression_study3_sd3_psychopathy name subscale: psychopathy (9/27)
UCLA Loneliness Scale (20 items)ucla_ls3 tables · 0 wording

a 20-item UCLA Loneliness Scale (the 1980 revision or Version 3; their wording differs)

Construct

What is being measured, across instruments.
anxiety
Anxiety
Anxiety scales including GAD-7 and STAI.
121 tablesof 3,287 searched
depression
Depression
Depression scales including PHQ, CES-D, BDI and DASS.
102 tablesof 3,287 searched
math
Mathematics
Mathematics attainment: tests of mathematical knowledge or skill. Attitudes, anxiety, self-efficacy, self-concept, beliefs and stereotypes about mathematics are not members (#1700).
73 tablesof 3,287 searched
reading_vocab
Reading & vocabulary
Reading, vocabulary, lexical and spelling measures.
56 tablesof 3,287 searched
wellbeing
Wellbeing
Wellbeing, life satisfaction and quality of life measures.
88 tablesof 3,287 searched

How collections are built

Each collection is one row in a version-controlled registry carrying its definition and the rule that produces its membership — the presence of a column (treat for rct, qmatrix* for q_matrix), or a pattern over the recorded construct name. continuous_response is assembled by hand, because the available signals disagree too often for a rule to settle it. The exact-instrument collections are also assembled by hand: a script proposes candidates and checks their item text against the instrument’s wording, and each membership is then decided table by table (see issue #1712).

Adding a collection is therefore a change to data, not to code, and every membership records the basis on which it was decided. That last point is deliberate: a rule-assigned membership and a hand-assigned one carry different weight, and both are open to being wrong, so the record of how a table got into a collection travels with the collection itself. See issue #1633.