Skip to content
GitHub

Codebook

Every column in the Peekbank schema. See Data Schema for how the tables fit together. The schema changed with release 2025.1; pick the tab for the release you are using. A ? after a type means the value can be NA.

dataset_id key
integer
row identifier for the datasets table indexing from zero
lab_dataset_id
string?
lab-internal short name of the dataset
dataset_name
string
the name used for that dataset in Peekbank
shortcite
string
shortened citation (author (year) APA-style in-text citation)
cite
string
full citation (APA format)
dataset_aux_data
json?
optional additional information about the dataset in the format of a JSON (see Auxiliary data below for the keys in use)
subject_id key
integer
row identifier for the subjects table indexing from zero
sex
string
sex of the participants. One of female, male, other, unspecified.
native_language
string
participants' native language as an ISO 639-2 code; bilingual participants can have several codes, separated by ", "
lab_subject_id
string
lab unique participant identifier
subject_aux_data
json?
optional additional information about the subject in the format of a JSON (see Auxiliary data below for the keys in use)
administration_id key
integer
row identifier for the administrations table indexing from zero
dataset_id → datasets
integer
ID of the dataset
age
float?
age of the participant in months, converted from the age the lab recorded:
  • days: days / (365.25/12)
  • months: unchanged
  • decimal years: years * 12
  • whole years: years * 12 + 6
lab_age
float?
age of the participant as recorded by the lab, in lab_age_units
lab_age_units
string
unit of lab_age. One of days, months, years.
subject_id → subjects
integer
ID of the subject
monitor_size_x
integer?
width of the monitor (in pixels)
monitor_size_y
integer?
height of the monitor (in pixels)
sample_rate
float?
sampling rate of the eyetracker (in Hz) / frame rate for manual gaze coding
tracker
string?
name of the eye-tracker type/ data source (SMI/ iCoder/ Tobii/ etc.)
coding_method
string
method used in the experiment for coding gaze data.
  • eyetracking: gaze recorded by an eye tracker
  • manual gaze coding: looking coded by hand, frame by frame, from video
  • automated gaze coding: looking coded from video by software
  • preprocessed eyetracking: eyetracking with only AOI data available
administration_aux_data
json?
optional additional information about the administration in the format of a JSON (see Auxiliary data below for the keys in use)
trial_id key
integer
row identifier for the trials table indexing from zero
trial_order
integer
index of the trial in order of presentation for this participant during the experiment
trial_type_id → trial_types
integer
ID of the trial type
excluded
boolean
whether or not the trial was excluded in the data analysis conducted in the original experiment for which the data was collected
exclusion_reason
string?
the reason the trial was excluded in the original experiment that is the source of the data
trial_aux_data
json?
optional additional information about the trial in the format of a JSON (see Auxiliary data below for the keys in use)
trial_type_id key
integer
row identifier for the trial_types table indexing from zero
aoi_region_set_id → aoi_region_sets
integer?
ID of the AOI region set
dataset_id → datasets
integer
ID of the dataset
distractor_id → stimuli
integer
ID of the distractor stimulus
target_id → stimuli
integer
ID of the target stimulus
full_phrase
string?
Full phrase prompting the target
full_phrase_language
string
language of the full phrase: an ISO 639-2/B code, or multiple, artificial or other. The codes are listed in the 639-2/B column of https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
489 accepted values

