22 Data dictionary and templates
22.1 Data overview
The primary deliverables for the project are two data files:
- Participant Data: 1 row per participant
- Trial Data: 1 row per trial, per participant (12 rows per participant)
In addition, labs are asked to submit DE-IDENTIFIED raw data files. For labs using eye trackers, this is raw gaze data (either as a single file or 1 file/participant), and for labs not using eye trackers, this is the output file generated by PsychoPy or another software program with stimulus and key press timing information.
22.2 MB5 Data Dictionary
The MB5 Data Dictionary lists all of the variables that should be included in the Participant Data and Trial Data files. Each row of the dictionary contains a variable and that variable’s specified format (e.g., string, integer), example value(s), and description. It is important that your lab’s data follows these specifications exactly in order to allow for data harmonization with the full dataset.
Note: The data dictionary contains two tabs (Participant Data, Trial Data)
22.3 MB5 Data templates
Participant Data
- 1 row per participant
- columns for each participant-level variable (e.g., subject ID, age, sex, parent education, data from the Demographics and Object Experience Questionnaires)
- name your Participant Data file according to this naming convention:
mb5_LabID_participant-data.csv
Trial Data
- 1 row per trial/12 rows per participant
- columns for trial- and trial-phase-level data (e.g., trial number, condition, looking time, presentation time).
- name your Trial Data file according to this naming convention:
mb5_LabID_trial-data.csv
Use consistent participant identifiers across files
These two files must use identical, anonymous subject identifiers (participant_id). We must be able to link participant- and trial-level data across files! You can use your lab’s normal participant numbering convention (e.g., 001, 002, 003, etc.), as long as participant_ID DOES NOT include any private information (e.g., initials, birth date).
Submit de-identified data ONLY
These files must contain de-identified data ONLY. All potentially identifying information should be stripped from your data files BEFORE submission. For example, you SHOULD NOT include birth date and test date in your Participant Data file. Instead, use an age calculating tool (e.g., https://www.calculator.net/age-calculator.html) to calculate each participant’s age in days, and report that value in the age_days variable. In addition, participant_id SHOULD NOT contain any personal information (e.g., name, birthdate, initials) and should instead be completely de-identified (e.g., mb5-01, mb5-02, etc.). If you have any questions about ensuring your data is de-identified, email us.
Keep computer readability in mind
It’s really important to remember that these files are designed to be read by a computer program, not a person. Anything that violates the templates (e.g., variables that aren’t of the specified type, missing data, comments, etc.) will not work. For example, cells in the column lang1_exposure in the participant data file should contain numbers ONLY. If you write “80 to 90” this will cause errors because it contains characters in addition to numbers. That said, we also want your files to make sense to a human. Please use the specified columns (e.g., session_exclusion_info, notes) to add information that will help others understand your data. If you have questions or comments, please communicate directly with the analysis team rather than embedding them in the data files.
Note: please check questionnaire responses before participants leave the lab to avoid accidental non-responses or other issues that would make data harmonization difficult or impossible.
No blank cells!
Please do not leave any fields blank. If something does not logically have an answer, if you did not collect this information, or if a respondant intentionally left a field blank, please mark it in your data file as “NA”.
CSV formatting
Files must be in CSV (comma separated values) format. PLEASE NOTE that saving in this format will remove any formulas or other non-plain-text features of your spreadsheet (e.g,. color fills, formatting); all information should be captured in the text within each cell.
Please download a copy of each template below and use them as guides for formatting your lab’s data.1
1 The templates include some sample data to supplement the data dictionary. Make sure to delete this sample data from the templates before entering your own data!