NeuroPy

NeuroPy library written in python to connect, interact and get data from NeuroSky's MindWave EEG headset.

This library is based on the mindwave mindset communication protocol published by Neurosky and is tested with Neurosky Mindwave EEG headset.

This fork is working on python3 and works with mindwave mobile2 model

Installation

1. Download the source distribution (zip file) from dist directory or from PyPi
2. Unzip and navigate to the folder containing setup.py and other files
3. Run the following command: python setup.py install

Usage

1. Importing the module: from NeuroPy import NeuroPy
2. Initializing: neuropy = NeuroPy()
3. After initializing, if required the callbacks can be set
4. Then call neuropy.start() method, it will start fetching data from mindwave.
5. To stop call neuropy.stop()

Obtaining Data from Device

• Obtaining value: attention = neuropy.attention #to get value of attention_

  Other Variable attention, meditation, rawValue, delta, theta, lowAlpha, highAlpha, lowBeta, highBeta, lowGamma, midGamma, poorSignal and blinkStrength

• Setting callback: A call back can be associated with all the above variables so that a function is called when the variable is updated. Syntax:

  setCallBack("[variable]",callback_function)
  

  for eg. to set a callback for attention data the syntax will be

  setCallBack("attention",callback_function)
  

  Other Variables: attention, meditation, rawValue, delta, theta, lowAlpha, highAlpha, lowBeta, highBeta, lowGamma, midGamma, poorSignal and blinkStrength

Sample Program 1 (Access via callback)

from NeuroPy import NeuroPy
from time import sleep

neuropy = NeuroPy() 

def attention_callback(attention_value):
    """this function will be called everytime NeuroPy has a new value for attention"""
    print ("Value of attention is: ", attention_value)
    return None

neuropy.setCallBack("attention", attention_callback)
neuropy.start()

try:
    while True:
        sleep(0.2)
finally:
    neuropy.stop()

Sample Program 2 (Access via object)

from NeuroPy import NeuroPy
from time import sleep

neuropy = NeuroPy() 
neuropy.start()

while True:
    if neuropy.meditation > 70: # Access data through object
        neuropy.stop() 
    sleep(0.2) # Don't eat the CPU cycles

Python Compatibility

• Python - v2.7.* and v3.*

More Information

lihashgnis.blogspot.in - A blog post