update instructions

Instructions/config.txt

-;to place at %appdata%\..\LocalLow\CERV\VR-PPE\
-;create the path if it didn't exist
-
 [userid]
-name = test
-age = 23
-health = good
+name = No Name Set
+age = 0
+health = Unknown
 
 [experiment]
-;choosed scene -calcul -doubleTask -tripleTaskNoInteruption -tripleTaskNASAtlx
-type = doubleTask 
+; choosed scene -calcul - doubleTask - tripleTaskNoInteruption - tripleTaskNASAtlx
+type = calcul
 
-;if true begin the hard way true = 1 false = 0
-reverse=0
+; if true begin the hard way true = 1 false = 0
+reverse = 0
 
-;phase time in seconds
-experienceTime = 20
+; phase time in seconds
+experienceTime = 180
 
-;pause time in seconds
+; pause time in seconds
 pauseTime = 30
 
-;if true propose a survey to evaluate cognitive load true = 1 false = 0
+; if true propose a survey to evaluate cognitive load true = 1 false = 0
 survey = 1
 
-;allow to skip the tutorial may cuse saving issues on cognitive load data true = 1 false = 0
-skipTuto = 1
\ No newline at end of file
+; allow to skip the tutorial may cuse saving issues on cognitive load data true = 1 false = 0
+skipTuto = 0
+
+; set the repetition rate for the audio stimulus
+AudioStimulusAverage = 14
+
+; set the maximus deviation from the average in seconds
+AudioStimulusDelta = 3
+
+; set maximum response time (time saved if there is no response from the user)
+MaximumResponseTime = 10
+

Instructions/instructions.md

@@ -19,15 +19,13 @@ Use the left **Joystick click** to respond the audio. <br>
 
 ## double task
 
-In this experiment you have to get the artificial horizon stable with the joystick and validate.
+In this experiment you have to get the artificial horizon not reaching the red area by pressing the primary button before the line touch it. Each time you press the primary button the line will change direction.
 
 A pause will occur and you could answer a survey if you choosed to (config file)
 
-after the pause the artificial horizon will come back but it will also be some calculations to do 
+After the pause the artificial horizon will come back but it will also be some calculations to do 
 
-during all of this you have to respond as quickly as possible to the sound in order to measure your response time
-
-To get the artificial horizon stable you will use the right **joystick up** and **joystick down**
+During all of this you have to respond as quickly as possible to the sound in order to measure your response time
 
 To validate you will use the **A** button (right primary button)
 
@@ -106,7 +104,7 @@ Answer double digits calculations on calculator type input using ray on controll
 It is used as a witness spot to measure your response time.
 
 ## VerticalArtificialHorizon
-**joystick up** and **joystick down** to place the background on the line and **A** to validate
+Press **A** to change line direction
 
 ## ButtonCalcul
 Press the correct answer using the controller. <br>There is at least one correct answer among the three shown.
@@ -119,7 +117,21 @@ Use the levers to offset the rotation speed of the background.<br>
 The left lever will offset the rotation clockwise.<br>
 The right lever will offset the rotation anticlockwise.<br>
 
+# PPE Charts
+
+An application was developed to facilitate the analysis of the sensors' data getted from an experiment. This applcation can be found in the Build Files with the name "PPE Charts".
+
+After open the application you will come across this window: 
+
+![ChartsHome](./Images/PPEChartsHome.png)
+
+To get start you have to open a compatible csv file (a file generated by the experiments). To do this you have to go to "Files -> Open" and a File Browse Window will appear and you can chose a csv file.
+
+After this the "Charts Menu" will be avaible and you can chose a chart in the list to be plot . The buttons in the bottom menu is used to interact with the chart. 
+
+When you plot a "Cognitive Load Chart" a list of checkboxes will appear. You can check them to visualize the moments of Correct and Wrong answers of each task in the experiment, as in the following image:
 
+![ChartsCheckBoxes](./Images/PPEChartsCheckBoxes.png)
 
 [Return to ReadMe](./../ReadMe.md)
 

Instructions/sensors.md

@@ -36,16 +36,20 @@ From the game we are saving several more informations
 
 ## Additionnal informations
 
