/meegsim

Building blocks (waveforms, SNR, connectivity) for M/EEG simulations with MNE-Python

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

MEEGsim

Overview

MEEGsim is a Python package that provides template waveforms for simulating M/EEG data with known ground truth source activity. In addition, it simplifies the manipulation of relevant simulation parameters (e.g., signal-to-noise ratio and source connectivity). As a result, the users can focus on what to simulate, not on how to implement the simulation. The package is compatible with MNE-Python and re-uses the forward and inverse modeling functionality provided by MNE.

Find more details about the package in the documentation. For a brief overview of the functionality, check the poster about MEEGsim that was presented at the CuttingEEGX conference (28-31.10.2024, Nijmegen, The Netherlands, and online).

Development

Creating a Local Copy of the Project

  1. Clone the repository.

  2. Create an environment (conda/mamba/virtualenv).

  3. Switch to the project folder and install the package and all dependencies:

cd meegsim
pip install -e .[dev]
  1. You're ready to start now!

Running Tests

pytest

Building the Documentation

  1. Install the required packages.
pip install -e .[docs]
  1. Build the documentation.
make html
  1. Open it in the web browser.
make show