enh: large overhaul, including initial flowchart of the experiment

docs/data-collection/participant-prep.md

@@ -29,12 +29,13 @@
         - [ ] Accompany them to the bathroom (situated at {{ secrets.rooms.bathroom | default("███") }}), and ask whether there is anything else they anticipate they will need.
         - [ ] If the test is positive, the person **CANNOT PARTICIPATE** in the study. <mark>You MUST be understanding of the situation as most likely the person will not be aware of the circumstance</mark>.
 
-- [ ] Tell the participant they will be holding an alarm button throughout the session, and that they may use it any time whenever they need to stop the experiment.
+- [ ] Instruct the participant on how to use the alarm button:
 
-    > During the duration of the exam, you'll have an alarm button on your hand.
-    > You can use it at any moment.
-    > We will first talk with you to check everything is fine, and we will stop the session whenever you need to stop the experiment.
-    > There is no need for you to endure uncomfortable experiences or anxiety (for instance, if you feel claustrophobic)
+    ???+ quote "Alarm button should be used when needed"
+        During the duration of the exam, you'll have an alarm button on your hand.
+        You can use it at any moment.
+        We will first talk with you to check everything is fine, and we will stop the session whenever you need to stop the experiment.
+        There is no need for you to endure uncomfortable experiences or anxiety (for instance, if you feel claustrophobic)
 
 ### Describing the development of the session
 - [ ] Describe the participant how the session will develop, with special attention to tasks. In the first session, show the task while explaining them for clarity. Let them interrupt you to ask for clarifications and answer all the questions that may arise.
@@ -116,13 +117,21 @@
         Is everything clear to you? Do you have any questions?
 
 ### Finalizing the preparation
-- [ ] Indicate the participant where the door to the changing room is if changing into scrubs is necessary. Otherwise, offer them a box to deposit everything they have in their pockets and all jewelry/hair accessories.
+- [ ] Offer the participant a box to deposit everything they have in their pockets and all jewelry/hair accessories, and indicate the clothing to enter the scanning room:
 
-    > Before we continute, we need to make sure we do not introduce any dangerous object in the magnet room.
-    >
-    > [IF THEY NEED TO CHANGE INTO SCRUBS] Here you will find a changing room, I have prepared some scrubs for you. Please remove all your clothes and leave them in the changing room. Please keep your underwear on (if a woman, double check that **their undergarment DOES NOT contain any large metallic part** such as shaping guides, and request their removal if they do).
-    >
-    > [IF THEY CAN WEAR THEIR CLOTHES] Please deposit here all your belongings, your belt, your glasses, your jewelry and any accessories, piercings, etc. that you have on you.
+    ??? quote "*Dress code* inside the scanner **if they need to CHANGE INTO SCRUBS**"
+        Before we continute, we need to make sure we do not introduce any dangerous object in the magnet room.
+
+        Here you will find a changing room [SHOW THEM THE CHANGING ROOM].
+        I have prepared some scrubs for you.
+        Please remove all your clothes and leave them in the changing room.
+        Please keep your underwear on [if a woman, ask whether **their undergarment DOES NOT contain any large metallic part** such as shaping guides, and request their removal if they do].
+
+    ???+ quote "*Dress code* inside the scanner **if they CAN WEAR THEIR CLOTHES**"
+        Before we continute, we need to make sure we do not introduce any dangerous object in the magnet room.
+
+        Please deposit here all your belongings, your belt, your glasses, your jewelry and any accessories, piercings, etc. that you have on you.
+        If a woman, ask whether **their undergarment DOES NOT contain any large metallic part** such as shaping guides, and request their removal in the changing room.
 
 - [ ] Help the participant to prepare their skin and place the ECG electrodes:
 
@@ -168,7 +177,7 @@
 
 ## Installing the participant in the SCANNING ROOM
 
