meg-qc 0.7.1

Tool for automated MEG data quality control

MEGqc

MEGqc is an open-source, BIDS-aligned toolbox for automated MEG quality assessment (QA) and explicit quality control (QC) summarization.

It is designed for large cohorts and reproducible workflows, and provides both:

• interactive HTML reports for human inspection, and
• machine-readable derivatives for downstream automation.

What MEGqc Provides

• QA-first quality profiling of raw MEG signal quality before exclusion decisions.
• Multi-metric coverage including:
  • standard deviation (STD),
  • peak-to-peak amplitude (PtP),
  • power spectral density (PSD),
  • ECG/EOG-related contamination,
  • high-frequency muscle burden,
  • optional head-motion summaries.
• Multi-scale reporting across recording, channel, epoch, subject, dataset group, and multi-sample comparisons.
• QC support layer with configurable module-level criteria and a Global Quality Index (GQI).
• Reproducible execution with profile-aware outputs and saved settings provenance.
• Three usage modes: CLI, GUI, and programmatic dispatchers.

Requirements

• Python 3.10
• MEG data organized according to BIDS/MEG-BIDS.

Installation

Use the official installation guide:

https://ancplaboldenburg.github.io/megqc_documentation/book/installation2.html

Quick Start (CLI)

1. Export default config:

get-megqc-config --target_directory ./config

2. Run QA/QC calculation:

run-megqc   --inputdata /path/to/bids_dataset   --config ./config/settings.ini

3. Build plotting reports:

run-megqc-plotting --inputdata /path/to/bids_dataset

4. Recompute GQI summaries (optional):

globalqualityindex --inputdata /path/to/bids_dataset

5. Run full pipeline in one command (calculation + plotting):

run-megqc   --inputdata /path/to/bids_dataset   --config ./config/settings.ini   --run-all

Launch GUI

megqc

The GUI uses the same backend logic as CLI dispatchers and writes the same derivative/report outputs.

Typical Outputs

MEGqc writes outputs under BIDS derivatives (default):

• derivatives/Meg_QC/calculation/... (metric tables + JSON summaries)
• derivatives/Meg_QC/reports/... (interactive HTML reports)
• derivatives/Meg_QC/... QC summaries including GQI artifacts

Documentation

• Main documentation: https://ancplaboldenburg.github.io/megqc_documentation/index.html
• Tutorial: https://ancplaboldenburg.github.io/megqc_documentation/book/tutorial.html

Source Code

https://github.com/ANCPLabOldenburg/MEGqc

License

MIT License.