Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/NeuroTechX/eeg-expy

EEG Experiments in Python
https://github.com/NeuroTechX/eeg-expy

Last synced: about 2 months ago
JSON representation

EEG Experiments in Python

Awesome Lists containing this project

README 

        
=============

EEG-ExPy

=============



*Democratizing the cognitive neuroscience experiment*



|badge_test| |badge_binder|



.. |badge_test| image:: https://github.com/NeuroTechX/eeg-expy/workflows/Test/badge.svg

   :target: https://github.com/NeuroTechX/eeg-expy/actions



.. |badge_binder| image:: https://mybinder.org/badge_logo.svg

   :target: https://mybinder.org/v2/gh/NeuroTechX/eeg-expy/master



.. image:: ./doc/img/EEG-ExPy_Logo.png

   :align: center



EEG-ExPy is a collection of classic EEG experiments, implemented in Python. The experimental protocols and analyses are quite generic, but are primarily taylored for low-budget / consumer EEG hardware such as the InteraXon MUSE and OpenBCI Cyton. The goal is to make cognitive neuroscience and neurotechnology more accessible, affordable, and scalable. 



- **For an intro talk on the ***EEG-ExPy*** (formerly ***eeg-notebooks***) project see:** `JG's Brainhack Ontario presentation `_.  

- **For documentation see:** `documentation site `_.

- **For code see:** `github site `_.

- **For instructions on running experiments see:** `running experiments `_.

- **For instructions on initiating an EEG stream see:** `initiating an EEG stream `_.

- **A series of tutorial videos will be coming soon!**  



----



**Note:** eeg-expy was previously known as eeg-notebooks. Before the renaming, eeg-notebooks also underwent major changes to the API in v0.2. The old v0.2 version, before the name change, is still available if you need it, in `this repo `_. The even older v0.1 is also still available if needed `here `_.



----



Overview

--------



Conventional lab-based EEG research typically uses research-grade (often high-density) EEG devices, dedicated stimulus delivery software and hardware, and dedicated technicians responsible for operating this equipment. The price tag for these items can easily extend into hundreds of thousands of dollars, which naturally places major limits on their acquisition and usage. 



In recent years, however, developments in hardware and software technologies are making it possible for many classic EEG cognitive neuroscience experiments to be conducted using a standard laptop/personal computer and a relatively cheap consumer-grade EEG device, with a combined minimum cost of less than 1000 dollars. This opens dramatic new possibilities for neurotechnology and cognitive neuroscience *education* (at both University and High School levels), as well as more ambitious and larger-scale *research* and *clinical* applications using large numbers of devices, and/or in more naturalistic (i.e. out-of-the-lab) settings. We like to think of this as contributing to the *democratization of the cognitive neuroscience experiment*.



The core aim of the EEG-Notebooks project is to provide the critical 'glue' that pulls together the various enabling technologies necessary for running these experiments and analyzing the data. This includes functionality for 



* streaming data from various relatively new wireless consumer-grade EEG devices  

* visual and auditory stimulus presentation, concurrent with and time-locked to the EEG recordings  

* a growing library of well-documented, ready-to-use, and ready-to-modify experiments 

* signal processing, statistical, and machine learning data analysis functionalities



A real one-stop-shop!



For more discussion on these social/scientific/technological contexts and trajectories, a) feel free to get in touch directly (see #Contact info below) and b) keep an eye out for the forthcoming eeg-expy research paper.



Documentation

-------------



The current version of eeg-expy is the 0.2.X series. The code-base and API are under major development and subject to change.



Check the `changelog `_ for notes on changes from previous versions.



**Installation instructions**, steps for **getting started**, common **troubleshooting** solutions and more can be found in the documentation for eeg-expy, available on the

`documentation site `_.



Acknowledgments

----------------



EEG-Notebooks was created by the `NeurotechX `_ hacker/developer/neuroscience community. The ininitial idea and majority of the groundwork was due to Alexandre Barachant - including the `muse-lsl `_ library, which is core dependency. Lead developer on the project is now `John Griffiths `_ . 



Key contributors include: Alexandre Barachant, Hubert Banville, Dano Morrison, Ben Shapiro, John Griffiths, Amanda Easson, Kyle Mathewson, Jadin Tredup, Erik Bjäreholt. 



Thanks also to Andrey Parfenov for the excellent `brainflow `_ library, which has allowed us to dramatically expand the range of supporte devices; as well as the developers of `PsychoPy `_ and `MNE `_, which together make up the central scaffolding of eeg-expy. 



Contribute

----------



This project welcomes and encourages contributions from the community!



If you have an idea of something to add to eeg-expy, please start by opening an

`issue `_.



Contact

-------------



The best place for general discussion on eeg-expy functionality is the `issues page `_. For more general questions and discussions, you can e-mail `[email protected]`, or ping us on the `NeuroTechX Discord `_ or `NeuroTechX slack `_.



.. image:: ./doc/img/eeg-notebooks_democratizing_the_cogneuro_experiment.png

   :align: center

   :scale: 50