Skip to content

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_id values in every .tsv must correspond to entries in participants.tsv and to sub- 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/a values.

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.