Skip to content

cbrnr/mnelab

Repository files navigation

Python PyPI Docs DOI License

MNELAB

MNELAB provides a graphical user interface for MNE-Python (the most popular Python package for EEG/MEG analysis) and ensures full transparency by recording the underlying commands for each action in its command history.

Key features include:

  • Cross-platform support (Linux, macOS, Windows).
  • A command history that records the underlying MNE-Python commands for each action, allowing users to learn how to use MNE-Python and to reproduce their analyses in code.
  • Import data from various formats supported by MNE-Python, and some additional formats like XDF (.xdf, .xdfz, .xdf.gz), MATLAB (.mat), NumPy (.npy), and BVRF (.bvrh, .bvrd, .bvrm, .bvri).
  • Export to EDF, BDF, BrainVision, EEGLAB, and FIFF formats.
  • XDF-specific features such as chunk inspection (useful for debugging corrupted XDF files), stream selection, metadata inspection, resampling, gap detection and filling, and more.
  • Support for various ICA algorithms, including FastICA, Infomax ICA, and PICARD.
  • Automatic classification of independent components using ICLabel.
  • Comprehensive tools for managing events and annotations.
  • Support for channel locations (montages), rereferencing, cropping, filtering, epoching, and more.
  • Plotting capabilities for raw data, epochs, evoked responses, independent components, ERD/ERS maps, and more.

Documentation

Instructions for installing and using MNELAB as well as step-by-step examples for different use cases are available in the documentation. Check out the changelog to learn what we added, changed, or fixed.

Quick start

We recommend our standalone installers currently available for macOS and Windows:

If you use Arch Linux, you can install MNELAB from the AUR (e.g., yay -S python-mnelab).

Alternatively, you can use uv to run MNELAB on all platforms:

uvx mnelab

If you want to run the latest development version, you can use the following command:

uvx --from https://github.com/cbrnr/mnelab/archive/refs/heads/main.zip mnelab

Contributing

The contributing guide contains detailed instructions on how to contribute to MNELAB.

About

MNELAB – a GUI for MNE-Python

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 21

Languages