python-emotiv

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #go #machine-learning #rust #docker #macos #cli #awesome-list #vue #mcp #open-source

(★ 134)

A Python module to access Emotiv EPOC EEG headset on Linux.

File Explorer

Download Latest Version (.zip)

- 10-seconds-12Hz-16HzT-Green-SSVEP-O1-O2_r1.mat
- 10-seconds-12Hz-16HzT-Green-SSVEP-O1-O2_r2.mat
- 10-seconds-12Hz-16HzT-Green-SSVEP-O1-O2_r3.mat
- 10-seconds-12Hz-16HzT-Green-SSVEP-O1-O2_r4.mat
- 10-seconds-12Hz-16HzT-Green-SSVEP-O1-O2_r5.mat
- 10-seconds-12HzT-16Hz-Green-SSVEP-O1-O2_r1.mat
- 10-seconds-12HzT-16Hz-Green-SSVEP-O1-O2_r2.mat
- 10-seconds-12HzT-16Hz-Green-SSVEP-O1-O2_r3.mat
- 10-seconds-12HzT-16Hz-Green-SSVEP-O1-O2_r4.mat
- 10-seconds-12HzT-16Hz-Green-SSVEP-O1-O2_r5.mat
- 10-seconds-15Hz-19HzT-Green-SSVEP-Smooth-O1-O2_r1.mat
- 10-seconds-15Hz-injected-to-O2.mat
- 10-seconds-15Hz-Red-SSVEP-O1-O2_r1.mat
- 10-seconds-15Hz-Red-SSVEP-O1-O2_r2.mat
- 10-seconds-15HzT-19Hz-Green-SSVEP-Smooth-O1-O2_r1.mat
- 10-seconds-15HzT-19Hz-Green-SSVEP-Smooth-O1-O2_r2.mat
- 10-seconds-15HzT-19Hz-Green-SSVEP-Smooth-O1-O2_r3.mat
- 10-secs-O1-O2-1Hz-19HzT.mat
- 30-secs-O1-O2-15HzT-18Hz_r1.mat
- 30-secs-O1-O2-15HzT-19Hz.mat
- plot_burg.py
- lsusb.txt
- sc_console.png
- __init__.py
- analysis.py
- epoc.py
- utils.py
- bbb-bci-acquire.py
- bbb-bci-dspd.py
- bbb-bci-ssvepd.py
- record-data.py
- rpi-bci-ssvep.py
- thesis-bci.py
- yes-no-bci.py
- lsl-pyemotiv.py
- pylsl.py
- batch_eeg.m
- batch_eeg2.m
- burg_classify.m
- burg_plots_dataset.m
- plot_all_channels.m
- time_average_fft_animated.m
- packet_drop.py
- 99-emotiv-epoc.rules
- epoc-replug.py
- pisarenko.py
- ssvep-frequencies-diff.py
- ssvep-frequencies.py
.gitignore
COPYING
README.md
setup.py
TODO.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Emotiv EPOC Python Interface
============================

Unmaintained as of January 2015
-------------

**Please do not e-mail me for questions about this project. I no longer develop it,
nor test or use it on Emotiv devices. I don't work in this field anymore. Thanks!**

python-emotiv is an open-source library to acquire data from Emotiv EPOC headset.
Although Emotiv recently provided 32-bit SDK for Linux, we have chosen
to use the reverse-engineered protocol as the code will be finally deployed
on a Raspberry Pi or BeagleBone Black ARM box.

The library uses libusb to detect and access the dongle instead of hidapi. The
udev rules create a /dev/emotiv\_epoc symlink in /dev tree, if you want to
directly read from that node, pass method="direct" when you create your EPOC
object.

Parts of the project are inspired from
[mushu](https://github.com/venthur/mushu) and
[emokit](https://github.com/openyou/emokit) which is the pioneer of the
reverse-engineered protocol.

Dependencies
============

* [pyusb](http://sourceforge.net/projects/pyusb) (Version >= 1.0)
* [pycrypto](https://www.dlitz.net/software/pycrypto)
* numpy
* scipy
* matplotlib (For data analysis scripts under utils/)
* BeagleBone Black GPIO (For SSVEP BCI in examples/)

[labstreaminglayer](https://code.google.com/p/labstreaminglayer)
================================================================

"labstreaminglayer is a system for the unified collection of measurement time series
in research experiments and handles both the networking, time-synchronization,
(near-) real-time access as well as optionally the centralized collection,
viewing and disk recording of the data."

python-emotiv has preliminary support in lsl/ folder to stream Emotiv EEG signals to
labstreaminglayer nodes.

Saving your data
================

utils.py contains a save_as_matlab() function to export the acquired signals
as a MATLAB file. This function saves the EEG data according to the
[FieldTrip](http://fieldtrip.fcdonders.nl)
specification to ease the process of analysing signals with FieldTrip.

Installation
============

Just run ```python setup.py install``` to install the module on your system.

Testing
=======

When you run emotiv/epoc.py as a standalone application, it will dump sensor data
to the terminal:

![Terminal screenshot](https://raw.github.com/ozancaglayan/python-emotiv/master/doc/sc_console.png)

Authors
=======

Ozan Çağlayan, Galatasaray University, Computer Engineering Dept.

python-emotiv

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

python-emotiv

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README