First attempt to fix #88

source/DATASETS.md

@@ -129,6 +129,13 @@ The companion `.bk2` files can be found in the `<participant>/<sess>/gamelogs` f
 Due to a programming error a certain number of game recording files were lost during acquisition, these repetitions are still listed in the events file but their `stim_file` field is left blank. Choice is left to the user whether to exclude the corresponding fMRI volumes or not for their analysis.
 :::
 
+## Hearing safety protocol
+
+This dataset contains behavioral and physiological data acquired through a variety of clinical audiology tests (see the [CNeuroMod docs](https://docs.cneuromod.ca/en/latest/MRI.html) and [Fortier et al. (2023)](https://doi.org/10.31234/osf.io/7xkng) for details on the dataset's context and acquisition).
+Participants underwent multiple test sessions (minimum = 4, maximum = 18, mean = 12, SD = 4.858) composed of different combinations of tests (experimental-condition dependant).
+
+For each of the participants, a `_sessions.tsv` file lists the available test data for each of the sessions.
+
 ## things
 
 N=4 participants completed between 33 (`sub-06`) and 36 (`sub-01`, `sub-02`, `sub-03`) fMRI sessions of a continuous recognition task with images from the [THINGS dataset](https://things-initiative.org/). The first session included 3 runs, and all subsequent sessions included 6 runs. Each 4.7 minutes run included 60 trials. For each trial, an image was shown in the center of the screen for 2.98s, followed by a 1.49s ISI. Subjects maintained fixation on a black fixation marker overlaid onto the image center and visible at all times throughout a run. Images were sampled from 720 THINGS categories. `sub-01`, `sub-02`, `sub-03` were shown 6 images per category (4320 unique stimuli), and `sub-06` was shown 5 images for 480 categories and 6 images for the remaining 240 (3840 unique stimuli).  

source/MRI.md

@@ -83,3 +83,36 @@ Participant’s respiration was measured using a custom MRI compatible respirati
 
 ## Mock scanner
 Some of our datasets required a comparison between genuine in-scanner conditions and "mock" conditions, where the subject was installed in a fake scanner that reproduced the comfort and aspect of an MRI scanner. This mock setup was also located at [UNF](https://unf-montreal.ca/), and was equipped with a monitor screen for stimulus presentation as well as audio headphones and response devices (keyboard and video game controller).
+
+## Auditory health monitoring
+
+In order to make sure no harm was caused to the participants' hearing, an auditory health monitoring protocol using a variety of commonly used clinical audiology tests.
+Baselines were acquired for each of the tests when the participants joined CNeuroMod (November 2018 - July 2019) and also at the beginning of this monitoring protocol (January - February 2021).
+
+### Auditory tests
+
+The tests used during this monitoring protocol included:
+ - Otoscopic examination
+ - Tympanometry test
+ - Stapedial reflex test
+ - Pure-tone audiometry test
+    - Standard/Clinical frequency range (250 Hz - 8 kHz)
+    - Extended/Ultra-high frequency range (9 kHz - 20 kHz)
+ - Matrix speech-in-noise perception test
+    - First language (English or French)
+    - Second language (French or English)
+ - Transient-evoked otoacoustic emissions (TEOAE)
+ - Distorsion product otoacoustic emissions (DPOAE)
+ - Distorsion product otoacoustic emissions' growth function
+    - for F2 = 2 kHz
+    - for F2 = 4 kHz
+    - for F2 = 6 kHz
+
+### Experimental conditions
+
+Two types of experimental conditions were developped to assess the potential short- and long-term impacts of the exposure to noise during scanning sessions.
+The first one comprised two separate sessions: one immediately before a scan and one immediately after that same scan.
+The second one comprised a single auditory test session scheduled between 48 hours and 7 days after a scan.
+The results acquired during the delayed sessions were then compared to the data acquired at baseline.
+
+For more details regarding the tests, the experimental conditions or the results, see [Fortier et al. (2023)](https://doi.org/10.31234/osf.io/7xkng).