Skip to content

Commit d8b34f3

Browse files
authored
Update phenotype.md and phenotypic-and-assessment-data.md
Trying to address some of @rwblair's comments on the PR.
1 parent b95feec commit d8b34f3

File tree

2 files changed

+4
-6
lines changed

2 files changed

+4
-6
lines changed

src/appendices/phenotype.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ contains `"Phenotype"` in the `dataset_description.json`.
1818

1919
Aggregate participant information across all sessions into one tabular TSV file per
2020
measurement or phenotypic assessment and store this file in the `/phenotype` directory.
21-
Demographic information is a special case and MUST be aggregated
21+
Demographic information is a special case and SHOULD be aggregated
2222
in the `participants.tsv` file at the root level of the dataset.
2323
It is RECOMMENDED to use the `age` column in the `participants.tsv` file
2424
to record participant age at every session in longitudinal or multi-session data sets.
@@ -51,8 +51,8 @@ the smallest unit of acquisition). In other words:
5151
in the data set regardless of whether those sessions are in
5252
the `phenotype/` data, `sub-<label>/` data, or a combination of the two.
5353

54-
- If more than one of the same measurement tool is acquired within
55-
the same `session_id`, a `run_id` column MUST be added.
54+
- If a measurement tool is acquired multiple times within a single session,
55+
a `run_id` column MUST be added to disambiguate the separate acquisitions.
5656

5757
- A measurement tool’s acquisition time SHOULD be stored in the `sessions.tsv`
5858
file at the root-level of the dataset in the `acq_time` column.
@@ -74,8 +74,6 @@ all imaging data and tabular phenotypic data MUST have sessions.
7474

7575
This produces a file in which same-participant entries can take up as many rows as needed
7676
according to the smallest unit of acquisition.
77-
The combination of values in the `participant_id`, `session_id`, and `run_id` (if present)
78-
columns MUST be unique for the entire tabular file.
7977

8078
### 5. Store demographic data in the participants file and instrument data in the phenotype directory
8179

src/modality-agnostic-files/phenotypic-and-assessment-data.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ If the dataset includes multiple sets of participant level measurements (for
1414
example responses from multiple questionnaires) they can be split into
1515
individual files separate from `participants.tsv`.
1616

17-
Each of the measurement files MUST be kept in a `/phenotype` directory placed
17+
Each of the measurement tool files MUST be kept in a `/phenotype` directory placed
1818
at the root of the BIDS dataset and MUST end with the `.tsv` extension.
1919
Filenames SHOULD be chosen to reflect the contents of the file.
2020
For example, the "Adult ADHD Clinical Diagnostic Scale" could be saved in a file

0 commit comments

Comments
 (0)