Sign in
NeurosciencebioRxiv
Preprint

The BeMoBIL Pipeline for automated analyses of multimodal mobile brain and body imaging data

Marius KlugiD, Sein JeungiD, Anna WunderlichiD, Lukas GehrkeiD, Janna ProtzakiD, Zakaria DjebbaraiD, Andreas Argubi‐WolleseniD, Bettina WolleseniD, Klaus GramanniD

Abstract

Advancements in hardware technology and analysis methods allow more and more mobility in electroencephalography (EEG) experiments. Mobile Brain/Body Imaging (MoBI) studies may record various types of data such as motion or eye tracking in addition to neural activity. Although there are options available to analyze EEG data in a standardized way, they do not fully cover complex multimodal data from mobile experiments. We thus propose the BeMoBIL Pipeline, an easy-to-use pipeline in MATLAB that supports the time-synchronized handling of multimodal data. It is based on EEGLAB and fieldtrip and consists of automated functions for EEG preprocessing and subsequent source separation. It also provides functions for motion data processing and extraction of event markers from different data modalities, including the extraction of eye-movement and gait-related events from EEG using independent component analysis. The pipeline introduces a new robust method for region-of-interest-based group-level clustering of independent EEG components. Finally, the BeMoBIL Pipeline provides analytical visualizations at various processing steps, keeping the analysis transparent and allowing for quality checks of the resulting outcomes. All parameters and steps are documented within the data structure and can be fully replicated using the same scripts. This pipeline makes the processing and analysis of (mobile) EEG and body data more reliable and independent of the prior experience of the individual researchers, thus facilitating the use of EEG in general and MoBI in particular. It is an open-source project available for download at https://github.com/BeMoBIL/bemobil-pipeline which allows for community-driven adaptations in the future.

PDFDOICode
Full-text digest ↓

02 /Specification & Classification

Click any tag to browse matching papers

In-depth summary

✦ Multi-agent verified full-text synthesis

Claude Opus 5.5 · xhigh effort · 8 Nov 2026 · from the full text of version 2 (6 Oct 2022) · CC BY 4.0

Open-source MATLAB pipeline (EEGLAB, fieldtrip) that synchronizes mobile EEG with motion and eye-tracking data, extracts gait, blink and heartbeat events, and clusters independent components per region of interest.

Mobile Brain/Body Imaging (MoBI) studies record EEG alongside motion, eye tracking and other streams at different and sometimes irregular sampling rates; the authors note that existing EEG pipelines such as PREP and HAPPE do not cater to such multimodal data and that the multimodal toolbox MoBILAB is no longer supported. BeMoBIL adds synchronized multimodal import, motion processing, event extraction from several modalities and from independent components, and repeated clustering for group-level source analysis.

Key results

  1. SuggestedThe import step converts Lab Streaming Layer recordings (extensible data format, XDF) to the Brain Imaging Data Structure (BIDS) and then to EEGLAB datasets. In these datasets every stream has the EEG sample count and the same event markers, so events found in one modality can be copied to another.

    EEG is resampled with a filter-based method (pop_resample), and the other streams are interpolated (pchip) onto the EEG sample times. In the Figure 2 example, 500 Hz EEG and 90 Hz motion both end at 250 Hz. The authors state that filter-based resampling of long recordings can drift by several hundreds of milliseconds, while interpolation keeps alignment within one sample; neither claim is quantified. · Time-synchronized data collection and import; Standardizing MoBI data; Figure legends

  2. SuggestedRepeated k-means clustering picks the group-level independent component (IC) cluster for a region of interest (ROI). It ranks many clustering solutions by subject coverage, ICs per subject, spread, mean residual variance, distance to the ROI and Mahalanobis distance from the median solution.

    The example used four participants from the visual discrimination study, 1000 repetitions and a posterior parietal ROI (MNI [0,-48,39]). The top-ranked solutions were similar and the top 2 were identical. The authors state that 100 repetitions may be enough for visual cortex, while deeper ROIs such as the retrosplenial complex may need several thousand. · Robust group-level source analysis for regions…; Figure legends

  3. SuggestedBlink, saccade and step events can be extracted from independent component time series when no eye tracker or motion capture was recorded. The IC-based blink detector agreed with the pupil-based eye-tracking detector around 80% of the time.

    The agreement comes from the authors' tests in one experiment with strong eye movements; participant and event counts are not given. Strong vertical eye movements can look like blinks in the vertical IC, so the authors say saccade output is not always reliable and let users switch it off. Detection uses moving-median smoothing (0.08 s default) and findpeaks. · IC-based blink and saccade event detection; IC-based gait-related event detection

  4. ClaimedBefore independent component analysis (ICA), the pipeline uses the built-in sample rejection of Adaptive Mixture ICA (AMICA) rather than a separate time-domain cleaning step. Flagged samples are ignored when the spatial filters are fitted but stay in the data.

    Samples whose log-likelihood falls more than a set number of standard deviations below the mean (3 recommended) are removed in repeated passes (5 to 10 recommended). In the authors' tests this matched or beat their own epoch-based cleaning, but those results are in supplementary material not in the text. Stricter rejection may lower event-related potential (ERP) signal-to-noise despite a better decomposition. · Independent component analysis; Time-domain cleaning based on epoch rejection

  5. ClaimedICA is fitted on a copy of the data high-pass filtered at a true 1.25 Hz cutoff. The decomposition is then copied back to the unfiltered data, so the filter only affects the decomposition.

    The recommended filter order is 1650 (0.5 Hz transition bandwidth) with a 1.5 Hz passband edge, using a zero-phase Hamming-window finite impulse response (FIR) filter; 2 Hz or higher is suggested for strong movement. The choice rests on the authors' earlier filter comparison, not on new data here. A final 0.2 Hz high-pass is recommended for the output dataset. · Independent component analysis; Original data reconstruction and independent…

