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.3.tar.gz (701.3 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.3-py3-none-any.whl (863.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.3.tar.gz
  • Upload date:
  • Size: 701.3 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.3.tar.gz
Algorithm Hash digest
SHA256 0bdf0492f4ce6471404ff3c0a8cfaf7dbc72dfd9900139492565c3fcfca257d7
MD5 709a9bd8cd63e6dbbb23862296fc107d
BLAKE2b-256 9f362a507cc8fb059cf008074393d26c3ba2feef4cdf300744696b8314920ac8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: autocleaneeg_pipeline-3.0.3-py3-none-any.whl
  • Upload date:
  • Size: 863.0 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b778dabca219b9dde42ba5f56853386ee142d06ee40f386e9a63923ab46c818f
MD5 686e4b31e4dd5e47aa50aeeff27ec263
BLAKE2b-256 0f356ea33c1ca0208dbc61bcded9c16c03cf3eafd4a49b5aa1d2dae792b21fa5

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