User Tutorial:Performing a P300 Spelling Session: Difference between revisions
| (24 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
This step assumes that you | This step assumes that you created a subject-specific configuration file for the on-line speller, as described in the [[User Tutorial:Obtaining P300 Parameters in a Calibration Session|previous step]] of this tutorial. | ||
== | ==Instructions to the Operator== | ||
{| | |||
|colspan="2" align="left"|When performing a P300 Spelling Session, start BCI2000 by running <tt>batch/P3Speller_<Your_Amplifier>.bat</tt>, | |||
*Click '''Load Parameters''', load <tt>parms/fragments/amplifiers/<YourAmplifier>.prm</tt>. | |||
*Load one of the user-specific parameter files created previously from P300 Classifier. | |||
|- | |||
|colspan="2" align="center"|[[Image:ClassiferParm.PNG|center|500px]] | |||
|- | |||
|colspan="2" align="center" height=50px| | |||
|- | |||
|colspan="2" align="left"| To perform a copy spelling session -- one in which the subject has to spell a predefined text displayed on the screen --, | |||
*Click '''Load Parameters''', and load <tt>parms/examples/P300_copy_speller.prm</tt>. Then, load <tt>parms/fragments/amplifiers/<YourAmplifier>.prm</tt>. | |||
*In the '''Application''' tab: | |||
**Check the ''DisplayResults'' box to compare the spelling results to example letters. | |||
Click '''Set Config''' to view the EEG signal, and [[User_Tutorial:EEG_Measurement_Setup|prepare the subject for EEG recording]] according to the instructions below. | |||
When the subject are ready, click '''Start''' to verify the accuracy of classifier. | |||
|- | |||
Click ''Set Config'' to view the EEG signal, and [[User_Tutorial:EEG_Measurement_Setup|prepare the subject for EEG recording]] | |colspan="2" align="center" height=50px| | ||
|- | |||
|align="center"|[[Image:DisplayResult.PNG|center|600px]] | |||
|[[Image:VerifyClassifier.PNG|center|400px]] | |||
|- | |||
|colspan="2" align="center"|''In our example, the classifier was generated successfully. With 15 flashes horizontally and vertically, the spelling result was accurate.'' | |||
|- | |||
|colspan="2" align="center" height=50px| | |||
|- | |||
|As the subject gets confident with the "Copy Speller" mode, click '''Config''' and'''Load Parameters''' to load <tt>parms/examples/P300_free_speller.prm</tt>. | |||
*In the '''Application''' tab: | |||
**Click '''Edit''' from ''TargetDefinitions'' | |||
**Add backspace into the spelling matrix. | |||
|- | |||
|colspan="2" align="center"|[[Image:Backspace.PNG|center|600px]] | |||
|- | |||
|colspan="2" align="center" height=50px| | |||
|- | |||
|Now we will decrease the numbers of flashes to speed up spelling | |||
Find the minimum numbers of flashes to yield correct predictions from the '''Details''' tab of P300 Classifier GUI. | |||
|- | |||
|colspan="2" align="center"|[[Image:NumFlash.PNG|center|500px]] | |||
|- | |||
|colspan="2" align="center" height=50px| | |||
|- | |||
|In our example, we choose <tt>5</tt> flashes. | |||
*In the '''Filtering''' tab: | |||
**Change the ''EpochsToAverage'' from <tt>15</tt> to <tt>5</tt>. | |||
*In the '''Application''' tab: | |||
**Change the ''NumberOfSequences'' from <tt>15</tt> to <tt>5</tt>. | |||
|- | |||
|Click '''Set Config''' to view the EEG signal, and [[User_Tutorial:EEG_Measurement_Setup|prepare the subject for EEG recording]] according to the instructions below. | |||
|- | |||
|When the subject are ready, click '''Start''' to perform "free spelling". | |||
|- | |||
|colspan="2" align="center"|[[Image:FreeSpelling.PNG|center|500px]] | |||
|} | |||
==Instructions to the Subject== | ==Instructions to the Subject== | ||
On the subject's screen, a speller matrix is | On the subject's screen, a speller matrix the subject is already familiar with from the initial session is presented. | ||
Differently from that session, there is no text suggested; rather, the subject may choose freely which letters, words, and sentences to write. | Differently from that session, there is no text suggested; rather, the subject may choose freely which letters, words, and sentences to write. | ||
*You will see a speller matrix, containing letters, numbers, and punctuation marks. | *You will see a speller matrix, containing letters, numbers, and punctuation marks. | ||
*To | *To choose a certain letter, concentrate on it by counting the number of flashes that occur for it. | ||
*After some time, a result will be classified and appended to the text field located at the top of the window. | *After some time, a result will be classified and appended to the text field located at the top of the window. | ||
*If the letter that appeared is not what you intended, concentrate on the "backspace" or "undo" field to remove it. | *If the letter that appeared is not what you intended, concentrate on the "backspace" or "undo" field to remove it. | ||
| Line 27: | Line 75: | ||
swallow only during the pause between letters), he/she should be further | swallow only during the pause between letters), he/she should be further | ||
assisted in these efforts by providing a comfortable chair and a dimly lit room. | assisted in these efforts by providing a comfortable chair and a dimly lit room. | ||
The | |||
experimenter must carefully monitor the EEG and alert the subject in the case | experimenter must carefully monitor the EEG and alert the subject in the case | ||
he/she has forgotten some of the instructions. | he/she has forgotten some of the instructions. | ||
| Line 33: | Line 81: | ||
understood, the recording session may start. | understood, the recording session may start. | ||
Click the | *Click the "Start" button to start the spelling experiment. | ||
==Multiple Sessions== | ==Multiple Sessions== | ||
Once a run has ended, BCI2000 goes into suspended state. | Once a run has ended, BCI2000 goes into suspended state. | ||
Further runs will be added to the session when you click ''Resume''. | Further runs will be added to the session when you click '''Resume'''. | ||
When starting the next session, don't forget to increment the ''SessionNumber'' parameter on the ''Storage'' tab. Otherwise, new runs will be added to the previous session's directory. Still, as a safety net, BCI2000 will never overwrite existing data files but increment the largest run number that exists in a session directory. Moreover, it documents date and time in the ''StorageTime'' parameter. This allows to later associate data files with multiple sessions by their time and date, even if the ''SessionNumber'' parameter has not been increased. | When starting the next session, don't forget to increment the ''SessionNumber'' parameter on the ''Storage'' tab. Otherwise, new runs will be added to the previous session's directory. Still, as a safety net, BCI2000 will never overwrite existing data files but increment the largest run number that exists in a session directory. Moreover, it documents date and time in the ''StorageTime'' parameter. This allows to later associate data files with multiple sessions by their time and date, even if the ''SessionNumber'' parameter has not been increased. | ||
Latest revision as of 14:53, 29 July 2019
This step assumes that you created a subject-specific configuration file for the on-line speller, as described in the previous step of this tutorial.
Instructions to the Operator
When performing a P300 Spelling Session, start BCI2000 by running batch/P3Speller_<Your_Amplifier>.bat,
| |
To perform a copy spelling session -- one in which the subject has to spell a predefined text displayed on the screen --,
Click Set Config to view the EEG signal, and prepare the subject for EEG recording according to the instructions below. When the subject are ready, click Start to verify the accuracy of classifier. | |
| In our example, the classifier was generated successfully. With 15 flashes horizontally and vertically, the spelling result was accurate. | |
As the subject gets confident with the "Copy Speller" mode, click Config andLoad Parameters to load parms/examples/P300_free_speller.prm.
| |
| Now we will decrease the numbers of flashes to speed up spelling
Find the minimum numbers of flashes to yield correct predictions from the Details tab of P300 Classifier GUI. | |
In our example, we choose 5 flashes.
| |
| Click Set Config to view the EEG signal, and prepare the subject for EEG recording according to the instructions below. | |
| When the subject are ready, click Start to perform "free spelling". | |
Instructions to the Subject
On the subject's screen, a speller matrix the subject is already familiar with from the initial session is presented. Differently from that session, there is no text suggested; rather, the subject may choose freely which letters, words, and sentences to write.
- You will see a speller matrix, containing letters, numbers, and punctuation marks.
- To choose a certain letter, concentrate on it by counting the number of flashes that occur for it.
- After some time, a result will be classified and appended to the text field located at the top of the window.
- If the letter that appeared is not what you intended, concentrate on the "backspace" or "undo" field to remove it.
Additional instructions should be given regarding minimization of artifacts from
- Contraction of the muscles of the face/head, swallowing;
- Eye blinks and eye movements;
- Motion.
Provided that subjects are asked to minimize artifacts (e.g. asked to try to swallow only during the pause between letters), he/she should be further assisted in these efforts by providing a comfortable chair and a dimly lit room. The experimenter must carefully monitor the EEG and alert the subject in the case he/she has forgotten some of the instructions. When the experimenter is sure that his/her instructions have been well understood, the recording session may start.
- Click the "Start" button to start the spelling experiment.
Multiple Sessions
Once a run has ended, BCI2000 goes into suspended state. Further runs will be added to the session when you click Resume.
When starting the next session, don't forget to increment the SessionNumber parameter on the Storage tab. Otherwise, new runs will be added to the previous session's directory. Still, as a safety net, BCI2000 will never overwrite existing data files but increment the largest run number that exists in a session directory. Moreover, it documents date and time in the StorageTime parameter. This allows to later associate data files with multiple sessions by their time and date, even if the SessionNumber parameter has not been increased.
Finished
Here, the P300 speller tutorial is finished.
Congratulations! You are now able to perform P300 spelling experiments.