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.4.tar.gz (701.9 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.4-py3-none-any.whl (863.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.4.tar.gz
  • Upload date:
  • Size: 701.9 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.4.tar.gz
Algorithm Hash digest
SHA256 fda0f7e54ed22cb3a867c2dc627b4a94441fa0b7e911a3c578eed23c52b59e85
MD5 9e0134072c8874d81e7206844def2e42
BLAKE2b-256 6b684958c6044214f1427a038b7d4a0aa3b5b0fcf04a55d42d0f2d83ff73aad4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.4-py3-none-any.whl
  • Upload date:
  • Size: 863.6 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 278a7b3841b8be07f43c90d652764ad08ec8d6d7535a051b57a4143c8627f343
MD5 a0e98b6b5acf2e5ec70e0bc71b3a7f6f
BLAKE2b-256 c6742e90a14fb6deaf69297ebd071b8f66f4f8dde0d65a259fad221f2f4f00c5

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