Skip to main content

A modular framework for automated EEG data processing, built on MNE-Python

Project description

AutoCleanEEG Pipeline

Python License Code style: black

A modular framework for automated EEG data processing, built on MNE‑Python.

Features

  • Framework for automated EEG preprocessing with "lego block" modularity
  • Support for multiple EEG paradigms (ASSR, Chirp, MMN, Resting State)
  • BIDS-compatible data organization and comprehensive quality control
  • Extensible plugin system for file formats, montages, and event processing
  • Research-focused workflow: single file testing → parameter tuning → batch processing
  • Detailed output: BIDS‑compatible derivatives, single task log file, stage files, exports, and QA visualizations

Installation (uv)

Use Astral's uv for fast, isolated installs. If you don't have uv yet, see https://docs.astral.sh/uv/

  • Install CLI (recommended for users):
uv tool install autocleaneeg-pipeline
autocleaneeg-pipeline --help
  • Upgrade or remove:
uv tool upgrade autocleaneeg-pipeline
uv tool uninstall autocleaneeg-pipeline
  • Development install from source (editable install):
git clone https://github.com/cincibrainlab/autocleaneeg_pipeline.git
cd autocleaneeg_pipeline
uv tool install -e --upgrade . --force
autocleaneeg-pipeline --help # Slow on first run!

Documentation

Full documentation is available at https://docs.autocleaneeg.org

Development

For contributors, we provide a Makefile with convenient development commands:

make help          # Show all available commands
make check         # Run code quality checks
make format        # Auto-format code
make lint          # Run linting and type checking
make test          # Run unit tests
make test-cov      # Run tests with coverage
make ci-check      # Run CI-equivalent checks locally

See CONTRIBUTING.md for full development guidelines.

Contributing

We welcome contributions! Please see our Contributing Guide for details. For branch workflow and cleanup expectations, see BRANCHING.md.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Cincinnati Children's Hospital Research Foundation
  • Built with MNE-Python

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

autocleaneeg_pipeline-3.0.2.tar.gz (700.8 kB view details)

Uploaded Source

Built Distribution

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

autocleaneeg_pipeline-3.0.2-py3-none-any.whl (861.9 kB view details)

Uploaded Python 3

File details

Details for the file autocleaneeg_pipeline-3.0.2.tar.gz.

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.2.tar.gz
  • Upload date:
  • Size: 700.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for autocleaneeg_pipeline-3.0.2.tar.gz
Algorithm Hash digest
SHA256 cd247e0d957a0fbdc4bb109f91afb1e5d92249c6c8df13c555d946aee9576ce0
MD5 d3eda615030f59c6f01bf3a2f5fd197a
BLAKE2b-256 be63fd14a45c7ccf65fbe8cb2170525a12f4de9c7e84118d30204914e0f2b7d9

See more details on using hashes here.

File details

Details for the file autocleaneeg_pipeline-3.0.2-py3-none-any.whl.

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.2-py3-none-any.whl
  • Upload date:
  • Size: 861.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for autocleaneeg_pipeline-3.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 eb98554671e5cb3a85beb4e570fe74bacad0487105e81dea478d8539313b1756
MD5 cda8fe7585805c14a81e65619772e082
BLAKE2b-256 50fb4531de4ec8d7a80fcf4b610244e021c9c498839650296c7c5750dc4fc2a5

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