-??? info "Thanks to Stephanie Bogaert, MSc, Pieter Vandemaele, MSc and Pim Pullens, PhD"
+??? thanks "Thanks to Stephanie Bogaert, MSc, Pieter Vandemaele, MSc and Pim Pullens, PhD"
     Some of the pictures in this section have been extracted from the [Ghent Institute for functional and Metabolic Imaging MRI User 2019](http://gifmi.ugent.be/drupal/system/files/documents/GIfMI_MRI%20user%20manual_BASIC_SiemensPrisma_EN.pdf) written by Stephanie Bogaert, MSc, Pieter Vandemaele, MSc and Pim Pullens, PhD. We express our gratitude that they put together such a comprehensive guide.
 
 - [ ] Have the participant remove their shoes at the entrance of the scanning room.

docs/data-collection/pre-session.md

@@ -1,8 +1,42 @@
+Instructions of operations to be performed before the participant arrival, **before EACH session** (i.e., DAY OF SCAN)
 
-!!! info "Thanks"
-    All the documentation about the eye-tracker is derived from Benedetta Franceschiello's user guide. We greatly appreciate her help with the eye-tracker.
 
-Instructions of operations to be performed before the participant arrival, **before EACH session** (i.e., DAY OF SCAN)
+## Three days BEFORE THE FIRST SESSION
+
+- [ ] Verify that as part of the [recruitement and screening procedure](../recruitment-scheduling-screening/recruitment.md), you have sent a copy of the MRI Safety and screening form ([EN](../assets/files/safety_form_EN.pdf)|[FR](../assets/files/safety_form_FR.pdf)) to the participant over email and confirm reception by checking the 'First contact email sent' column in [our recruits spreadsheet]({{ secrets.data.recruits_url | default("/redacted.html") }}).
+- [ ] Verify also that you confirmed that the participant has read and understood the document, and in particular, you double-checked that they do not have any MRI contraindications, by checking the 'Phone interview done' and 'Participant volunteer and eligible' column in [our recruits spreadsheet]({{ secrets.data.recruits_url | default("/redacted.html") }}).
+- [ ] If the phone call interview was more than three days before the first session, call the participant again to reconfirm the following information:
+    - [ ] Remind the participant that any jewelry should be removed prior to the scan.
+    - [ ] Indicate that they MUST shave the upper area of their chest where the ECG electrodes will be placed, if there is hair. The ECG electrodes MUST directly contact the skin.
+    - [ ] Confirm clothing:
+        - [ ] if allowed to wear street clothes, remind the participant to avoid clothing with metal or that would uncomfortable to lie in for the duration of the scan; otherwise
+        - [ ] remark the participant they will be given a gown and they will need to change before every session.
+    - [ ] Repeat at what time and where will you meet the participant.
+    - [ ] Verify that the participant has your phone number {{ secrets.phones.study | default("███") }} to call you in case he gets lost.
+    - [ ] **FEMALE PARTICIPANTS ONLY**: Remind the participant that pregnant women cannot undergo our MRI protocols. Therefore, they will take a pregnancy test (which we will have prepared) before the first session.
+- [ ] If participant has indicated nervousness or history of claustrophobia, organize a session to use the mock scanner.
+
+## BEFORE DAY OF SCAN
+
+- [ ] Print [the informed consent form](../assets/files/icf_FR.pdf) (**first session only**), an MRI safety screener ([EN](../assets/files/safety_form_EN.pdf)|[FR](../assets/files/safety_form_FR.pdf)) and a receipt form for each participant that will get scanned.
+- [ ] Make sure you have internet access, and update the [HCPh-fMRI-tasks repository](https://github.com/TheAxonLab/HCPh-fMRI-tasks) on *{{ secrets.hosts.psychopy | default("███") }}*:
+    ```
+    git fetch upstream
+    git checkout main
+    git rebase upstream/main
+    ```
+- [ ] On the *{{ secrets.hosts.psychopy | default("███") }}* laptop, open a terminal and execute `conda deactivate`.
+- [ ] Open psychopy 3 by typing `psychopy`
+- [ ] Load in the different experiments and check for proper functioning:
+    - [ ] {{ settings.psychopy.tasks.func_rest }} (resting-state fMRI):
+        - [ ] time it to [confirm the length](preliminary.md#task-timing), and
+        - [ ] check that the movie is played.
+    - [ ] {{ settings.psychopy.tasks.func_bht }} (breath-holding task, BHT):
+        - [ ] time it to [confirm the length](preliminary.md#task-timing), and
+        - [ ] check that the movie is played.
+    - [ ] {{ settings.psychopy.tasks.func_pct }} (positive-control task, PCT):
+        - [ ] time it to [confirm the length](preliminary.md#task-timing), and
+        - [ ] check that the movie is played.
 
 ## Documentation and other non-experimental devices
 
@@ -136,6 +170,11 @@ Instructions of operations to be performed before the participant arrival, **bef
 
 ## Setting up the ET arm
 
+??? thanks "Thanks to Benedetta Franceschiello!"
+
+      All the documentation about the ET is derived from Benedetta Franceschiello's user guide.
+      We greatly appreciate her help with the device.
+
 - [ ] Go to room {{ secrets.rooms.et_camera | default("███") }} and bring the blue box labeled *Eye-Tracker only for fMRI* into the scanning room.
     This box contains the ET arm with the camera and infrared lamp mounted on it, lenses, and the special infrared mirror.
     The box should be found in the first cabinet on the left section of the cupboard.