|
|
|
|
|
# simBCI
|
|
|
|
|
|
**simBCI** is a Brain-Computer Interface / BCI simulator. It is released as open source under the AGPL3 license.
|
|
|
**simBCI** is a Brain-Computer Interface (BCI) simulator for generating and testing EEG-like data. It is released as open source under the AGPL3 license.
|
|
|
|
|
|
# Abstract
|
|
|
|
|
|
simBCI is a framework for generating artificial EEG data and to test BCI classification methods. The combination allows the study of EEG models and BCI signal processing methods together in controllable conditions as each tested configuration features only what was specified. It is intended for offline analysis of BCI models and methods and to provide intuition about the behavior of such techniques. Ultimately, human experiments are necessary to validate the ideas arising from the use of the framework.
|
|
|
simBCI is a framework for generating artificial EEG data and to test BCI classification methods. The combination allows the study of EEG models and BCI signal processing methods together in controllable conditions as each tested configuration features only what was specified. It is intended for offline analysis of EEG models and processing methods and to provide intuition about the behavior of such techniques. Ultimately, human experiments are necessary to validate the ideas arising from the use of the framework.
|
|
|
|
|
|
The potentially useful results produced by simBCI are classification accuracies obtained in different conditions, and elementary visualizations of the data after different transformations. Although in principle it would be possible to extract models generated with simBCI and apply them online, or to run simBCI on real data, these have not been the design goals so far.
|
|
|
The potentially useful results produced by simBCI are classification accuracies (or bitrates) obtained in different conditions, and elementary visualizations of the data after different transformations. Although in principle it would be possible to extract models generated with simBCI and apply them online, or to run simBCI classification pipelines on real data, these have not been the design goals so far.
|
|
|
|
|
|
The target audience of simBCI are advanced students, researchers, teachers and engineers interested in obtaining a deeper understanding of the operation of BCI models and signal processing techniques.
|
|
|
The target audience of simBCI are advanced students, researchers, teachers and engineers interested in obtaining a deeper understanding of the operation of EEG/BCI models and signal processing techniques.
|
|
|
|
|
|
# Acknowledgement
|
|
|
|
|
|
The simBCI framework was developed in the scope of a collaborative research project between Inria and IMT-Atlantique (ex. Telecom Bretagne), France. The development was funded by the CominLabs LABEX project SABRE.
|
|
|
The simBCI framework was developed in the scope of a collaborative research project SABRE between IMT-Atlantique (ex. Telecom Bretagne) and Inria, France. The development was funded by CominLabs LABEX.
|
|
|
|
|
|
# Requirements
|
|
|
|
|
|
simBCI currently requires Matlab.
|
|
|
|
|
|
To use simBCI, it is helpful to have a basic understanding of BCI systems (i.e. to have atleast an introductory textbook level knowledge of BCI). Configuring simBCI benefits from understanding Matlab syntax. Adding or modifying components of the framework requires basic Matlab programming skill.
|
|
|
To use simBCI it is helpful to have a basic understanding of BCI systems and EEG (i.e. to have atleast an introductory textbook level knowledge of BCI). Configuring simBCI benefits from understanding Matlab syntax. Adding or modifying components of the framework requires basic Matlab programming skill.
|
|
|
|
|
|
# Features
|
|
|
|
... | ... | @@ -31,17 +31,19 @@ In a typical simulated BCI session, the framework is used to generate a timeline |
|
|
|
|
|
# How do I cite it?
|
|
|
|
|
|
If you use simBCI in your academic work, please cite the following short conference abstract in your publication,
|
|
|
If you use simBCI in your academic work or were otherwise inspired by it, please cite the following in your publication,
|
|
|
|
|
|
*J.T. Lindgren, A. Merlini, A. Lécuyer and F.P. Andriulli. SimBCI - Tool to simulate EEG and BCI. The 7th International BCI Meeting, Asilomar/CA, 2018.* [(preprint)](/uploads/1f47af99e8dda95dd4d9cbcebbab35fe/simBCI_Abstract__BCI_2018_.pdf)
|
|
|
*J.T. Lindgren, A. Merlini, A. Lécuyer and F.P. Andriulli. simBCI - A framework for studying BCI methods by simulated EEG. IEEE Transactions on Neural Systems and Rehabilitation Engineering, 2018*. DOI: [10.1109/TNSRE.2018.2873061](https://doi.org/10.1109/TNSRE.2018.2873061)
|
|
|
|
|
|
We have also written a full-length journal paper which is currently under review. We will provide a reference to the full paper after it has been accepted for publication.
|
|
|
# History
|
|
|
|
|
|
simBCI evolved during 2015-2018 from the authors' Matlab scripts studying inverse models in the BCI scope. The first git commit was in March 2016 and the first public appearance of the framework was in the BCI Meeting, May 2018, Pacific Grove, US. [(preprint of a short abstract)](/uploads/1f47af99e8dda95dd4d9cbcebbab35fe/simBCI_Abstract__BCI_2018_.pdf)
|
|
|
|
|
|
# Where is the documentation?
|
|
|
|
|
|
The code archive contains brief documentation (*doc/*) about the code entry points, the main concepts and the used conventions. The platform defines object classes that hopefully correspond to intuitively meaningful concepts (e.g. event timeline, head model, generator, pipeline, signal processor). We provide several simulation examples in the archive, as well as brief Matlab scripts showing how to do different entry-level tasks with the framework.
|
|
|
|
|
|
The BCI Meeting 2018 abstract (published) and the forthcoming journal paper (submitted) will describe the framework on a high level.
|
|
|
The BCI Meeting 2018 abstract (published) and the IEEE TNSRE 2018 journal paper (early access) describe the framework and related philosophy/caveats on a high level.
|
|
|
|
|
|
# Limitations
|
|
|
|
... | ... | @@ -63,7 +65,7 @@ Please use the gitlab 'Issues' tracker in the left sidebar to report issues, to |
|
|
|
|
|
You can obtain the latest simBCI archive and example leadfields from [here](http://openvibe.inria.fr/pub/src/simbci/). A git repository is [also available](https://gitlab.inria.fr/sb/simbci/).
|
|
|
|
|
|
Note that simBCI examples require a leadfield model to work. A separate models archive contains some example leadfields that were kindly provided by the CERL lab of IMT-Atlantique.
|
|
|
Note that simBCI examples require a leadfield model to work. The example leadfields archive contains some applicable models that were kindly contributed by the CERL lab of IMT-Atlantique.
|
|
|
|
|
|
# Authors
|
|
|
|
... | ... | @@ -81,7 +83,7 @@ Francesco Andriulli / IMT - Computational electromagnetics (project lead) |
|
|
|
|
|
# Contact
|
|
|
|
|
|
simBCI is open source and provided as-is. We hope the framework benefits the EEG/BCI community. We currently have no dedicated resources to provide support on simBCI but may do so if time permits. For feedback or other academic or industrial queries, please contact
|
|
|
simBCI is open source and provided as-is. We hope the framework benefits the EEG/BCI community. We currently have no dedicated resources to answer support-type questions but we may do so if time permits. For feedback or other academic or industrial queries, please contact
|
|
|
|
|
|
![mail-jussi](/uploads/6207adda4fb9350a215000e645572773/mail-jussi.png)
|
|
|
|
... | ... | |