Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NeuroTechX/eeg-101
Interactive neuroscience tutorial app using Muse and React Native to teach EEG and BCI basics.
https://github.com/NeuroTechX/eeg-101
android bci eeg muse plotting react-native
Last synced: about 2 months ago
JSON representation
Interactive neuroscience tutorial app using Muse and React Native to teach EEG and BCI basics.
- Host: GitHub
- URL: https://github.com/NeuroTechX/eeg-101
- Owner: NeuroTechX
- License: isc
- Archived: true
- Created: 2016-02-24T13:31:50.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-13T16:48:41.000Z (over 3 years ago)
- Last Synced: 2024-06-26T01:33:44.897Z (3 months ago)
- Topics: android, bci, eeg, muse, plotting, react-native
- Language: JavaScript
- Homepage:
- Size: 63 MB
- Stars: 243
- Watchers: 35
- Forks: 55
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
An Interactive EEG tutorial that _taught_ EEG and BCI basics.
## EEG 101 is dead, may it rest in peace.
Due to Interaxon rescinding support for its Muse SDK, it is no longer possible for open-source developers to build mobile apps that connect to Muse devices, including this one. Thus, we have stopped development here and removed the app from the Google Play Store.
If you are interested in learning or teaching EEG, we recommend you check out the [EEGEdu](https://github.com/kylemath/EEGEdu) project, which we see as the spiritual successor to EEG 101, expanding on the EEG 101 experience by adding features that we could only have dreamed of when we started this project back in 2016.
Good luck and happy neurohacking,
Dano
## Overview
- Teaches the basics of EEG, including where signals come from, how devices work, and how to process data
- Contains a general purpose binary classifier for EEG data
- Streams data from the Muse with the LibMuse Java API
- Built with React Native for Android
- Completely free, open-source, and available for use/adaption in any project
## Video Walkthrough
https://www.youtube.com/watch?v=fDQZ5zWVjY0&feature=youtu.be
## Lesson Content
- Neurophysiology of EEG
- EEG hardware
- Filtering
- Epoching
- Artefact Removal
- The Fourier Transform
- The Power Spectral Density Curve
- Brain waves
- Brain-Computer Interfaces
- Machine Learning
## How it works
Our goal with EEG 101 was to create a flexible base for EEG and BCI mobile development that novice programmers can build on top of for multiple platforms with different EEG devices. To satisfy those concerns, we've built the app in React Native, which allows for fast, straight-forward front-end development and the potential to port to iOS, Web, or Desktop (Electron) in the future.
Currently, EEG 101 is split right down the middle between Java and React. If you're interested in how we [connect to the Muse](https://github.com/NeuroTechX/eeg-101/blob/master/EEG101/android/app/src/main/java/com/eeg_project/components/connector/ConnectorModule.java), [process EEG data](https://github.com/NeuroTechX/eeg-101/tree/master/EEG101/android/app/src/main/java/com/eeg_project/components/signal), and [plot the results](https://github.com/NeuroTechX/eeg-101/blob/master/EEG101/android/app/src/main/java/com/eeg_project/components/graphs/EEGGraph.java) in real time, check out the graph and signal classes in the android source folders. Our implementations are all (for the most part) typical Android components written in Java.
If you'd like to use EEG 101 as a base for your own app in React Native, take a look at how we've written the tutorial in the src folder. Connecting to a Muse and plotting real-time EEG data is as simple as using one of the Native components we have already prepared.
## Setup (instructions may be out of date)
1. Install and setup [React Native](https://facebook.github.io/react-native/docs/getting-started.html). Note: EEG 101 uses lots of native code, so create-react-native-app and Expo are not an option. Follow the instructions for "Building Apps with Native Code." You may also need to install the [JDK](https://www3.ntu.edu.sg/home/ehchua/programming/howto/JDK_Howto.html), [Node](https://nodejs.org/en/download/package-manager/), [Watchman](https://medium.com/@vonchristian/how-to-setup-watchman-on-ubuntu-16-04-53196cc0227c), and the [Gradle Daemon](https://docs.gradle.org/2.9/userguide/gradle_daemon.html) as well
2. Install [yarn](https://github.com/yarnpkg/yarn)
3. Clone this repo `git clone https://github.com/NeuroTechX/eeg-101.git`
4. Download the LibMuse SDK from [Muse's developer website](http://developer.choosemuse.com/android). We've already taken care of integrating the sdk library into the app, so just make sure you end place libmuse_android.so in `/EEG101/android/app/src/main/jniLibs/armeabi-v7a/` and libmuse_android.jar in `