Skip to main content

Python implementation of the ARMBR blink removal method

Project description

This is the Python implementation of Artifact-reference multivariate backward regression (ARMBR): a novel method for EEG blink artifact removal with minimal data requirements (for full algorithm, see citation below).

ARMBR is a lightweight and easy-to-use method for blink artifact removal from EEG signals using multivariate backward regression. The algorithm detects the times at which eye blinks occur and then estimates their linear scalp projection by regressing a simplified, time-locked reference signal against the multichannel EEG. This projection is used to suppress blink-related components while preserving underlying brain signals. ARMBR requires minimal training data, does not depend on dedicated EOG channels, and operates robustly in both offline and real-time (online) settings, including BCI applications.

This release contains some improvements to the BCI2000 GUI. It allows the user to create batch files to fit and apply ARMBR in BCI2000.

The code is maintained at: https://github.com/S-Shah-Lab/ARMBR

The semi-synthetic data used in the ARMBR paper, along with example codes that allow testing ARMBR of the semi-synthetic data used in the paper, are available on OSF at: https://osf.io/th2g6/

If you use ARMBR in your work, please cite:

Citation:

Alkhoury L, Scanavini G, Louviot S, Radanovic A, Shah SA & Hill NJ (2025). Artifact-Reference Multivariate Backward Regression (ARMBR): A Novel Method for EEG Blink Artifact Removal with Minimal Data Requirements. Journal of Neural Engineering, 22(3). DOI: 10.1088/1741-2552/ade566 PubMed: 40527334

BibTeX:

@article{alkhoury2025armbr,
    author  = {Alkhoury, Ludvik and Scanavini, Giacomo and Louviot, Samuel and Radanovic, Ana and Shah, Sudhin A and Hill, N Jeremy},
    title   = {Artifact-Reference Multivariate Backward Regression ({ARMBR}): A Novel Method for {EEG} Blink Artifact Removal with Minimal Data Requirements},
    journal = {Journal of Neural Engineering},
    volume  = {22},
    number  = {3},
    pages   = {036048},
    year    = {2025},
    date    = {2025-06-25},
    doi     = {10.1088/1741-2552/ade566},
    url     = {https://doi.org/10.1088/1741-2552/ade566},
}			

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

armbr-2.0.11.tar.gz (28.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

armbr-2.0.11-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

Details for the file armbr-2.0.11.tar.gz.

File metadata

  • Download URL: armbr-2.0.11.tar.gz
  • Upload date:
  • Size: 28.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.0

File hashes

Hashes for armbr-2.0.11.tar.gz
Algorithm Hash digest
SHA256 a1316d6114adaa4eb1ea0dbe4082c30b83d406c82a95717be48bdea564e80327
MD5 305e7025f8689f9efdf994ad69a28a17
BLAKE2b-256 82c24e7bb26abbf980dca322af4571c1d406df9be5d4ee1e9de25e390c0d4440

See more details on using hashes here.

File details

Details for the file armbr-2.0.11-py3-none-any.whl.

File metadata

  • Download URL: armbr-2.0.11-py3-none-any.whl
  • Upload date:
  • Size: 25.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.0

File hashes

Hashes for armbr-2.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 e69a0ced3738f31a4b3e56bb1eb7903375d1ecd6da60c8f576c2f1b8bc8c2f81
MD5 70da59b4d2cf33726009deb57b9ae169
BLAKE2b-256 f61f3332f86fd977362cc54fdc92271eb27cc3903dcdec2c7b11c933bd5c04d5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page