aar, abk, ace, ach, ada, ady, afa, afh, afr, ain, aka, akk, alb, ale, alg, alt, amh, ang, anp, apa, ara, arc, arg, arm, arn, arp, art, arw, asm, ast, ath, aus, ava, ave, awa, aym, aze, bad, bai, bak, bal, bam, ban, baq, bas, bat, bej, bel, bem, ben, ber, bho, bih, bik, bin, bis, bla, bnt, tib, bos, bra, bre, btk, bua, bug, bul, bur, byn, cad, cai, car, cat, cau, ceb, cel, cze, cha, chb, che, chg, chi, chk, chm, chn, cho, chp, chr, chu, chv, chy, cmc, cop, cor, cos, cpe, cpf, cpp, cre, crh, crp, csb, cus, wel, dak, dan, dar, day, del, den, ger, dgr, din, div, doi, dra, dsb, dua, dum, dut, dyu, dzo, efi, egy, eka, gre, elx, eng, enm, epo, est, ewe, ewo, fan, fao, per, fat, fij, fil, fin, fiu, fon, fre, frm, fro, frr, frs, fry, ful, fur, gaa, gay, gba, gem, geo, gez, gil, gla, gle, glg, glv, gmh, goh, gon, gor, got, grb, grc, grn, gsw, guj, gwi, hai, hat, hau, haw, heb, her, hil, him, hin, hit, hmn, hmo, hrv, hsb, hun, hup, iba, ibo, ice, ido, iii, ijo, iku, ile, ilo, ina, inc, ind, ine, inh, ipk, ira, iro, ita, jav, jbo, jpn, jpr, jrb, kaa, kab, kac, kal, kam, kan, kar, kas, kau, kaw, kaz, kbd, kha, khi, khm, kho, kik, kin, kir, kmb, kok, kom, kon, kor, kos, kpe, krc, krl, kro, kru, kua, kum, kur, kut, lad, lah, lam, lao, lat, lav, lez, lim, lin, lit, lol, loz, ltz, lua, lub, lug, lui, lun, luo, lus, mac, mad, mag, mah, mai, mak, mal, man, mao, map, mar, mas, may, mdf, mdr, men, mga, mic, min, mis, mkh, mlg, mlt, mnc, mni, mno, moh, mon, mos, mul, mun, mus, mwl, mwr, myn, myv, nah, nai, nap, nau, nav, nbl, nde, ndo, nds, nep, new, nia, nic, niu, nno, nob, nog, non, nor, nqo, nso, nub, nwc, nya, nym, nyn, nyo, nzi, oci, oji, ori, orm, osa, oss, ota, oto, paa, pag, pal, pam, pan, pap, pau, peo, phi, phn, pli, pol, pon, por, pra, pro, pus, qaa-qtz, que, raj, rap, rar, roa, roh, rom, rum, run, rup, rus, sad, sag, sah, sai, sal, sam, san, sas, sat, scn, sco, sel, sem, sga, sgn, shn, sid, sin, sio, sit, sla, slo, slv, sma, sme, smi, smj, smn, smo, sms, sna, snd, snk, sog, som, son, sot, spa, srd, srn, srp, srr, ssa, ssw, suk, sun, sus, sux, swa, swe, syc, syr, tah, tai, tam, tat, tel, tem, ter, tet, tgk, tgl, tha, tig, tir, tiv, tkl, tlh, tli, tmh, tog, ton, tpi, tsi, tsn, tso, tuk, tum, tup, tur, tut, tvl, twi, tyv, udm, uga, uig, ukr, umb, und, urd, uzb, vai, ven, vie, vol, vot, wak, wal, war, was, wen, wln, wol, xal, xho, yao, yap, yid, yor, ypk, zap, zbl, zen, zgh, zha, znd, zul, zun, zxx, zza, multiple, artificial, other

point_of_disambiguation
integer
target onset time (relative to trial onset) in ms
target_side
string
part of the screen in which the target stimulus appears. One of left, right.
condition
string?
condition of the trial, worded as closely as possible to the original study
lab_trial_id
string?
trial label assigned within lab (or descriptive label of the trial)
vanilla_trial
boolean
whether or not the trial is a "standard" ("vanilla") looking-while-listening trial or includes additional manipulations.
Some requirements for being considered a standard/ vanilla trial
  • Familiar words (also no part-words)
  • Both target and distractor are familiar objects (i.e., each could be valid familiar targets; non-prototypical objects are OK, but unnatural/ artificially modified exemplars are not)
  • Target word is the first point of disambiguation
  • Well-formed/grammatical carrier phrase
  • No relevant “stuff”/information prenominally (e.g. semantically informative verbs, adjectives)
  • No nonsense words anywhere (including carrier phrase)
  • No language/ speaker/ accent/ etc. switching within trial
  • No duplicated target words
  • No intentional background noise or audio filtering
