eegkit / metabci

MetaBCI: an open-source platform for non-invasive brain computer interface

MetaBCI

Welcome!

MetaBCI is an open-source platform for non-invasive brain computer interface. The project of MetaBCI is led by Prof. Minpeng Xu from Tianjin University, China. MetaBCI has 3 main parts:

• brainda: for importing dataset, pre-processing EEG data and implementing EEG decoding algorithms.
• brainflow: a high speed EEG online data processing framework.
• brainstim: a simple and efficient BCI experiment paradigms design module.

This is the first release of MetaBCI, our team will continue to maintain the repository. If you need the handbook of this repository, please contact us by sending email to [email protected] with the following information:

• Name of your teamleader
• Name of your university(or organization)

We will send you a copy of the handbook as soon as we receive your information.

• MetaBCI
  • Welcome!
  • What are we doing?
    • The problem
    • The solution
  • Features
  • Installation
  • Who are we?
  • What do we need?
  • Contributing
  • License
  • Contact
  • Acknowledgements

What are we doing?

The problem

• BCI datasets come in different formats and standards
• It's tedious to figure out the details of the data
• Lack of python implementations of modern decoding algorithms
• It's not an easy thing to perform BCI experiments especially for the online ones.

If someone new to the BCI wants to do some interesting research, most of their time would be spent on preprocessing the data, reproducing the algorithm in the paper, and also find it difficult to bring the algorithms into BCI experiments.

The solution

The Meta-BCI will:

• Allow users to load the data easily without knowing the details
• Provide flexible hook functions to control the preprocessing flow
• Provide the latest decoding algorithms
• Provide the experiment UI for different paradigms (e.g. MI, P300 and SSVEP)
• Provide the online data acquiring pipeline.
• Allow users to bring their pre-trained models to the online decoding pipeline.

The goal of the Meta-BCI is to make researchers focus on improving their own BCI algorithms and performing their experiments without wasting too much time on preliminary preparations.

Features

• Improvements to MOABB APIs

  • add hook functions to control the preprocessing flow more easily
  • use joblib to accelerate the data loading
  • add proxy options for network connection issues
  • add more information in the meta of data
  • other small changes

• Supported Datasets

  • MI Datasets
    • AlexMI
    • BNCI2014001, BNCI2014004
    • PhysionetMI, PhysionetME
    • Cho2017
    • MunichMI
    • Schirrmeister2017
    • Weibo2014
    • Zhou2016
  • SSVEP Datasets
    • Nakanishi2015
    • Wang2016
    • BETA

• Implemented BCI algorithms

  • Decomposition Methods
    • SPoC, CSP, MultiCSP and FBCSP
    • CCA, itCCA, MsCCA, ExtendCCA, ttCCA, MsetCCA, MsetCCA-R, TRCA, TRCA-R, SSCOR and TDCA
    • DSP
  • Manifold Learning
    • Basic Riemannian Geometry operations
    • Alignment methods
    • Riemann Procustes Analysis
  • Deep Learning
    • ShallowConvNet
    • EEGNet
    • ConvCA
    • GuneyNet
  • Transfer Learning
    • MEKT
    • LST

Installation

1. Clone the repo

   git clone https://github.com/TBC-TJU/MetaBCI.git

2. Change to the project directory

   cd MetaBCI

3. Install all requirements

   pip install -r requirements.txt 

4. Install brainda package with the editable mode

   pip install -e .

Who are we?

The MetaBCI project is carried out by researchers from

• Academy of Medical Engineering and Translational Medicine, Tianjin University, China
• Tianjin Brain Center, China

What do we need?

You! In whatever way you can help.

We need expertise in programming, user experience, software sustainability, documentation and technical writing and project management.

We'd love your feedback along the way.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. Especially welcome to submit BCI algorithms.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the GNU General Public License v2.0 License. See LICENSE for more information.

Contact

Email: [email protected]

Paper

If you applied MetaBCI in your research, please cite: Mei, J., Luo, R., Xu, L., Zhao, W., Wen, S., Wang, K., ... & Ming, D. (2023). MetaBCI: An open-source platform for brain-computer interfaces. Computers in Biology and Medicine, 107806.

And this open access paper can be found here: MetaBCI

Acknowledgements

• MNE
• MOABB
• pyRiemann
• TRCA/eTRCA
• EEGNet
• RPA
• MEKT