WhiteICE v1.01 beta (3th December 2024)
=======================================

WhiteICE command-line software can be used to manipulate brainwaves using
audiovisual stimulus and machine learning (reinforcement learning).

The AppImage uses only CPU. You MUST have *FAST* CPU to use the software because
real-time processing of EEG signals at 100 Hz sampling frequency requires fast CPU +
background optimization of machine learning models. I have developed software using
AMD Ryzen 7 7745 HX (16 threads at 7186 BogoMIPS on Linux). In Windows, you need to
use PowerShell if there are spaces in parameters given using command-line.

To test random stimulation, use command:

whiteice.exe --random --device=random

There are initially random stimulus (aprox 10min learning time after which deep
reinforcement learning calculates online first prediction model in 10 minutes).
Better models are created live slowly in the background when the program is used:

whiteice.exe --measure --device=mindmonitor
whiteice.exe --measure --device=lsl --lsl-names='BA HALO 002_HALO_BrainAccess','EEG'

Software can either read Mind Monitor App EEG readings using OSC (UDP) protocol
to port 4545 to IP of your computer (Interaxon Muse) or read LSL protocol (BrainAccess HALO's
BrainAccessBoard) EEG readings.

You can also set other targets for optimization than phase locking value (PLV)
using --target command. (19 comma separated values between 0 and 1,
use -1 for values that are not used).

In the commands below you must change -1 values to values between 0 and 1 (typically 0 or 1). The used
target below sets target to be PLV of ICA signals (higher quality PLV values).

whiteice.exe --measure --device=mindmonitor --target=-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,1
whiteice.exe --measure --device=lsl --lsl-names=<stream-name>,<stream-type> --target=-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,1

As the default LSL protocol uses 4 first channels but it can be increased if LSL stream (EEG) has more channels.

You can save measurements/models to a directory. To store measurements use "--model-dir=". This also enables using
the previous measurements instead of starting from scratch. (currently model loading doesn't seem to work very well (a bug)).

Use "--help" for command-line parameters. Pressing ESC or ENTER stops the program.


IMPORTANT: You need to run the software in the background (audio)
for 1-3 hours before some useful (small) results (max effect is typically 1%).

Linux: You also need a recent/new GLIBC and fuse installed to your system.


Tomas Ukkonen, M.Sc. <nop@iki.fi>