eeg-ica

Fit ICA per subject and reject artifact components using ICLabel confidence scoring.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dengzhe-hou/auto-eeg-analysis --skill eeg-ica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eeg-ica
Source: https://github.com/dengzhe-hou/auto-eeg-analysis/tree/main/skills/eeg-ica
Command: npx skills add https://github.com/dengzhe-hou/auto-eeg-analysis --skill eeg-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

EEG analysis pipelines often suffer from eye, muscle, heartbeat, and line-noise artifacts that are slow and error-prone to remove by manual inspection.

Core Features & Use Cases

  • Fits ICA per subject and transfers the solution correctly: it fits on a 1 Hz high-pass copy (to improve decomposition quality) and then applies the ICA weights to the original analysis-bandpass data.
  • Auto-labels components using ICLabel and removes artifact classes: it predicts component types (eye blink, eye movement, muscle, heart, line noise, channel noise) and excludes those whose confidence exceeds a threshold.
  • Safeguards manual review for ambiguity: components with high ambiguity or low confidence are flagged and paused for human confirmation rather than being blindly rejected.

Quick Start

Run ICA artifact removal for your study by executing: /eeg-ica projects/my-study --method infomax --n_components 0.99 --threshold 0.7

Frequently Asked Questions about eeg-ica

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically label and remove EEG artifacts using ICA?

Automated EEG artifact removal uses ICLabel confidence scoring to predict component types like eye blink and heartbeat, excluding those exceeding a threshold. This approach fits ICA per subject and applies weights to original bandpass data to generate cleaned outputs.

What is the best way to handle ambiguous ICA components during EEG preprocessing?

Handling ambiguous ICA components involves flagging items with high ambiguity or low confidence for human confirmation. This safeguard pauses the artifact removal pipeline, ensuring components are reviewed rather than blindly rejected during EEG preprocessing.

How do I fit ICA on a high-pass filtered copy for EEG decomposition?

Fitting ICA on a 1 Hz high-pass copy improves decomposition quality by stabilizing the algorithm. The resulting ICA weights are then transferred and applied to the original analysis-bandpass EEG data to preserve the desired frequency range.

Do I need an unfrozen ANALYSIS_PLAN.md to run the ICA artifact removal pipeline?

Yes, an unfrozen ANALYSIS_PLAN.md must be present to run the ICA artifact removal pipeline. The pipeline requires this file to define parameters and uses preprocess-stage outputs to fit ICA and generate per-subject labels.

Can I use MNE-Python with ICLabel for repeatable EEG artifact rejection?

Yes, MNE-Python supports repeatable EEG artifact rejection when integrated with ICLabel confidence scoring. This combination performs automated ICA decomposition, removes artifacts, and generates per-subject component documentation for paper-aligned preprocessing.