trial_type_aux_data
json?
optional additional information about the trial type in the format of a JSON (see Auxiliary data below for the keys in use)
stimulus_id key
integer
row identifier for the stimuli table indexing from zero
dataset_id → datasets
integer
ID of the dataset
stimulus_novelty
string
whether the stimulus word (not image) is novel or familiar. One of novel, familiar.
original_stimulus_label
string?
label of the stimulus in the original language of the study: the word used for the image when it is the target, or its label in the experiment design
english_stimulus_label
string?
label assigned to the stimulus translated into English
stimulus_image_path
string?
path to the image file, relative to raw_data/; NA if the raw data has no image file
lab_stimulus_id
string?
an id or name assigned to the stimulus by the original authors
image_description
string?
a short natural language description of the image
image_description_source
string
source of the natural language description.
  • image path: taken from the image path
  • experiment documentation: based on experiment documentation
  • Peekbank discretion: generated by the importer/ Peekbank team
stimulus_aux_data
json?
optional additional information about the stimulus in the format of a JSON (see Auxiliary data below for the keys in use)
aoi_timepoint_id key
integer
row identifier for the aoi_timepoints table indexing from zero
aoi
string
name of the looking location.
  • target: looking at the target
  • distractor: looking at the distractor
  • other: on-screen looking, but not in the AOI regions for target or distractor
  • missing: missing data, e.g. an off-screen look, blink or tracker error
administration_id → administrations
integer
ID of the administration
t_norm
integer
timestamp in ms, centered on the point of disambiguation of the target (= 0 ms); samples are 25 ms apart (40 Hz)
trial_id → trials
integer
ID of the trial
xy_timepoint_id key
integer
row identifier for the xy_timepoints table indexing from zero
administration_id → administrations
integer
ID of the administration
trial_id → trials
integer
ID of the trial
x
integer?
x-coordinate of gaze position at timepoint t (origin (0,0) is bottom left)
y
integer?
y-coordinate of gaze position at timepoint t (origin (0,0) is bottom left)
t_norm
integer
timestamp in ms, centered on the point of disambiguation of the target (= 0 ms); samples are 25 ms apart (40 Hz)
aoi_region_set_id key
integer
row identifier for the aoi_region_sets table indexing from zero
l_x_max
integer
maximum x-coordinate of the left AOI region (with the bottom left corner of the screen as origin (0,0))
l_x_min
integer
minimum x-coordinate of the left AOI region (with the bottom left corner of the screen as origin (0,0))
l_y_max
integer
maximum y-coordinate of the left AOI region (with the bottom left corner of the screen as origin (0,0))
l_y_min
integer
minimum y-coordinate of the left AOI region (with the bottom left corner of the screen as origin (0,0))
r_x_max
integer
maximum x-coordinate of the right AOI region (with the bottom left corner of the screen as origin (0,0))
r_x_min
integer
minimum x-coordinate of the right AOI region (with the bottom left corner of the screen as origin (0,0))
r_y_max
integer
maximum y-coordinate of the right AOI region (with the bottom left corner of the screen as origin (0,0))
r_y_min
integer
minimum y-coordinate of the right AOI region (with the bottom left corner of the screen as origin (0,0))

The *_aux_data columns hold JSON with the keys below. The top-level keys are optional; the indented fields sit inside nested JSON objects.

subject_aux_data

cdi_responses
JSON
JSON object for CDI responses
instrument_type
string
CDI version/instrument used (wg, ws, wgshort or wsshort)
measure
string
CDI measure (comprehension or production)
rawscore
numeric
CDI raw vocabulary score
percentile
numeric
CDI percentile (as reported in the raw data)
age
numeric
age of the participant in months when the instrument was administered
language
string
CDI language (in Wordbank format)
lang_exposures
JSON
JSON object for language exposures
language
string
language that a child is exposed to (in Wordbank format)
exposure
numeric
percentage exposure in a given language
lang_measures
JSON
Scores on language measures other than the CDI
instrument_type
string
The specific language development measure used (e.g., LUI, LDS, DVAP)
rawscore
numeric
raw score in the language measure instrument
age
numeric
age of the participant in months when the instrument was administered
language
string
language of the measure (in Wordbank format)
native_language_non_iso
string
name of participants' native language if the language is not represented in ISO 639-2

trial_type_aux_data

full_phrase_language_non_iso
string
language of the full phrase if the language is not represented in ISO 639-2