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.
datasets
Section titled “datasets”| Field | Type | Description |
|---|---|---|
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) |
subjects
Section titled “subjects”| Field | Type | Description |
|---|---|---|
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) |
administrations
Section titled “administrations”| Field | Type | Description |
|---|---|---|
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. One of 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) |
trials
Section titled “trials”| Field | Type | Description |
|---|---|---|
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_types
Section titled “trial_types”| Field | Type | Description |
|---|---|---|
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 valuesaar, 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. Some requirements for being considered a standard/ vanilla trial
|
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) |
stimuli
Section titled “stimuli”| Field | Type | Description |
|---|---|---|
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. One of 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_timepoints
Section titled “aoi_timepoints”| Field | Type | Description |
|---|---|---|
aoi_timepoint_id key | integer | row identifier for the aoi_timepoints table indexing from zero |
aoi | string | name of the looking location. One of 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_timepoints
Section titled “xy_timepoints”| Field | Type | Description |
|---|---|---|
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_sets
Section titled “aoi_region_sets”| Field | Type | Description |
|---|---|---|
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)) |
Auxiliary data
Section titled “Auxiliary data”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
| Field | Type | Description |
|---|---|---|
cdi_responses | JSON | JSON object for CDI responses |
cdi_responses.instrument_type | string | CDI version/instrument used (wg, ws, wgshort or wsshort) |
cdi_responses.measure | string | CDI measure (comprehension or production) |
cdi_responses.rawscore | numeric | CDI raw vocabulary score |
cdi_responses.percentile | numeric | CDI percentile (as reported in the raw data) |
cdi_responses.age | numeric | age of the participant in months when the instrument was administered |
cdi_responses.language | string | CDI language (in Wordbank format) |
lang_exposures | JSON | JSON object for language exposures |
lang_exposures.language | string | language that a child is exposed to (in Wordbank format) |
lang_exposures.exposure | numeric | percentage exposure in a given language |
lang_measures | JSON | Scores on language measures other than the CDI |
lang_measures.instrument_type | string | The specific language development measure used (e.g., LUI, LDS, DVAP) |
lang_measures.rawscore | numeric | raw score in the language measure instrument |
lang_measures.age | numeric | age of the participant in months when the instrument was administered |
lang_measures.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
| Field | Type | Description |
|---|---|---|
full_phrase_language_non_iso | string | language of the full phrase if the language is not represented in ISO 639-2 |
datasets
Section titled “datasets”| Field | Type | Description |
|---|---|---|
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) |
subjects
Section titled “subjects”| Field | Type | Description |
|---|---|---|
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 |
administrations
Section titled “administrations”| Field | Type | Description |
|---|---|---|
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. One of 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).
|
trials
Section titled “trials”| Field | Type | Description |
|---|---|---|
trial_id key | integer | row identifier for the trials table indexing from zero; a row stands for one trial type at one position and is shared by every administration that saw that trial type there |
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 |
trial_types
Section titled “trial_types”| Field | Type | Description |
|---|---|---|
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 valuesaar, 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) |
stimuli
Section titled “stimuli”| Field | Type | Description |
|---|---|---|
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. One of image path (taken from the image path), experiment documentation (based on experiment documentation), Peekbank discretion (generated by the importer/ Peekbank team).
|
aoi_timepoints
Section titled “aoi_timepoints”| Field | Type | Description |
|---|---|---|
aoi_timepoint_id key | integer | row identifier for the aoi_timepoints table indexing from zero |
aoi | string | name of the looking location. One of 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_timepoints
Section titled “xy_timepoints”| Field | Type | Description |
|---|---|---|
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_sets
Section titled “aoi_region_sets”| Field | Type | Description |
|---|---|---|
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)) |
These releases have the same tables and fields as 2025.1 onward, except that these fields do
not exist: datasets.dataset_aux_data, subjects.subject_aux_data, administrations.administration_aux_data, trials.excluded, trials.exclusion_reason, trials.trial_aux_data, trial_types.vanilla_trial, trial_types.trial_type_aux_data, stimuli.stimulus_aux_data.