Preparing your data
Once the environment is installed, make sure that you've prepared your EEG data in a format expected by the toolbox for PRP analysis. Specifically, it is assumed that:
-
You've done all the preprocessing (e.g., filtering, ICA, resampling, etc).
-
You've extracted all EEG responses time-locked to all instances of each phoneme and saved the results to a .mat file.
For example, if your clean EEG have 32 channels with 128-Hz sampling rate and you extract PRPs with a duration of 0.5 s for 10,000 phoneme instances, then the .mat file should contain a 3D EEG array with shape of 10000 x 32 x 64. In the file, there should also be cell object with shape like 10000 x 1 containing the phoneme label for each corresponding EEG response. By default, it is assumed that the field names of the EEG array and labels are "eegs" and "phones", respetively.
It is recommended that you name the .mat file following the BIDS convention. For example, data from subject 01 completing the Alice task in noise condition may be saved as "sub-01_task-alice_cond-noise.mat". Put all .mat files like this in the same folder.
Finally, you need to have a .csv file providing the electrode names and x, y, z coordinates of the electrodes for the montage you used to collect EEG. The electrode name is in the "ch_name" column and the next three columns are the coordinates:
| ch_name | x | y | z |
|---|---|---|---|
| Fp1 | -27.03339386 | 83.20023346 | -3.054935217 |
| AF3 | -35.56089783 | 76.26059723 | 24.12797737 |
| F7 | -70.7743454 | 51.42057037 | -3.054935217 |
| F3 | -47.70734787 | 58.91366959 | 43.76761246 |
| FC1 | -32.80028152 | 32.80028152 | 74.23407745 |
| FC5 | -77.72145081 | 29.83447075 | 27.04987144 |
| ... |
Because this PRP data extraction step is highly specific to the dataset and how the continuous speech sound tracks are presented, a standard pipeline for the data extraction has not been implemented yet in the toolbox. Please contact Zhe-chen Guo (zcguo@northwestern.edu) for an example script.