Methods, data and reproducibility

A MATLAB toolbox built on EEGLAB and fieldtrip, run through wrapper functions and one configuration file. It covers XDF-to-BIDS conversion and synchronized import, automated EEG preprocessing (Zapline-plus, repeated bad-channel detection, full-rank average reference), AMICA, DIPFIT dipole fitting, ICLabel cleaning, motion processing, multimodal event detection and repeated IC clustering. It is shown on example data.

  • NeSitA example data: EEG with controller motion and eye tracking during a physical reaching task, used for the synchronization, blink and plotting examples · human
  • Visual discrimination example datasets: EEG with foot motion tracking during walking, used for the preprocessing, gait-event and clustering examples · human · n = four example participants (clustering example)
Methods & tools
MATLAB, EEGLAB, fieldtrip, Lab Streaming Layer (LSL) / XDF, BIDS (EEG-BIDS, MOTION-BIDS), Zapline-plus, clean raw data EEGLAB plugin (clean_artifacts), AMICA, DIPFIT, ICLabel, Pan-Tompkins algorithm, SPoC, CCA, SSD
Reproducibility gaps
There is no direct data URL or accession; the example data and scripts are to be downloaded as described in the repository. No software versions (MATLAB, EEGLAB, fieldtrip, plugins) or runtime and hardware figures are given; installation is documented on the wiki.
Limitations (6)
  • Heavily automated processing can hide data subtleties and processing errors. The authors rely on analytics plots at each step and urge close inspection of the data. · stated by the authors
  • ICLabel was trained mostly on stationary recordings, so muscle and movement-related components are underrepresented. Misclassification is possible, especially with many muscle sources, and the plots must be checked by hand. · stated by the authors
  • IC-based saccade detection is not always reliable: vertical eye movements can resemble blinks, and saccades can mask blinks or be missed. · stated by the authors
  • Interpolating non-EEG streams onto EEG samples may distort high-frequency content, for example in eye tracking. Filter-based resampling with an exact sampling rate is offered as an alternative. · stated by the authors
  • There is no quantitative comparison with other pipelines (such as PREP or HAPPE) or with ground truth. The performance statements (about 80% blink agreement; AMICA rejection versus epoch cleaning) give no participant counts or statistics. · noted in this summary
  • The robust clustering is demonstrated on only four participants from a single example study. · noted in this summary

Who should read:Read this if you process mobile EEG recorded with motion capture, eye tracking or electrocardiography in MATLAB/EEGLAB and want a configurable, documented pipeline from XDF/BIDS import to group-level IC clustering.

Reproducibility ledger

Nobody has reported trying to reproduce this paper yet. Did you replicate an experiment or run the code? Your report saves the next lab a week.

Sign in to file a reproducibility report.