Step 3: Complete and add data to your dataset¶
Repeat for all questionnaires¶
Repeat Step 1 (TSV) and Step 2 (JSON) for each assessment tool in your dataset. Every questionnaire needs its own pair of files.
A complete example for the Toronto Alexithymia Scale (TAS-26):
| Tabular file | JSON sidecar |
|---|---|
toronto_alexithymia_scale.tsv |
toronto_alexithymia_scale.json |
Add files to the phenotype directory¶
Place all .tsv and .json files in a phenotype/ directory at the root of your BIDS dataset:
<dataset>/
├── participants.tsv
├── participants.json
├── phenotype/
│ ├── beck_depression_inventory.tsv
│ ├── beck_depression_inventory.json
│ ├── patient_health_questionnaire.tsv
│ ├── patient_health_questionnaire.json
│ └── toronto_alexithymia_scale.tsv
│ └── toronto_alexithymia_scale.json
├── sub-01/
│ └── ...
└── sub-02/
└── ...
Ensure participant IDs are consistent¶
- The
participant_idvalues in every.tsvmust correspond to entries inparticipants.tsvand tosub-directories in the dataset. - Any participant for whom you have questionnaire data must be listed in
participants.tsv. - If a participant did not complete a questionnaire, include their row with
n/avalues.
Longitudinal datasets¶
If questionnaires were administered in multiple sessions, add the session label to the file name:
phenotype/
├── beck_depression_inventory_ses-01.tsv
├── beck_depression_inventory_ses-01.json
├── beck_depression_inventory_ses-02.tsv
└── beck_depression_inventory_ses-02.json
Participants who did not attend a session should have n/a for all items in that session's file.