Skip to content

Interactive Brain Playground - Browser based tutorials on EEG with webbluetooth and muse

License

Notifications You must be signed in to change notification settings

kylemath/EEGEdu

Repository files navigation

EEGEdu

MIT license PRs welcome! issues

Interactive Brain Playground Logo

EEGEdu is an Interactive Brain Playground.

EEGEdu is served live at https://eegedu.com/. This website is served from the software in this repository. So, all you need to do to try the system out is head to EEGEdu.

EEGEdu is designed as an interactive educational website to learn/teach about working with electroencephalogram (EEG) data. It is a teaching tool that allows for students to interact with their own brain waves.

EEGEdu has been inspired by multiple works that came before. It is inspired by EEG101, but EEGEdu is web-based. Being web-based allows students to interact with EEG brain data without having to install any software. Others have used Neurotech EEG-notebooks in python for data collection and analysis with muse-lsl. These software support the Interaxon MUSE headset but require a bluetooth low-energey (BLE) dongle to work with common operating systems (e.g. Windows or Mac OSX). These tools also required the editing pyglatt code to connect to Muse headsets. Thus, previous software are cumbersome and serve as a barrier to entry for many students learning about EEG. EEGEdu aims to provide students with an accesible introduction to working with their own brain waves.

EEGEdu Curriculum

EEGEdu provides an step-by-step incremental tutorial for students to interact with EEG-based brain signals. So, we break down the curriculum into 10 lessons as follows:

  1. Connect + hardware, Biophysics + signal viewing
  2. Heart rate time domain data
  3. Heart rate frequency domain -beats per minute
  4. Raw Data + artifacts + blinks + record
  5. Frequency domain explanation + Raw spectra + record
  6. Frequency bands + record
  7. Spectrogram
  8. Neurofeedback p5js demos
  9. Eyes closed eyes open experiment
  10. SSVEP experiment
  11. BCI trainer

Installation for Development

If you are interested in developing EEGEdu, here are some instructions to get the software running on your system. Note: Currently EEGEdu development requires a Mac OSX operating system.

To start, you will need to install Homebrew and yarn. These are easy to install with the following Terminal / bash commands:

## Install homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

## Install yarn
# NOTE: this will also install Node.js if it is not already installed.
brew install yarn 

# NOTE: Node.js must be version 10.x for Muse interaction

# Thus, if you are getting version issues, install n, with the following command:
# sudo npm install -g n