MNELAB
MNELAB is a graphical user interface for MNE-Python (the most popular Python package for EEG/MEG analysis).
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, MATLAB, NumPy, and BVRF.
- 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), re-referencing, cropping, filtering, epoching, and more.
- Plotting functions for raw data, epochs, evoked responses, independent components, ERD/ERS maps, and more.
Documentation
The documentation contains hands-on examples and tutorials for different use cases. Check out the changelog to learn what we added, changed, or fixed.
Quick Start
We recommend using the standalone installers 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 directly without installing it (this works on all platforms, but for the best experience we recommend using the standalone installers when available):
uvx mnelab
Advanced Usage
To run the latest development version:
uvx --from https://github.com/cbrnr/mnelab/archive/refs/heads/main.zip mnelab
On Linux, running MNELAB via uvx mnelab uses the Fusion style shipped with PySide6, which may not fit well with the rest of the system. However, if you use KDE, you can set the QT_PLUGIN_PATH environment variable to force the use of the native KDE theme instead, for example:
QT_PLUGIN_PATH=/usr/lib/qt6/plugins uvx mnelab
Contributing
The contributing guide provides detailed instructions for contributing to MNELAB.
Citing
If you use MNELAB in your research, please cite the following paper (see also CITATION.cff):
Brunner, C. (2022). MNELAB: a graphical user interface for MNE-Python. Journal of Open Source Software, 7(78), 4650, doi:10.21105/joss.04650.
Metadata
Release files for mnelab 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mnelab-1.6.0.tar.gz | 420.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mnelab-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 898.7 kB
Release files / mnelab-1.6.0.tar.gz
| Download URL | mnelab-1.6.0.tar.gz |
|---|---|
| Size | 420.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c689984ee178ac24a1580d6ab1dbd88568b99443447c9def86f1de1a33cbf30
|
|
BLAKE2b-256 checksum How to use checksums |
877748557e6a7e2c4f5f922adfbc6ccf97c4603e2266a327c7c473b9a9a71c29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mnelab-1.6.0-py3-none-any.whl
| Download URL | mnelab-1.6.0-py3-none-any.whl |
|---|---|
| Size | 478.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec85a88cff9083a467d2329abfa2e6aee3aacb7b1df86d0e6249e6656e18b12d
|
|
BLAKE2b-256 checksum How to use checksums |
00c502a2a7bf77dd2a690588a17e2b376f0ba41ffcdd2ada0f7cbb8e7c811539
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|