Jump to content

User Tutorial:Performing a P300 Spelling Session: Difference between revisions

From BCI2000 Wiki
No edit summary
Ckong (talk | contribs)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
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.
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.


==Preparation==
==Instructions to the Operator==
When performing a P300 Spelling Session, start BCI2000 by running <tt>batch/P3Speller_<Your_Amplifier>.bat</tt>, then load the user-specific parameter file created previously.
{|
|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.


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.
<br/>''Note:'' When your latency value does not refer to an exact sample position, a warning message will be displayed once you click '''SetConfig'''. You may safely ignore that warning message for now.
|-
|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==

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,
  • Click Load Parameters, load parms/fragments/amplifiers/<YourAmplifier>.prm.
  • Load one of the user-specific parameter files created previously from P300 Classifier.
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 parms/examples/P300_copy_speller.prm. Then, load parms/fragments/amplifiers/<YourAmplifier>.prm.
  • 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 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.
  • In the Application tab:
    • Click Edit from TargetDefinitions
    • Add backspace into the spelling matrix.
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.
  • In the Filtering tab:
    • Change the EpochsToAverage from 15 to 5.
  • In the Application tab:
    • Change the NumberOfSequences from 15 to 5.
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.

See also

User Tutorial:P300 BCI Tutorial