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.12.tar.gz (38.7 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.12-py3-none-any.whl (35.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for armbr-2.0.12.tar.gz
Algorithm Hash digest
SHA256 377a6c8bbed6ef9965972a8dbc005e6b7c3182cf24dc1bd8b8f4211410c2fd23
MD5 af1ca55bb7f6cd40c0d6195eb3594a1c
BLAKE2b-256 987cf4f664edf72c8025c14cf97d759c7c8a5629e3ee7bb94bac2214bff5f427

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for armbr-2.0.12-py3-none-any.whl
Algorithm Hash digest
SHA256 03f0823586a976fa99116696761b2e3274c829ecbce57068c4786f3d721063b3
MD5 16551cf5bc2af3e606bbf0e652224ecb
BLAKE2b-256 0b576c895e1314d2aba08d9886e236da759de2f9031dd507074b163fa5d77036

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