diff --git a/mkdocs.yml b/mkdocs.yml index ef36d6eb5c..181e0d15f8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -20,6 +20,7 @@ nav: - Near-Infrared Spectroscopy: modality-specific-files/near-infrared-spectroscopy.md - Motion: modality-specific-files/motion.md - Magnetic Resonance Spectroscopy: modality-specific-files/magnetic-resonance-spectroscopy.md + - Stimuli: modality-specific-files/stimuli.md - Derivatives: - BIDS Derivatives: derivatives/introduction.md - Common data types and metadata: derivatives/common-data-types.md diff --git a/src/modality-specific-files/stimuli.md b/src/modality-specific-files/stimuli.md new file mode 100644 index 0000000000..b41f6baea3 --- /dev/null +++ b/src/modality-specific-files/stimuli.md @@ -0,0 +1,161 @@ +# Stimuli + +## Stimulus Files Organization + +Stimulus files MUST be stored in the `/stimuli` directory under the root directory of the dataset. +The `/stimuli` directory can contain subdirectories to organize the stimulus files. +Stimulus files MUST follow the BIDS naming conventions and are referenced in the `events.tsv` +file using the `stim_id` column. + +The standardization of stimulus files and their annotations within BIDS offers several key benefits: + +1. **Consistency**: Ensures uniform storage and referencing across datasets +1. **Reusability**: Enables stimulus reuse across studies through standardized structure +1. **Efficiency**: Minimizes redundancy by centralizing annotations +1. **Flexibility**: Facilitates dataset reuse with alternative annotations + +To preserve backward compatibility with existing datasets (see the Legacy section below), the use of these specifications for the `/stimuli` directory and the `stim_id` column in the `events.tsv` files is RECOMMENDED but not required. Researchers are encouraged to follow these guidelines to enhance the interoperability and reproducibility of their studies. + +Following these guidelines will help ensure that stimulus files and their annotations are stored and referenced consistently across different datasets, facilitating data sharing, reuse, and reproducibility. + +## File Organization + + +{{ MACROS___make_filetree_example({ + "stimuli": { + "stimuli.tsv": "", + "stimuli.json": "", + "[stim-