A Matlab Framework for running Custom Neurofeedback Protocols via Lab Streaming Layer (LSL) Streams
- liblsl-Matlab -> Installation guide is available here.
- Matlab 2023b
- Open this folder in Matlab
- Open and start
main.min Matlab
- Select your device
- [Optional] Adjust the
TYPEof the LSL input stream - Click
OPENto connect with the LSL input stream - Configure
SETTINGS,IDandEPOCHS - Click
FILEand thenSAVE; then, you can use this setting in the future. - Click
STARTto run a session
- Select your device type and model from the available options.
- Add a device by creating a
.jsonfile for it in the subfolderdevices- Take a look at the existing
nirs_nirx_nirsport2_26.json - The most important part is defining the LSL channels sent by the device
- Take a look at the existing
| Setting | Description |
|---|---|
TYPE |
LSL type of the input stream to open. This is device-specific. |
CHANNELS |
Number of channels found in LSL stream |
SAMPLE RATE |
Measured Samplerate / Reported Samplerate by Device |
Important
The measured sample rate should (almost) equal the reported sample rate.
Otherwise, this turns from green to red
8000
, and you're likely suffering
from packet loss (e.g. due to bad or overloaded wifi).
| Setting | Description |
|---|---|
PROTOCOL |
The Matlab file from folder protocols with the algorithm executed on each window. |
CHANNELS |
Select LSL channels to use in the selected protocol |
WINDOW SIZE (S) |
Size of the sliding window in seconds. The window always contains the last n seconds of samples. |
SESSION LENGTH (S) |
The session will automatically stop after this time. |
| Setting | Description |
|---|---|
STUDY |
Name of Study |
SUBJECT |
Number of Subject |
RUN |
Number of Run |
The session will be automatically saved in the subfolder sessions with the name STUDY-SUBJECT-RUN.mat
An epoch is a configurable timespan within a session.
| Setting | Description |
|---|---|
START (S) |
Start of Epoch (in seconds) |
END (S) |
End of Epoch (in seconds) |
MARKER |
Marker Value (1-99) of Epoch (also sent on LSL) |
VISIBLE |
Visibility of Bar in Feedback Window during Epoch |
COLOR |
Background Color in Feedback Window during Epoch |
- Add epoch by clicking
+ - Remove last or selected epoch(s) by clicking
- - Chose background color of selected epoch(s) by clicking
COLOR
- Sends triggers on LSL with stream type and name set to
Trigger - Sends trigger with value
100on session start - Sends trigger with value
101on session end - Sends trigger with custom value from column
MARKERon each epoch start
- Sends markers on LSL with stream type and name set to
Marker - Sends markers with the same sample rate as LSL input (one marker for each LSL input sample)
- Default value is
0(if no active epoch)
- A protocol calculates a feedback value from an input window
- To add a protocol,l put the Matlab file in the subfolder
protocols - The
MovAvg_SS.mexample requires a NIRS device that sends at least oneHbOchannel with aμmol/Lunit and one short channel selected. - The
RecordOnly.mworks with any device type and model and just records data - The
BandPass.mexample requires a NIRS device that sends at least oneHbOchannel with aμmol/Lunit without short channel selection. - The
MovAvg.mexample requires a NIRS device that sends at least oneHbOchannel withμmol/Lunit without short channel selection.
DELAYshows the current offset in the playback schedule (where we arevswhere we should be)- It typically occurs if the average runtime of your protocol is larger than
1s/samplerate
Shows a centered bar with feedback values <= 0.5 visualized in blue and values > 0.5 visualized in red.
- Dr. rer. nat. Beatrix Barth
- Dipl.-Inf. Clint Banzhaf
- M.Sc. Costanza Iester
- B.Sc. Ahmed Eldably