-More informations are saved into a text file netx to the csv
+More informations are saved into a text file next to the csv
 
-After each part of the experiment some NASA-TLX questions are asked.
+After each part of the experiment the NASA-TLX questions are asked.
 * **Mental Demmand** : How much mental and perceptual activity was required? Was the task easy or demanding, simple or complex?
+* **Physical Demand** : How much physical activity was required? Was the task easy or demanding, slack or strenuous?
+* **Temporal Demand** : How much time pressure did you feel due to the pace at which the tasks or task elements occurred? Was the pace slow or rapid?
 * **Performance** : How successful were you in performing the task? How satisfied were you with your performance?
 * **Effort** : How hard did you have to work (mentally and physically) to accomplish your level of performance?
 * **Frustration** : How irritated, stressed, and annoyed versus content, relaxed, and complacent did you feel during the task?
   
-There is also the average response time for the more simple task and the more complec one.<br>
-Finally we save the average cognitive load by part (calculated by the headset).
+![Nasa Tlx](./Images/Screen_NasaTlx.png)
+
+There is also the **average response time** for the more simple task and the more complec one.<br>
+Finally we save the **average cognitive load by part** (calculated by the headset).
 
 
 [Return to ReadMe](./../ReadMe.md)

Instructions/setup.md

@@ -2,7 +2,7 @@
 
 ## Windows Mixed Reality
 
-The first step to get started with the Headset Omnicept is to set up it withim the Windows Mixed Reality. All steps to do this are instructed in the [pdf](./Images/Headset_Set-Up.pdf).
+The first step to get started with the Headset Omnicept is to set up it withim the Windows Mixed Reality. All steps to do this are instructed in the [pdf](./Images/Headset_Set-Up.pdf)
 
 ## Runtime 
 
@@ -63,14 +63,28 @@ At the end of the experiment you will get a folder named after the subject conta
 * **reverse** : Set it to **1** if you want to begin by the complex tasks work only with [Double Task](./instructions.md#double-task) and [Triple Task](./instructions.md#triple-task)
 * **experienceTime** : Set the duration of each part of the experiment in seconds (default value = 180, 3 minutes for each part, 6 minutes in total)
 * **pauseTime** : Set the duration of the pause between parts in seconds<br>
-  <span style="color:yellow">**WARNING**</span> only work if **survey** is disable<br>
+  <span style="color:yellow">**WARNING**</span> the **survey** wait to be confirmed even if it exceed pause time <br>
   (default value = 30)
 * **survey** : displays a quiz derived from the NASA-TLX at the end of each part<br>answers are logged in a text file with the average response time and cognitive load by part
 * **skipTuto** : allow you to skip the tutorial and begin with the experient right away.<br><span style="color:yellow">**WARNING**</span> the cognitive load start logging after one minute of play so if you skip the tutorial make sure to not start right away.
+* **AudioStimulusAverage** : set the repetition rate for the audio stimulus in seconds (with 15 about 4 stimuli per minute).
+* **AudioStimulusDelta** : set the maximus deviation from the average in seconds [average-delta , average+delta] (if set to 0 the stimulus will be constant).
+* **MaximumResponseTime** : set maximum response time (time saved if there is no response from the user).
   
 ## Omnicept Sensor Diagnostic
 To verify if the Headset sensors works there are an application for this. You can download the Omnicept Sensor Diagnostic at https://developers.hp.com/omnicept/downloads, scroll the page until the session tools, and you will find the download option. To download the application a HP Account is needed.
 
+## Autorisations
+
+After running the application for the first time a notification will appear requesting sensors permissions, **WARNING** if you do not accept the application will not save any data related to sensors
+
+![](/Instructions/Images/Notification.png)
+
+If you missed it don't worry you can access it by going into the hidden icons and open the omnicept runtime then in autorisation tab choost to trust the application by pressing ✔️.
+
+![](/Instructions/Images/Runtime.png)
+
 [Return to ReadMe](./../ReadMe.md)
 
-[Go to instructions](./instructions.md) 
\ No newline at end of file
+[Go to instructions](./instructions.md) 
+