Upload 8934 files

.gitattributes

@@ -33,3 +33,34 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+mne-python/source/doc/_static/blender_import_obj/blender_import_obj1.jpg filter=lfs diff=lfs merge=lfs -text
+mne-python/source/doc/_static/blender_import_obj/blender_import_obj4.jpg filter=lfs diff=lfs merge=lfs -text
+mne-python/source/doc/_static/funding/nsf.png filter=lfs diff=lfs merge=lfs -text
+mne-python/source/doc/_static/mne_installer_macOS.png filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/data/fsaverage/fsaverage-inner_skull-bem.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/brainvision/tests/data/test_bin_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/brainvision/tests/data/test.eeg filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/exported4D_linux_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/exported4D_solaris_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/test_config_linux filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/test_config_solaris filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/test_hs_solaris filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/test_pdf_linux filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/bti/tests/data/test_pdf_solaris filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/edf/tests/data/test_bdf_eeglab.mat filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/edf/tests/data/test_edf_eeglab.mat filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/edf/tests/data/test_eeglab.mat filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/kit/tests/data/test_bin_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/kit/tests/data/test_Ykgw.mat filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/kit/tests/data/test-epoch.raw filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/kit/tests/data/test.sqd filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_chpi_raw_sss.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_ctf_comp_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_ctf_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_erm-cov.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test_withbads_raw.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test-ave.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test-cov.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test-km-cov.fif filter=lfs diff=lfs merge=lfs -text
+mne-python/source/mne/io/tests/data/test-nf-ave.fif filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,18 @@
+FROM python:3.10
+
+RUN useradd -m -u 1000 user && python -m pip install --upgrade pip
+USER user
+ENV PATH="/home/user/.local/bin:$PATH"
+
+WORKDIR /app
+
+COPY --chown=user ./requirements.txt requirements.txt
+RUN pip install --no-cache-dir --upgrade -r requirements.txt
+
+COPY --chown=user . /app
+ENV MCP_TRANSPORT=http
+ENV MCP_PORT=7860
+
+EXPOSE 7860
+
+CMD ["python", "mne-python/mcp_output/start_mcp.py"]

app.py

@@ -0,0 +1,45 @@
+from fastapi import FastAPI
+import os
+import sys
+
+mcp_plugin_path = os.path.join(os.path.dirname(__file__), "mne-python", "mcp_output", "mcp_plugin")
+sys.path.insert(0, mcp_plugin_path)
+
+app = FastAPI(
+    title="Mne-Python MCP Service",
+    description="Auto-generated MCP service for mne-python",
+    version="1.0.0"
+)
+
+@app.get("/")
+def root():
+    return {
+        "service": "Mne-Python MCP Service",
+        "version": "1.0.0",
+        "status": "running",
+        "transport": os.environ.get("MCP_TRANSPORT", "http")
+    }
+
+@app.get("/health")
+def health_check():
+    return {"status": "healthy", "service": "mne-python MCP"}
+
+@app.get("/tools")
+def list_tools():
+    try:
+        from mcp_service import create_app
+        mcp_app = create_app()
+        tools = []
+        for tool_name, tool_func in mcp_app.tools.items():
+            tools.append({
+                "name": tool_name,
+                "description": tool_func.__doc__ or "No description available"
+            })
+        return {"tools": tools}
+    except Exception as e:
+        return {"error": f"Failed to load tools: {str(e)}"}
+
+if __name__ == "__main__":
+    import uvicorn
+    port = int(os.environ.get("PORT", 7860))
+    uvicorn.run(app, host="0.0.0.0", port=port)

mne-python/mcp_output/README_MCP.md

@@ -0,0 +1,129 @@
+# MNE-Python MCP (Model Context Protocol) Service README
+
+## 1) Project Introduction
+
+This service wraps core **MNE-Python** capabilities for EEG/MEG workflows in an MCP (Model Context Protocol)-friendly interface.
+
+Primary goals:
+- Load raw neurophysiology data (FIF, EDF, BDF, BrainVision).
+- Perform event handling and channel picking.
+- Run common preprocessing (EOG/ECG detection, ICA-related preparation).
+- Compute PSD and time-frequency features.
+- Optionally render diagnostic visualizations (when GUI/backends are available).
+
+Recommended integration path:
+- **Primary:** in-process Python imports from `mne` modules.
+- **Fallback:** call the `mne` CLI for heavier or isolated execution contexts.
+
+---
+
+## 2) Installation Method
+
+### Requirements
+Core dependencies:
+- `numpy`
+- `scipy`
+- `matplotlib`
+- `packaging`
+- `pooch`
+- `tqdm`
+
+Common optional dependencies (feature-dependent):
+- `scikit-learn`, `pandas`, `h5py`, `nibabel`
+- `pyvista`, `vtk`, `mne-qt-browser`
+- `numba`
+
+### Install
+- Install MNE-Python and common scientific stack via pip:
+  - `pip install mne`
+- For broader functionality:
+  - `pip install mne[full]` (if supported by your environment/version)
+- If your service uses project-local dependency files, prefer:
+  - `pyproject.toml` / `environment.yml` in your deployment workflow.
+
+---
+
+## 3) Quick Start
+
+### Minimal service flow (Python-side)
+1. Read raw data:
+   - `mne.io.read_raw_fif(...)` / `read_raw_edf(...)` / `read_raw_bdf(...)` / `read_raw_brainvision(...)`
+2. Extract events:
+   - `mne.find_events(raw)` or `mne.read_events(path)`
+3. Pick channels:
+   - `mne.pick_types(raw.info, meg=True, eeg=True, eog=True, exclude="bads")`
+4. Preprocess (optional):
+   - `mne.preprocessing.find_eog_events(raw)`, `find_ecg_events(raw)`, ICA workflows
+5. Spectral analysis:
+   - `mne.time_frequency.psd_array_welch(...)` or `psd_array_multitaper(...)`
+6. Return structured results from your MCP (Model Context Protocol) service endpoint.
+
+### CLI fallback
+- Use `mne` command wrapper when import-time overhead or environment isolation is needed.
+
+---
+
+## 4) Available Tools and Endpoints List
+
+Suggested MCP (Model Context Protocol) service endpoints:
+
+- `load_raw`
+  - Load raw recordings from FIF/EDF/BDF/BrainVision.
+  - Maps to `mne.io.read_raw_*`.
+
+- `read_info`
+  - Read metadata/header info without full processing.
+  - Maps to `mne.io.read_info`.
+
+- `events_detect`
+  - Detect or load event markers.
+  - Maps to `mne.find_events`, `mne.read_events`, `mne.merge_events`.
+
+- `channels_pick`
+  - Build channel selections by modality/type.
+  - Maps to `mne.pick_types`.
+
+- `preprocess_eog_ecg`
+  - EOG/ECG event detection and projection helpers.
+  - Maps to `mne.preprocessing.find_eog_events`, `find_ecg_events`, `compute_proj_eog`, `compute_proj_ecg`.
+
+- `ica_workflow`
+  - Artifact decomposition/removal pipeline.
+  - Maps to `mne.preprocessing.ICA`, `EOGRegression`.
+
+- `psd_compute`
+  - Power spectral density calculations.
+  - Maps to `mne.time_frequency.psd_array_welch`, `psd_array_multitaper`.
+
+- `tfr_compute`
+  - Time-frequency decomposition.
+  - Maps to `tfr_morlet`, `tfr_multitaper`, `csd_multitaper`.
+
+- `viz_diagnostics` (optional/headless-sensitive)
+  - Event/covariance/alignment diagnostic plotting.
+  - Maps to `mne.viz.plot_events`, `plot_cov`, `plot_bem`, `plot_alignment`.
+
+- `cli_exec` (fallback)
+  - Run `mne` subcommands for isolated or heavyweight tasks.
+
+---
+
+## 5) Common Issues and Notes
+
+- **Complexity:** MNE-Python is feature-rich; keep endpoint contracts narrow and typed.
+- **Import overhead:** First import can be non-trivial; consider lazy-loading per endpoint.
+- **GUI dependencies:** Visualization endpoints may fail in headless servers unless backend is configured.
+- **Optional packages:** Some analyses silently require extras (`sklearn`, `h5py`, `nibabel`, etc.).
+- **Performance:** Large FIF files and TFR/ICA jobs are memory/CPU intensive; set resource limits.
+- **Reproducibility:** Pin MNE + NumPy/SciPy versions in deployment.
+- **Risk profile:** Import feasibility is moderate (~0.72); keep CLI fallback available.
+- **Data handling:** Validate paths, file formats, and channel metadata before heavy processing.
+
+---
+
+## 6) Reference Links / Documentation
+
+- MNE-Python repository: https://github.com/mne-tools/mne-python
+- MNE official docs: https://mne.tools/stable/index.html
+- MNE API reference: https://mne.tools/stable/python_reference.html
+- MNE command-line tools: https://mne.tools/stable/overview/command_line.html

mne-python/mcp_output/analysis.json

@@ -0,0 +1,199 @@
+{
+  "summary": {
+    "repository_url": "https://github.com/mne-tools/mne-python",
+    "summary": "Unable to preprocess repository: https://github.com/mne-tools/mne-python",
+    "file_tree": {},
+    "content": {},
+    "processed_by": "fallback",
+    "success": false,
+    "error": "zip download failed: IncompleteRead(4160073 bytes read)"
+  },
+  "structure": {
+    "packages": [
+      "deployment.mne-python.source",
+      "mcp_output.mcp_plugin",
+      "source.mne",
+      "source.mne._fiff",
+      "source.mne.beamformer",
+      "source.mne.channels",
+      "source.mne.commands",
+      "source.mne.data",
+      "source.mne.datasets",
+      "source.mne.decoding",
+      "source.mne.export",
+      "source.mne.forward",
+      "source.mne.gui",
+      "source.mne.html_templates",
+      "source.mne.inverse_sparse",
+      "source.mne.io",
+      "source.mne.minimum_norm",
+      "source.mne.preprocessing",
+      "source.mne.report",
+      "source.mne.simulation",
+      "source.mne.source_space",
+      "source.mne.stats",
+      "source.mne.tests",
+      "source.mne.time_frequency",
+      "source.mne.utils",
+      "source.mne.viz"
+    ]
+  },
+  "dependencies": {
+    "has_environment_yml": true,
+    "has_requirements_txt": false,
+    "pyproject": true,
+    "setup_cfg": false,
+    "setup_py": false
+  },
+  "entry_points": {
+    "imports": [],
+    "cli": [],
+    "modules": []
+  },
+  "llm_analysis": {
+    "core_modules": [
+      {
+        "package": "source.mne",
+        "module": "source.mne",
+        "functions": [
+          "create_info",
+          "set_log_level",
+          "read_events",
+          "pick_types",
+          "find_events",
+          "merge_events",
+          "concatenate_raws"
+        ],
+        "classes": [
+          "Info",
+          "Covariance",
+          "Epochs",
+          "Evoked",
+          "Annotations"
+        ],
+        "description": "Top-level API surface for core EEG/MEG data structures and common preprocessing/event utilities; safest primary integration point for MCP tooling."
+      },
+      {
+        "package": "source.mne.io",
+        "module": "source.mne.io",
+        "functions": [
+          "read_raw_fif",
+          "read_raw_edf",
+          "read_raw_bdf",
+          "read_raw_brainvision",
+          "read_info"
+        ],
+        "classes": [
+          "Raw",
+          "RawArray"
+        ],
+        "description": "Input/output layer for loading raw recordings from major formats and constructing in-memory raw objects."
+      },
+      {
+        "package": "source.mne.preprocessing",
+        "module": "source.mne.preprocessing",
+        "functions": [
+          "compute_proj_ecg",
+          "compute_proj_eog",
+          "find_eog_events",
+          "find_ecg_events",
+          "create_eog_epochs"
+        ],
+        "classes": [
+          "ICA",
+          "EOGRegression"
+        ],
+        "description": "Artifact detection/removal workflows (ICA/projections/regression), useful for preprocessing-oriented MCP commands."
+      },
+      {
+        "package": "source.mne.time_frequency",
+        "module": "source.mne.time_frequency",
+        "functions": [
+          "psd_array_welch",
+          "psd_array_multitaper",
+          "tfr_morlet",
+          "tfr_multitaper",
+          "csd_multitaper"
+        ],
+        "classes": [
+          "AverageTFR",
+          "EpochsTFR"
+        ],
+        "description": "Frequency-domain and time-frequency analysis APIs commonly needed for downstream analytics plugins."
+      },
+      {
+        "package": "source.mne.viz",
+        "module": "source.mne.viz",
+        "functions": [
+          "plot_events",
+          "plot_cov",
+          "plot_bem",
+          "plot_alignment"
+        ],
+        "classes": [],
+        "description": "Visualization endpoints; useful but generally optional in headless MCP execution."
+      },
+      {
+        "package": "source.mne.commands",
+        "module": "source.mne.commands",
+        "functions": [],
+        "classes": [],
+        "description": "CLI command package; preferred fallback execution boundary when direct in-process imports are too heavy."
+      }
+    ],
+    "cli_commands": [
+      {
+        "name": "mne",
+        "module": "source.mne.commands",
+        "description": "Primary MNE command-line entry wrapper (subcommand-based tooling for data handling, preprocessing, and project utilities)."
+      }
+    ],
+    "import_strategy": {
+      "primary": "import",
+      "fallback": "cli",
+      "confidence": 0.7
+    },
+    "dependencies": {
+      "required": [
+        "numpy",
+        "scipy",
+        "matplotlib",
+        "packaging",
+        "pooch",
+        "tqdm"
+      ],
+      "optional": [
+        "sklearn",
+        "pandas",
+        "h5py",
+        "nibabel",
+        "pyvista",
+        "vtk",
+        "mne-qt-browser",
+        "numba"
+      ]
+    },
+    "risk_assessment": {
+      "import_feasibility": 0.72,
+      "intrusiveness_risk": "medium",
+      "complexity": "complex"
+    }
+  },
+  "deepwiki_analysis": {
+    "repo_url": "https://github.com/mne-tools/mne-python",
+    "repo_name": "mne-python",
+    "error": "DeepWiki analysis failed",
+    "model": "gpt-5.3-codex",
+    "source": "llm_direct_analysis",
+    "success": false
+  },
+  "deepwiki_options": {
+    "enabled": true,
+    "model": "gpt-5.3-codex"
+  },
+  "risk": {
+    "import_feasibility": 0.72,
+    "intrusiveness_risk": "medium",
+    "complexity": "complex"
+  }
+}

mne-python/mcp_output/diff_report.md

@@ -0,0 +1,161 @@
+# Difference Report — **mne-python**
+
+**Generated:** 2026-03-14 12:25:49  
+**Repository:** `mne-python`  
+**Project Type:** Python library  
+**Scope / Main Features:** Basic functionality  
+**Change Intrusiveness:** None  
+**Workflow Status:** ✅ Success  
+**Test Status:** ❌ Failed  
+**Files Changed:** 8 new, 0 modified
+
+---
+
+## 1) Project Overview
+
+This update introduces **8 new files** to the `mne-python` codebase without modifying existing files.  
+Given the “Basic functionality” scope and “None” intrusiveness, the change appears additive and low-risk at the integration layer. However, the **failed test status** indicates unresolved quality or environment issues that block confidence in release readiness.
+
+---
+
+## 2) Change Summary
+
+| Metric | Value |
+|---|---:|
+| New files | 8 |
+| Modified files | 0 |
+| Deleted files | 0 (not reported) |
+| Intrusiveness | None |
+| CI workflow | Success |
+| Test result | Failed |
+
+### High-level interpretation
+- **Additive-only change set** (no direct regressions from edits to existing files expected).
+- **Pipeline orchestration passed**, suggesting jobs ran correctly.
+- **Test execution failed**, indicating either:
+  - new functionality is incomplete/incorrect,
+  - tests are outdated or misconfigured,
+  - dependency/version/environment mismatch.
+
+---
+
+## 3) Difference Analysis
+
+Because only aggregate metadata is provided (no file paths or patch hunks), analysis is structural:
+
+1. **No legacy code edits**
+   - Existing APIs likely unchanged directly.
+   - Backward compatibility risk is lower than in refactor/edit-heavy updates.
+
+2. **New surface area introduced**
+   - 8 files likely include one or more of:
+     - implementation modules,
+     - tests,
+     - docs/examples,
+     - configuration helpers.
+   - Any newly introduced module still affects packaging/import graph and CI.
+
+3. **Quality gate mismatch**
+   - CI workflow success + tests failed implies workflow did not enforce test pass as a hard gate, or failures occurred in a non-blocking stage.
+
+---
+
+## 4) Technical Analysis
+
+## 4.1 Risk Assessment
+
+| Area | Risk | Rationale |
+|---|---|---|
+| API stability | Low–Medium | No modified files, but new public modules may expose new API surface. |
+| Runtime behavior | Medium | New files can alter import side effects, plugin discovery, or optional paths. |
+| Test reliability | High | Failed tests directly reduce confidence in correctness. |
+| Release readiness | High risk (not ready) | Test suite failing is a release blocker for scientific Python libs. |
+
+## 4.2 Likely Failure Categories (to triage first)
+
+- **Unit test expectation mismatch** for newly added behavior.
+- **Missing optional dependencies** in CI test matrix.
+- **Numerical tolerance/precision drift** (common in scientific stacks).
+- **Platform-specific failures** (Linux/macOS/Windows differences).
+- **Import/package registration issues** (new files not wired into package init or config).
+- **Style/type/linters treated as tests** if test stage aggregates tooling checks.
+
+## 4.3 Validation Gaps
+
+- No file-level diff context available.
+- No failing test names/tracebacks included.
+- Cannot confirm whether failures are deterministic or flaky.
+
+---
+
+## 5) Recommendations & Improvements
+
+## 5.1 Immediate (Blocker Resolution)
+
+1. **Collect failure artifacts**
+   - Extract failing test IDs, stack traces, and environment metadata (Python, NumPy/SciPy, OS).
+2. **Classify failures**
+   - New-code defects vs. test harness/config issues.
+3. **Re-run targeted tests locally and in CI**
+   - Isolate minimal reproducer; verify determinism.
+4. **Enforce hard gate**
+   - Ensure release/protected branch requires test success.
+
+## 5.2 Short-term Quality Hardening
+
+- Add/adjust tests for each new file’s intended behavior.
+- If numeric algorithms were added, pin tolerances and seed randomness.
+- Validate packaging exposure (`__init__`, entry points, module discovery).
+- Run matrix smoke tests across supported Python versions.
+
+## 5.3 Process Improvements
+
+- Introduce a **change manifest** in PRs: purpose of each new file + expected impact.
+- Add CI stage separation:
+  - lint/type/doc checks,
+  - unit/integration tests,
+  - optional slow tests.
+- Track flaky tests and quarantine with explicit issue links.
+
+---
+
+## 6) Deployment Information
+
+## 6.1 Current Deployment Readiness
+
+**Status: Not recommended for deployment** due to failed tests.
+
+## 6.2 Suggested Release Criteria
+
+Deploy only after all conditions are met:
+
+- ✅ All required tests pass on supported matrix.
+- ✅ No critical/new warnings in CI logs.
+- ✅ Documentation/changelog entries for new files.
+- ✅ Versioning decision made (likely patch/minor based on new functionality exposure).
+
+## 6.3 Rollout Strategy (once green)
+
+- Use staged rollout (internal validation → broader user release).
+- Monitor error reports/import issues post-release.
+- Prepare rapid rollback/hotfix path.
+
+---
+
+## 7) Future Planning
+
+1. **Improve observability in CI**
+   - Publish structured test reports and failure clustering.
+2. **Strengthen compatibility guarantees**
+   - Add contract tests for public APIs.
+3. **Automate regression prevention**
+   - Pre-merge required checks + nightly full-matrix runs.
+4. **Documentation alignment**
+   - Ensure examples/tutorials reference new functionality where relevant.
+
+---
+
+## 8) Executive Conclusion
+
+This change set is structurally low-intrusive (**8 new files, no modifications**), but **test failures are a hard release blocker**.  
+Primary priority is failure triage and stabilization. Once tests are green and packaging/API exposure is validated, the update should be safe to proceed through normal release gates.

mne-python/mcp_output/mcp_plugin/adapter.py

@@ -0,0 +1,358 @@
+import os
+import sys
+import importlib
+import traceback
+from typing import Any, Dict, List, Optional
+
+source_path = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
+    "source",
+)
+sys.path.insert(0, source_path)
+
+
+class Adapter:
+    """
+    Import-mode adapter for the mne-python MCP plugin integration.
+
+    This adapter prioritizes Python imports and provides a graceful CLI fallback
+    pathway when import-based execution is unavailable.
+    """
+
+    # -------------------------------------------------------------------------
+    # Lifecycle / Initialization
+    # -------------------------------------------------------------------------
+    def __init__(self) -> None:
+        """
+        Initialize adapter state, import registry, and module availability.
+
+        Attributes:
+            mode: Adapter execution mode, fixed to "import".
+            package_root: Root import path for repository package.
+            modules: Loaded module cache keyed by logical name.
+            available: Boolean import readiness state.
+            warnings: List of non-fatal issues detected during initialization.
+        """
+        self.mode = "import"
+        self.package_root = "mne"
+        self.modules: Dict[str, Any] = {}
+        self.available = False
+        self.warnings: List[str] = []
+        self._initialize_imports()
+
+    def _initialize_imports(self) -> None:
+        """
+        Attempt to import core and command modules identified by analysis.
+
+        This method captures and stores import exceptions so the adapter can
+        continue operating in graceful fallback mode.
+        """
+        targets = {
+            "mne": "mne",
+            "commands": "mne.commands",
+        }
+
+        loaded = 0
+        for key, mod_path in targets.items():
+            try:
+                self.modules[key] = importlib.import_module(mod_path)
+                loaded += 1
+            except Exception as exc:
+                self.modules[key] = None
+                self.warnings.append(
+                    f"Failed to import '{mod_path}'. Verify local source checkout and dependencies. Detail: {exc}"
+                )
+        self.available = loaded > 0
+
+    # -------------------------------------------------------------------------
+    # Unified response helpers
+    # -------------------------------------------------------------------------
+    def _ok(self, message: str, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        return {"status": "success", "message": message, "data": data or {}}
+
+    def _fail(
+        self,
+        message: str,
+        error: Optional[str] = None,
+        guidance: Optional[str] = None,
+        data: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        payload = {"status": "error", "message": message, "data": data or {}}
+        if error:
+            payload["error"] = error
+        if guidance:
+            payload["guidance"] = guidance
+        return payload
+
+    def _fallback(
+        self,
+        action: str,
+        reason: str,
+        extra: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        return {
+            "status": "fallback",
+            "message": f"Import mode unavailable for '{action}'.",
+            "reason": reason,
+            "guidance": (
+                "Ensure repository source is present under the configured 'source' directory and "
+                "install required dependencies (numpy, scipy, matplotlib, packaging, pooch, tqdm). "
+                "If import still fails, use the CLI fallback via the 'mne' command."
+            ),
+            "data": extra or {},
+        }
+
+    # -------------------------------------------------------------------------
+    # Health / Introspection
+    # -------------------------------------------------------------------------
+    def health_check(self) -> Dict[str, Any]:
+        """
+        Report adapter readiness and import diagnostics.
+
+        Returns:
+            Dict with status, mode, import availability, and warning details.
+        """
+        return self._ok(
+            "Adapter health check completed.",
+            {
+                "mode": self.mode,
+                "available": self.available,
+                "loaded_modules": {k: bool(v) for k, v in self.modules.items()},
+                "warnings": self.warnings,
+            },
+        )
+
+    def list_known_packages(self) -> Dict[str, Any]:
+        """
+        Return package namespaces discovered during analysis.
+
+        Returns:
+            Dict containing analyzed package names for discovery/debugging.
+        """
+        packages = [
+            "deployment.mne-python.source",
+            "mcp_output.mcp_plugin",
+            "source.mne",
+            "source.mne._fiff",
+            "source.mne.beamformer",
+            "source.mne.channels",
+            "source.mne.commands",
+            "source.mne.data",
+            "source.mne.datasets",
+            "source.mne.decoding",
+            "source.mne.export",
+            "source.mne.forward",
+            "source.mne.gui",
+            "source.mne.html_templates",
+            "source.mne.inverse_sparse",
+            "source.mne.io",
+            "source.mne.minimum_norm",
+            "source.mne.preprocessing",
+            "source.mne.report",
+            "source.mne.simulation",
+            "source.mne.source_space",
+            "source.mne.stats",
+            "source.mne.tests",
+            "source.mne.time_frequency",
+            "source.mne.utils",
+            "source.mne.viz",
+        ]
+        return self._ok("Known package list prepared.", {"packages": packages})
+
+    # -------------------------------------------------------------------------
+    # Module management
+    # -------------------------------------------------------------------------
+    def import_module(self, module_path: str) -> Dict[str, Any]:
+        """
+        Dynamically import an MNE module using full package path.
+
+        Args:
+            module_path: Absolute module path (e.g., 'mne.io', 'mne.preprocessing').
+
+        Returns:
+            Unified status dictionary with module import result.
+        """
+        try:
+            mod = importlib.import_module(module_path)
+            self.modules[module_path] = mod
+            return self._ok("Module imported successfully.", {"module_path": module_path})
+        except Exception as exc:
+            return self._fail(
+                "Module import failed.",
+                error=str(exc),
+                guidance="Confirm module path and dependency installation.",
+                data={"module_path": module_path},
+            )
+
+    def get_module_attributes(self, module_path: str, limit: int = 200) -> Dict[str, Any]:
+        """
+        Enumerate public attributes for a module to support function discovery.
+
+        Args:
+            module_path: Full module path.
+            limit: Maximum number of attributes to return.
+
+        Returns:
+            Unified status dictionary containing exported attribute names.
+        """
+        try:
+            mod = self.modules.get(module_path) or importlib.import_module(module_path)
+            attrs = [a for a in dir(mod) if not a.startswith("_")]
+            return self._ok(
+                "Module attributes fetched.",
+                {"module_path": module_path, "attributes": attrs[: max(1, limit)]},
+            )
+        except Exception as exc:
+            return self._fail(
+                "Could not inspect module attributes.",
+                error=str(exc),
+                guidance="Import the module first and verify it is available in local source.",
+                data={"module_path": module_path},
+            )
+
+    # -------------------------------------------------------------------------
+    # Core MNE call surface
+    # -------------------------------------------------------------------------
+    def call_mne_function(self, function_name: str, *args: Any, **kwargs: Any) -> Dict[str, Any]:
+        """
+        Call a function from the top-level mne module by name.
+
+        Args:
+            function_name: Name of the function in module 'mne'.
+            *args: Positional arguments forwarded to the target function.
+            **kwargs: Keyword arguments forwarded to the target function.
+
+        Returns:
+            Unified status dictionary with execution result or actionable failure.
+        """
+        if not self.modules.get("mne"):
+            return self._fallback("call_mne_function", "Top-level module 'mne' is not importable.")
+
+        try:
+            target = getattr(self.modules["mne"], function_name, None)
+            if target is None or not callable(target):
+                return self._fail(
+                    "Requested MNE function was not found.",
+                    guidance="Use get_module_attributes('mne') to discover available callables.",
+                    data={"function_name": function_name},
+                )
+            result = target(*args, **kwargs)
+            return self._ok(
+                "MNE function executed successfully.",
+                {"function_name": function_name, "result": result},
+            )
+        except Exception as exc:
+            return self._fail(
+                "MNE function execution failed.",
+                error=str(exc),
+                guidance="Validate function arguments and data formats expected by MNE.",
+                data={"function_name": function_name, "traceback": traceback.format_exc()},
+            )
+
+    # -------------------------------------------------------------------------
+    # CLI wrapper (fallback-friendly)
+    # -------------------------------------------------------------------------
+    def call_mne_cli(self, argv: Optional[List[str]] = None) -> Dict[str, Any]:
+        """
+        Execute the primary MNE command-line wrapper from imported command module.
+
+        Args:
+            argv: Optional list of CLI-like arguments. If omitted, attempts default call.
+
+        Returns:
+            Unified status dictionary with invocation status and hints.
+        """
+        commands_mod = self.modules.get("commands")
+        if not commands_mod:
+            return self._fallback("call_mne_cli", "Module 'mne.commands' is not importable.")
+
+        try:
+            entry_candidates = ["main", "run", "command_main"]
+            entry = None
+            for name in entry_candidates:
+                fn = getattr(commands_mod, name, None)
+                if callable(fn):
+                    entry = fn
+                    break
+
+            if entry is None:
+                return self._fail(
+                    "No callable CLI entry point found in mne.commands.",
+                    guidance="Inspect mne.commands module attributes and map the correct callable.",
+                    data={"checked_candidates": entry_candidates},
+                )
+
+            if argv is None:
+                out = entry()
+            else:
+                out = entry(argv)
+
+            return self._ok(
+                "MNE CLI wrapper executed.",
+                {"argv": argv or [], "result": out, "entry_point": entry.__name__},
+            )
+        except TypeError:
+            try:
+                out = entry()  # type: ignore[misc]
+                return self._ok(
+                    "MNE CLI wrapper executed with default signature.",
+                    {"argv": argv or [], "result": out, "entry_point": entry.__name__},  # type: ignore[union-attr]
+                )
+            except Exception as exc:
+                return self._fail(
+                    "MNE CLI invocation failed.",
+                    error=str(exc),
+                    guidance="Pass valid subcommands/arguments or verify command module compatibility.",
+                    data={"traceback": traceback.format_exc()},
+                )
+        except Exception as exc:
+            return self._fail(
+                "MNE CLI invocation failed.",
+                error=str(exc),
+                guidance="Check installed optional dependencies and command arguments.",
+                data={"traceback": traceback.format_exc()},
+            )
+
+    # -------------------------------------------------------------------------
+    # Class instantiation helper (generic, analysis-driven)
+    # -------------------------------------------------------------------------
+    def create_instance(
+        self,
+        module_path: str,
+        class_name: str,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        """
+        Instantiate a class from a target module path.
+
+        Args:
+            module_path: Full module path containing the class.
+            class_name: Class name to instantiate.
+            *args: Positional constructor arguments.
+            **kwargs: Keyword constructor arguments.
+
+        Returns:
+            Unified status dictionary with instantiated object handle.
+        """
+        try:
+            mod = self.modules.get(module_path) or importlib.import_module(module_path)
+            cls = getattr(mod, class_name, None)
+            if cls is None:
+                return self._fail(
+                    "Class not found in module.",
+                    guidance="Use get_module_attributes(module_path) to verify class exports.",
+                    data={"module_path": module_path, "class_name": class_name},
+                )
+            instance = cls(*args, **kwargs)
+            return self._ok(
+                "Class instantiated successfully.",
+                {"module_path": module_path, "class_name": class_name, "instance": instance},
+            )
+        except Exception as exc:
+            return self._fail(
+                "Class instantiation failed.",
+                error=str(exc),
+                guidance="Verify constructor arguments and required dependencies for this class.",
+                data={"module_path": module_path, "class_name": class_name, "traceback": traceback.format_exc()},
+            )

mne-python/mcp_output/mcp_plugin/main.py

@@ -0,0 +1,13 @@
+"""
+MCP Service Auto-Wrapper - Auto-generated
+"""
+from mcp_service import create_app
+
+def main():
+    """Main entry point"""
+    app = create_app()
+    return app
+
+if __name__ == "__main__":
+    app = main()
+    app.run()

mne-python/mcp_output/mcp_plugin/mcp_service.py

@@ -0,0 +1,215 @@
+import os
+import sys
+from typing import Optional, Dict, Any, List
+
+source_path = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
+    "source",
+)
+if source_path not in sys.path:
+    sys.path.insert(0, source_path)
+
+from fastmcp import FastMCP
+
+mcp = FastMCP("mne_python_service")
+
+
+def _safe_import_mne():
+    try:
+        import mne  # type: ignore
+        return True, mne, None
+    except Exception as exc:
+        return False, None, str(exc)
+
+
+@mcp.tool(name="mne_get_version", description="Get installed MNE version information.")
+def mne_get_version() -> Dict[str, Any]:
+    """
+    Return MNE package version.
+
+    Returns:
+        Dict with:
+        - success: bool indicating operation status
+        - result: version string when successful
+        - error: error string when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        version = getattr(mne_mod, "__version__", "unknown")
+        return {"success": True, "result": version, "error": None}
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+@mcp.tool(name="mne_get_config", description="Read MNE configuration value by key.")
+def mne_get_config(key: str, default: Optional[str] = None) -> Dict[str, Any]:
+    """
+    Read a single MNE config key.
+
+    Parameters:
+        key: Configuration key to lookup.
+        default: Optional fallback if key is not found.
+
+    Returns:
+        Dict with:
+        - success: bool
+        - result: config value
+        - error: error message when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        value = mne_mod.get_config(key=key, default=default)
+        return {"success": True, "result": value, "error": None}
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+@mcp.tool(name="mne_set_config", description="Set an MNE configuration key to a value.")
+def mne_set_config(key: str, value: str, set_env: bool = False) -> Dict[str, Any]:
+    """
+    Set a single MNE config key.
+
+    Parameters:
+        key: Configuration key.
+        value: Configuration value.
+        set_env: If True, also set environment variable for current process.
+
+    Returns:
+        Dict with:
+        - success: bool
+        - result: True when set successfully
+        - error: error message when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        mne_mod.set_config(key=key, value=value, set_env=set_env)
+        return {"success": True, "result": True, "error": None}
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+@mcp.tool(name="mne_create_info", description="Create an MNE Info object from channels and sampling frequency.")
+def mne_create_info(ch_names: List[str], sfreq: float, ch_types: Optional[List[str]] = None) -> Dict[str, Any]:
+    """
+    Create a lightweight channel metadata structure.
+
+    Parameters:
+        ch_names: List of channel names.
+        sfreq: Sampling frequency in Hz.
+        ch_types: Optional list of channel types aligned with ch_names.
+
+    Returns:
+        Dict with:
+        - success: bool
+        - result: serializable summary of created Info
+        - error: error message when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        info = mne_mod.create_info(ch_names=ch_names, sfreq=sfreq, ch_types=ch_types)
+        result = {
+            "nchan": int(info["nchan"]),
+            "sfreq": float(info["sfreq"]),
+            "ch_names": list(info["ch_names"]),
+            "highpass": float(info.get("highpass", 0.0) or 0.0),
+            "lowpass": float(info.get("lowpass", 0.0) or 0.0),
+        }
+        return {"success": True, "result": result, "error": None}
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+@mcp.tool(name="mne_compute_events", description="Detect events from a stim channel in a raw FIF file.")
+def mne_compute_events(
+    raw_fif_path: str,
+    stim_channel: Optional[str] = None,
+    shortest_event: int = 1,
+    min_duration: float = 0.0,
+) -> Dict[str, Any]:
+    """
+    Load raw FIF and compute events from stimulation channel.
+
+    Parameters:
+        raw_fif_path: Path to a readable raw FIF file.
+        stim_channel: Optional stim channel name. If None, MNE default detection is used.
+        shortest_event: Minimum number of samples for an event.
+        min_duration: Minimum event duration in seconds.
+
+    Returns:
+        Dict with:
+        - success: bool
+        - result: event count and preview rows
+        - error: error message when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        raw = mne_mod.io.read_raw_fif(raw_fif_path, preload=False, verbose=False)
+        events = mne_mod.find_events(
+            raw,
+            stim_channel=stim_channel,
+            shortest_event=shortest_event,
+            min_duration=min_duration,
+            verbose=False,
+        )
+        preview = events[:20].tolist() if len(events) > 0 else []
+        return {
+            "success": True,
+            "result": {"count": int(len(events)), "preview": preview},
+            "error": None,
+        }
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+@mcp.tool(name="mne_estimate_rank", description="Estimate data rank from an epochs or raw FIF file.")
+def mne_estimate_rank(fif_path: str, tol: Optional[float] = None) -> Dict[str, Any]:
+    """
+    Estimate numerical rank from MNE data object loaded from FIF.
+
+    Parameters:
+        fif_path: Path to raw or epochs FIF file.
+        tol: Optional tolerance passed to rank estimator.
+
+    Returns:
+        Dict with:
+        - success: bool
+        - result: estimated rank dictionary or scalar
+        - error: error message when failed
+    """
+    ok, mne_mod, err = _safe_import_mne()
+    if not ok:
+        return {"success": False, "result": None, "error": err}
+    try:
+        result_obj: Any
+        try:
+            raw = mne_mod.io.read_raw_fif(fif_path, preload=False, verbose=False)
+            result_obj = mne_mod.compute_rank(raw, tol=tol, verbose=False)
+        except Exception:
+            epochs = mne_mod.read_epochs(fif_path, preload=False, verbose=False)
+            result_obj = mne_mod.compute_rank(epochs, tol=tol, verbose=False)
+
+        if isinstance(result_obj, dict):
+            serializable = {str(k): int(v) for k, v in result_obj.items()}
+        else:
+            serializable = int(result_obj)
+        return {"success": True, "result": serializable, "error": None}
+    except Exception as exc:
+        return {"success": False, "result": None, "error": str(exc)}
+
+
+def create_app() -> FastMCP:
+    return mcp
+
+
+if __name__ == "__main__":
+    mcp.run()

mne-python/mcp_output/requirements.txt

@@ -0,0 +1,16 @@
+fastmcp
+fastapi
+uvicorn[standard]
+pydantic>=2.0.0
+decorator >= 5.1
+jinja2 >= 3.1
+lazy_loader >= 0.3
+matplotlib >= 3.8
+numpy >= 1.26, < 3
+packaging
+pooch >= 1.5
+scipy >= 1.12
+tqdm >= 4.66
+nest-asyncio2
+pymef
+pyobjc-framework-Cocoa >=5.2.0;platform_system=='Darwin'

mne-python/mcp_output/start_mcp.py

@@ -0,0 +1,30 @@
+
+"""
+MCP Service Startup Entry
+"""
+import sys
+import os
+
+project_root = os.path.dirname(os.path.abspath(__file__))
+mcp_plugin_dir = os.path.join(project_root, "mcp_plugin")
+if mcp_plugin_dir not in sys.path:
+    sys.path.insert(0, mcp_plugin_dir)
+
+from mcp_service import create_app
+
+def main():
+    """Start FastMCP service"""
+    app = create_app()
+    # Use environment variable to configure port, default 8000
+    port = int(os.environ.get("MCP_PORT", "8000"))
+    
+    # Choose transport mode based on environment variable
+    transport = os.environ.get("MCP_TRANSPORT", "stdio")
+    if transport == "http":
+        app.run(transport="http", host="0.0.0.0", port=port)
+    else:
+        # Default to STDIO mode
+        app.run()
+
+if __name__ == "__main__":
+    main()

mne-python/mcp_output/workflow_summary.json

@@ -0,0 +1,253 @@
+{
+  "repository": {
+    "name": "mne-python",
+    "url": "https://github.com/mne-tools/mne-python",
+    "local_path": "/Users/ghh/Documents/Code/Code2MCP-private/workspace/mne-python",
+    "description": "Python library",
+    "features": "Basic functionality",
+    "tech_stack": "Python",
+    "stars": 0,
+    "forks": 0,
+    "language": "Python",
+    "last_updated": "",
+    "complexity": "complex",
+    "intrusiveness_risk": "medium"
+  },
+  "execution": {
+    "start_time": 1773461253.309027,
+    "end_time": 1773462216.903234,
+    "duration": 963.5942070484161,
+    "status": "success",
+    "workflow_status": "success",
+    "nodes_executed": [
+      "download",
+      "analysis",
+      "env",
+      "generate",
+      "run",
+      "review",
+      "finalize"
+    ],
+    "total_files_processed": 26,
+    "environment_type": "unknown",
+    "llm_calls": 0,
+    "deepwiki_calls": 0
+  },
+  "tests": {
+    "original_project": {
+      "passed": false,
+      "details": {},
+      "test_coverage": "100%",
+      "execution_time": 0,
+      "test_files": []
+    },
+    "mcp_plugin": {
+      "passed": true,
+      "details": {},
+      "service_health": "healthy",
+      "startup_time": 0,
+      "transport_mode": "stdio",
+      "fastmcp_version": "unknown",
+      "mcp_version": "unknown"
+    }
+  },
+  "analysis": {
+    "structure": {
+      "packages": [
+        "deployment.mne-python.source",
+        "mcp_output.mcp_plugin",
+        "source.mne",
+        "source.mne._fiff",
+        "source.mne.beamformer",
+        "source.mne.channels",
+        "source.mne.commands",
+        "source.mne.data",
+        "source.mne.datasets",
+        "source.mne.decoding",
+        "source.mne.export",
+        "source.mne.forward",
+        "source.mne.gui",
+        "source.mne.html_templates",
+        "source.mne.inverse_sparse",
+        "source.mne.io",
+        "source.mne.minimum_norm",
+        "source.mne.preprocessing",
+        "source.mne.report",
+        "source.mne.simulation",
+        "source.mne.source_space",
+        "source.mne.stats",
+        "source.mne.tests",
+        "source.mne.time_frequency",
+        "source.mne.utils",
+        "source.mne.viz"
+      ]
+    },
+    "dependencies": {
+      "has_environment_yml": true,
+      "has_requirements_txt": false,
+      "pyproject": true,
+      "setup_cfg": false,
+      "setup_py": false
+    },
+    "entry_points": {
+      "imports": [],
+      "cli": [],
+      "modules": []
+    },
+    "risk_assessment": {
+      "import_feasibility": 0.72,
+      "intrusiveness_risk": "medium",
+      "complexity": "complex"
+    },
+    "deepwiki_analysis": {
+      "repo_url": "https://github.com/mne-tools/mne-python",
+      "repo_name": "mne-python",
+      "error": "DeepWiki analysis failed",
+      "model": "gpt-5.3-codex",
+      "source": "llm_direct_analysis",
+      "success": false
+    },
+    "code_complexity": {
+      "cyclomatic_complexity": "medium",
+      "cognitive_complexity": "medium",
+      "maintainability_index": 75
+    },
+    "security_analysis": {
+      "vulnerabilities_found": 0,
+      "security_score": 85,
+      "recommendations": []
+    }
+  },
+  "plugin_generation": {
+    "files_created": [
+      "mcp_output/start_mcp.py",
+      "mcp_output/mcp_plugin/__init__.py",
+      "mcp_output/mcp_plugin/mcp_service.py",
+      "mcp_output/mcp_plugin/adapter.py",
+      "mcp_output/mcp_plugin/main.py",
+      "mcp_output/requirements.txt",
+      "mcp_output/README_MCP.md"
+    ],
+    "main_entry": "start_mcp.py",
+    "requirements": [
+      "fastmcp>=0.1.0",
+      "pydantic>=2.0.0"
+    ],
+    "readme_path": "/Users/ghh/Documents/Code/Code2MCP-private/workspace/mne-python/mcp_output/README_MCP.md",
+    "adapter_mode": "import",
+    "total_lines_of_code": 0,
+    "generated_files_size": 0,
+    "tool_endpoints": 0,
+    "supported_features": [
+      "Basic functionality"
+    ],
+    "generated_tools": [
+      "Basic tools",
+      "Health check tools",
+      "Version info tools"
+    ]
+  },
+  "code_review": {},
+  "errors": [],
+  "warnings": [],
+  "recommendations": [
+    "Harden repository ingestion with retry/resume and fallback to shallow git clone when zip download fails",
+    "Add a preflight dependency checker that validates required/optional MNE extras and reports actionable install commands",
+    "Implement lazy imports and per-endpoint module loading to reduce startup cost and import-side failures",
+    "Add a CLI fallback execution path for heavy/fragile endpoints (especially viz and large IO) when import mode errors",
+    "Introduce endpoint-level health checks/smoke tests using small synthetic MNE objects (RawArray/Epochs) to validate MCP bindings",
+    "Expand automated tests in `tests_mcp` for argument validation",
+    "error mapping",
+    "and serialization of core classes",
+    "Add structured error taxonomy (DependencyMissing",
+    "FileFormatUnsupported",
+    "RuntimeImportError",
+    "HeadlessVizError) with user-friendly remediation hints",
+    "Gate visualization endpoints behind headless-safe checks (matplotlib backend/PyVista availability) and return clear non-GUI alternatives",
+    "Improve README_MCP with concrete examples for common workflows (load raw",
+    "find events",
+    "ICA",
+    "PSD) and expected input/output schemas",
+    "Add version pinning/compatibility matrix for `mne`",
+    "`numpy`",
+    "`scipy`",
+    "and `pydantic` to prevent runtime drift",
+    "Generate JSON Schemas for each endpoint and enforce strict Pydantic models for stable MCP contracts",
+    "Add timeout/cancellation controls and memory guards for long-running transforms (TFR/ICA/CSD)",
+    "Implement lightweight caching for repeated file reads and computed intermediates (with invalidation by file hash)",
+    "Add observability: structured logs",
+    "per-endpoint latency/error metrics",
+    "and import-failure counters",
+    "Create a minimal “safe default” endpoint set (non-viz",
+    "low-memory) and mark advanced endpoints as optional capability flags",
+    "Add integration tests for representative file formats (FIF/EDF/BDF/BrainVision) with tiny fixtures",
+    "Validate and normalize path handling across OSes (spaces",
+    "unicode",
+    "relative paths) before IO calls",
+    "Add graceful degradation when optional packages are missing (e.g.",
+    "skip vtk/pyvista features instead of failing server start)",
+    "Include a reproducible dev environment (`environment.yml`/lockfile) for MCP plugin CI",
+    "Add CI workflow to run lint/type-check/tests for `mcp_output` and publish test report artifacts"
+  ],
+  "performance_metrics": {
+    "memory_usage_mb": 0,
+    "cpu_usage_percent": 0,
+    "response_time_ms": 0,
+    "throughput_requests_per_second": 0
+  },
+  "deployment_info": {
+    "supported_platforms": [
+      "Linux",
+      "Windows",
+      "macOS"
+    ],
+    "python_versions": [
+      "3.8",
+      "3.9",
+      "3.10",
+      "3.11",
+      "3.12"
+    ],
+    "deployment_methods": [
+      "Docker",
+      "pip",
+      "conda"
+    ],
+    "monitoring_support": true,
+    "logging_configuration": "structured"
+  },
+  "execution_analysis": {
+    "success_factors": [
+      "Workflow reached terminal success state with all planned nodes executed (download, analysis, env, generate, run, review, finalize)",
+      "MCP plugin runtime test passed with healthy service status over stdio transport",
+      "Import-based adapter strategy aligned with detected MNE API surface and produced broad endpoint coverage",
+      "No runtime errors or warnings were recorded during orchestration"
+    ],
+    "failure_reasons": [
+      "Repository preprocessing partially failed due to zip download IncompleteRead, reducing analysis fidelity",
+      "DeepWiki analysis failed, so architecture/context enrichment depended on fallback LLM direct analysis",
+      "Original project test status is failed/unknown despite reported 100% coverage metadata, indicating unreliable baseline validation",
+      "Generated artifact metrics are inconsistent (tool_endpoints=0 vs populated endpoint list; total_lines_of_code=0), suggesting reporting/telemetry defects"
+    ],
+    "overall_assessment": "good",
+    "node_performance": {
+      "download_time": "Download node completed but experienced non-fatal zip transfer instability (IncompleteRead). This is the primary execution fragility.",
+      "analysis_time": "Analysis completed via fallback path; quality adequate for generation but lower confidence than full repository preprocessing + DeepWiki.",
+      "generation_time": "Generation completed successfully with required files and entrypoint created; endpoint exposure is broad and useful.",
+      "test_time": "Service-level test passed quickly (startup_time reported 0), but original-project validation is not trustworthy; test depth appears shallow."
+    },
+    "resource_usage": {
+      "memory_efficiency": "Undetermined from metrics (reported 0 MB). Likely acceptable for scaffold generation, but runtime memory for heavy MNE ops remains unmeasured.",
+      "cpu_efficiency": "Undetermined from metrics (reported 0%). End-to-end duration (~964s) indicates non-trivial processing overhead and potential I/O/network wait.",
+      "disk_usage": "Generated output footprint appears underreported (0 size), indicating instrumentation gaps rather than true zero disk impact."
+    }
+  },
+  "technical_quality": {
+    "code_quality_score": 74,
+    "architecture_score": 78,
+    "performance_score": 62,
+    "maintainability_score": 76,
+    "security_score": 85,
+    "scalability_score": 68
+  }
+}

mne-python/source/.circleci/config.yml

@@ -0,0 +1,570 @@
+# By default, for PRs CircleCI will build only examples that have changed.
+# For main commits, builds are skipped entirely, as we only do full builds
+# scheduled for one time daily.
+#
+# Tagging a commit with the following overrides these behaviors:
+# - [circle front] will run the front page examples and perform test-doc
+# - [circle full] will run all examples and perform test-doc
+# - [circle linkcheck] will run our linkcheck job
+# - [circle deploy] on a main or maint/* commit will try to immediately build
+#   and deploy docs rather than waiting for the nightly build
+
+version: 2.1
+
+_check_skip: &check_skip
+  name: Check-skip
+  command: |
+    set -e
+    export COMMIT_MESSAGE=$(git log --format=oneline -n 1);
+    if [[ "$CIRCLE_PULL_REQUEST" != "" ]] && ([[ "$COMMIT_MESSAGE" == *"[skip circle]"* ]] || [[ "$COMMIT_MESSAGE" == *"[circle skip]"* ]]); then
+      echo "Skip detected, exiting job ${CIRCLE_JOB} for PR ${CIRCLE_PULL_REQUEST}."
+      circleci-agent step halt;
+    fi
+
+jobs:
+  build_docs:
+    parameters:
+      scheduled:
+        type: string
+        default: "false"
+    machine:
+      image: ubuntu-2404:current
+    # large 4 vCPUs 15GB mem
+    # https://discuss.circleci.com/t/changes-to-remote-docker-reporting-pricing/47759
+    resource_class: large
+    steps:
+      - restore_cache:
+          keys:
+            - source-cache
+      - checkout:
+          method: full
+      - run:
+          name: Complete checkout
+          command: |
+            set -e
+            if ! git remote -v | grep upstream; then
+              git remote add upstream https://github.com/mne-tools/mne-python.git
+            fi
+            git remote set-url upstream https://github.com/mne-tools/mne-python.git
+            git fetch upstream
+      - save_cache:
+          key: source-cache
+          paths:
+            - ".git"
+      - run:
+          <<: *check_skip
+      - run:
+          name: Merge with upstream and triage run
+          command: |
+            set -e
+            echo $(git log -1 --pretty=%B) | tee gitlog.txt
+            echo ${CI_PULL_REQUEST//*pull\//} | tee merge.txt
+            if [[ $(cat merge.txt) != "" ]]; then
+              echo "Merging $(cat merge.txt)";
+              git pull --ff-only upstream "refs/pull/$(cat merge.txt)/merge";
+            else
+              if [[ "$CIRCLE_BRANCH" == "main" ]]; then
+                KIND=dev
+              else
+                KIND=stable
+              fi
+              export COMMIT_MESSAGE=$(git log --format=oneline -n 1);
+              if [[ "<< parameters.scheduled >>" == "true" ]]; then
+                echo "Scheduled full build detected, checking if it's required."
+                wget https://mne.tools/${KIND}/_version.txt;
+                REMOTE_VERSION=$(cat _version.txt)
+                THIS_VERSION=$(git rev-parse HEAD)
+                echo "Current ${KIND} SHA: ${REMOTE_VERSION}"
+                echo "This    ${KIND} SHA: ${THIS_VERSION}"
+                if [[ "${THIS_VERSION}" != "${REMOTE_VERSION}" ]]; then
+                  echo "Rebuild required."
+                else
+                  echo "Rebuild skipped."
+                  circleci-agent step halt;
+                fi
+              elif [[ "$COMMIT_MESSAGE" == *"[circle deploy]"* ]]; then
+                echo "Forced deployed build detected, building and deploying docs";
+              else
+                echo "Waiting until scheduled run to build ${KIND} docs, exiting job ${CIRCLE_JOB}."
+                circleci-agent step halt;
+              fi
+            fi
+
+      - run:
+          name: Set BASH_ENV
+          command: ./tools/circleci_bash_env.sh
+
+      - run:
+          name: Install fonts needed for diagrams
+          command: |
+            mkdir -p $HOME/.fonts
+            echo "Source Code Pro"
+            curl https://codeload.github.com/adobe-fonts/source-code-pro/tar.gz/2.038R-ro/1.058R-it/1.018R-VAR | tar xz -C $HOME/.fonts
+            echo "Source Sans Pro"
+            curl https://codeload.github.com/adobe-fonts/source-sans/tar.gz/3.028R | tar xz -C $HOME/.fonts
+            fc-cache -f
+
+      # Load pip cache
+      - restore_cache:
+          keys:
+            - pip-cache-0
+      - restore_cache:
+          keys:
+            - user-install-bin-cache-310
+
+      # Hack in uninstalls of libraries as necessary if pip doesn't do the right thing in upgrading for us...
+      - run:
+          name: Get Python running
+          command: |
+            ./tools/circleci_dependencies.sh
+
+      - save_cache:
+          key: pip-cache-0
+          paths:
+            - ~/.cache/pip
+      - save_cache:
+          key: user-install-bin-cache-310
+          paths:
+            - ~/.local/lib/python3.10/site-packages
+            - ~/.local/bin
+
+      - run:
+          name: Check Qt
+          command: |
+            ./tools/check_qt_import.sh PyQt6
+      # Load tiny cache so that ~/.mne does not need to be created below
+      - restore_cache:
+          keys:
+            - data-cache-tiny-0
+
+      # Look at what we have and fail early if there is some library conflict
+      - run:
+          name: Check installation
+          command: |
+              which python
+              QT_DEBUG_PLUGINS=1 mne sys_info -pd
+              python -c "import numpy; numpy.show_config()"
+              python -c "import dipy.align.metrics"
+              LIBGL_DEBUG=verbose python -c "import pyvistaqt; pyvistaqt.BackgroundPlotter(show=True)"
+              python -c "import mne; mne.set_config('MNE_USE_CUDA', 'false')"  # this is needed for the config tutorial
+              python -c "import mne; mne.set_config('MNE_LOGGING_LEVEL', 'info')"
+              python -c "import mne; level = mne.get_config('MNE_LOGGING_LEVEL'); assert level.lower() == 'info', repr(level)"
+      - run:
+          name: List packages
+          command: python -m pip list
+
+      # Figure out if we should run a full build or specify a pattern
+      - restore_cache:
+          keys:
+            - data-cache-tiny-1
+      - restore_cache:
+          keys:
+            - data-cache-multimodal
+      - restore_cache:
+          keys:
+            - data-cache-limo
+      - restore_cache:
+          keys:
+            - data-cache-fsaverage
+      - restore_cache:
+          keys:
+            - data-cache-bst-raw
+      - restore_cache:
+          keys:
+            - data-cache-bst-phantom-ctf
+      - restore_cache:
+          keys:
+            - data-cache-bst-phantom-elekta
+      - restore_cache:
+          keys:
+            - data-cache-bst-phantom-kernel
+      - restore_cache:
+          keys:
+            - data-cache-bst-auditory
+      - restore_cache:
+          keys:
+            - data-cache-bst-resting
+      - restore_cache:
+          keys:
+            - data-cache-fieldtrip
+      - restore_cache:
+          keys:
+            - data-cache-somato
+      - restore_cache:
+          keys:
+            - data-cache-hf-sef
+      - restore_cache:
+          keys:
+            - data-cache-opm
+      - restore_cache:
+          keys:
+            - data-cache-sample
+      - restore_cache:
+          keys:
+            - data-cache-spm-face
+      - restore_cache:
+          keys:
+            - data-cache-testing
+      - restore_cache:
+          keys:
+            - data-cache-visual
+      - restore_cache:
+          keys:
+            - data-cache-ucl-opm-auditory
+      - restore_cache:
+          keys:
+            - data-cache-phantom-kit
+      - restore_cache:
+          keys:
+            - data-cache-ds004388
+      - run:
+          name: Get data
+          # This limit could be increased, but this is helpful for finding slow ones
+          # (even ~2GB datasets should be downloadable in this time from good
+          # providers)
+          no_output_timeout: 10m
+          command: |
+            ./tools/circleci_download.sh
+      - run:
+          name: Verify build type
+          command: |
+            echo "PATTERN=$(cat pattern.txt)"
+            echo "BUILD=$(cat build.txt)"
+            ls -al ~/mne_data;
+
+      # Run doctest (if it's full or front) before building the docs
+      - run:
+          name: make test-doc
+          command: |
+            if [[ $(cat gitlog.txt) == *"[circle front]"* ]] || [[ $(cat build.txt) == "html-memory" ]] ; then
+              make test-doc;
+              mkdir -p doc/_build/test-results/test-doc;
+              cp junit-results.xml doc/_build/test-results/test-doc/junit.xml;
+              cp coverage.xml doc/_build/test-results/test-doc/coverage.xml;
+            fi;
+      # Build docs
+      - run:
+          name: make html
+          command: |  # we have -o pipefail in #BASH_ENV so we should be okay
+            set -x
+            PATTERN=$(cat pattern.txt) make -C doc $(cat build.txt) 2>&1 | tee sphinx_log.txt
+      - run:
+          name: Check sphinx log for warnings (which are treated as errors)
+          when: always
+          command: |
+            ! grep "^.*\(WARNING\|ERROR\): " sphinx_log.txt
+      - run:
+          name: Show profiling output
+          when: always
+          command: |
+            if compgen -G "doc/*.dat" > /dev/null; then
+              mkdir -p doc/generated
+              mprof plot doc/*.dat --output doc/generated/memory.png
+            else
+              echo "No profile data found in doc/"
+            fi
+      - run:
+          name: Sanity check system state
+          command: |
+            python -c "import mne; level = mne.get_config('MNE_LOGGING_LEVEL'); assert level.lower() == 'info', repr(level)"
+
+      # Reduce upload time of artifacts we will (almost) never look at
+      - run:
+          name: Reduce artifact upload time
+          command: |
+            if grep -q html-pattern-memory build.txt; then
+              zip -rm doc/_build/html/_downloads.zip doc/_build/html/_downloads
+            fi
+            for NAME in generated auto_tutorials auto_examples; do
+              zip -rm doc/${NAME}.zip doc/${NAME}
+            done
+
+      # Save the JUnit file
+      - store_test_results:
+          path: doc/_build/test-results
+      - store_artifacts:
+          path: doc/_build/test-results
+          destination: test-results
+      # Upload test results to Codecov
+      - run:
+          name: Upload test results to Codecov
+          environment:
+            CODECOV_TOKEN: fb4c4a94-72d7-4743-bb08-af25b623a29a
+          command: |
+            if [[ -f doc/_build/test-results/test-doc/coverage.xml ]]; then
+              bash <(curl -s https://codecov.io/bash) -f doc/_build/test-results/test-doc/coverage.xml || true
+            fi
+      # Save the SG RST
+      - store_artifacts:
+          path: doc/auto_examples.zip
+      - store_artifacts:
+          path: doc/auto_tutorials.zip
+      - store_artifacts:
+          path: doc/generated.zip
+      # Save the HTML
+      - store_artifacts:
+          path: doc/_build/html/
+          destination: html
+      - persist_to_workspace:
+          root: doc/_build
+          paths:
+            - html
+
+      # Keep these separate, maybe better in terms of size limitations (?)
+      - save_cache:
+          key: data-cache-tiny-0  # < 100 M, might as well combine
+          paths:
+            - ~/.mne
+            - ~/mne_data/MNE-kiloword-data  # (28 M)
+            - ~/mne_data/MNE-eegbci-data  # (35 M)
+            - ~/mne_data/MNE-misc-data  # (39 M)
+            - ~/mne_data/mTRF_1.5  # (56 M)
+            - ~/mne_data/MNE-phantom-4DBTi  # (77 M)
+      - save_cache:
+          key: data-cache-tiny-1  # more to combine
+          paths:
+            - ~/mne_data/MNE-fNIRS-motor-data  # (71 M)
+            - ~/mne_data/MNE-refmeg-noise-data  # (93 M)
+            - ~/mne_data/physionet-sleep-data  # (95 M)
+      - save_cache:
+          key: data-cache-multimodal
+          paths:
+            - ~/mne_data/MNE-multimodal-data  # (240 M)
+      - save_cache:
+          key: data-cache-limo
+          paths:
+            - ~/mne_data/MNE-limo-data  # (244 M)
+      - save_cache:
+          key: data-cache-fsaverage
+          paths:
+            - ~/mne_data/MNE-fsaverage-data  # (762 M)
+      - save_cache:
+          key: data-cache-bst-raw
+          paths:
+            - ~/mne_data/MNE-brainstorm-data/bst_raw  # (830 M)
+      - save_cache:
+          key: data-cache-bst-phantom-ctf
+          paths:
+            - ~/mne_data/MNE-brainstorm-data/bst_phantom_ctf  # (177 M)
+      - save_cache:
+          key: data-cache-bst-phantom-elekta
+          paths:
+            - ~/mne_data/MNE-brainstorm-data/bst_phantom_elekta  # (1.4 G)
+      - save_cache:
+          key: data-cache-bst-phantom-kernel
+          paths:
+            - ~/mne_data/MNE-phantom-kernel-data  # (362 M)
+      - save_cache:
+          key: data-cache-bst-auditory
+          paths:
+            - ~/mne_data/MNE-brainstorm-data/bst_auditory  # (2.9 G)
+      - save_cache:
+          key: data-cache-bst-resting
+          paths:
+            - ~/mne_data/MNE-brainstorm-data/bst_resting  # (4.5 G)
+      - save_cache:
+          key: data-cache-fieldtrip
+          paths:
+            - ~/mne_data/MNE-fieldtrip_cmc-data  # (699 M)
+      - save_cache:
+          key: data-cache-somato
+          paths:
+            - ~/mne_data/MNE-somato-data  # (750 M)
+      - save_cache:
+          key: data-cache-hf-sef
+          paths:
+            - ~/mne_data/HF_SEF  # (1.3 G)
+      - save_cache:
+          key: data-cache-opm
+          paths:
+            - ~/mne_data/MNE-OPM-data  # (1.9 G)
+      - save_cache:
+          key: data-cache-sample
+          paths:
+            - ~/mne_data/MNE-sample-data  # (3.2 G)
+      - save_cache:
+          key: data-cache-spm-face
+          paths:
+            - ~/mne_data/MNE-spm-face  # (1.5 G)
+      - save_cache:
+          key: data-cache-testing
+          paths:
+            - ~/mne_data/MNE-testing-data  # (2.5 G)
+      - save_cache:
+          key: data-cache-visual
+          paths:
+            - ~/mne_data/MNE-visual_92_categories-data  # (6 G)
+      - save_cache:
+          key: data-cache-ucl-opm-auditory
+          paths:
+            - ~/mne_data/auditory_OPM_stationary  # (4 G)
+      - save_cache:
+          key: data-cache-phantom-kit
+          paths:
+            - ~/mne_data/MNE-phantom-KIT-data  # (1 G)
+      - save_cache:
+          key: data-cache-ds004388
+          paths:
+            - ~/mne_data/ds004388  # (1.8 G)
+
+
+  linkcheck:
+    # there are a few files excluded from this for expediency, see Makefile
+    parameters:
+      scheduled:
+        type: string
+        default: "false"
+    machine:
+      image: ubuntu-2404:current
+    resource_class: large
+    steps:
+      - restore_cache:
+          keys:
+            - source-cache
+      - checkout
+      - run:
+          name: Check-skip
+          command: |
+            export COMMIT_MESSAGE=$(git log --format=oneline -n 1);
+            if [[ "$COMMIT_MESSAGE" != *"[circle linkcheck]"* ]] && [ "<< parameters.scheduled >>" != "true" ]; then
+              echo "Skip detected, exiting job ${CIRCLE_JOB}."
+              circleci-agent step halt;
+            fi
+      - run:
+          name: Set BASH_ENV
+          command: ./tools/circleci_bash_env.sh
+      - restore_cache:
+          keys:
+            - pip-cache-0
+      - run:
+          name: Get Python running
+          command: |
+            ./tools/circleci_dependencies.sh
+      - run:
+          name: Check installation
+          command: |
+            mne sys_info -pd
+      - run:
+          name: make linkcheck
+          no_output_timeout: 40m
+          command: |
+            make -C doc linkcheck
+      - store_artifacts:
+          path: doc/_build/linkcheck
+          destination: linkcheck
+
+
+  deploy:
+    machine:
+      image: ubuntu-2404:current
+    steps:
+      - attach_workspace:
+          at: /tmp/build
+      - restore_cache:
+          keys:
+            - website-cache-1
+      - add_ssh_keys:
+          fingerprints:
+            # SHA256:N4qvp6MSbXcTz/27xz96VPsNuTDRT92zoRP8EW0I/8I
+            - "19:fe:1d:c3:c7:af:7e:16:94:4c:e1:e7:0a:56:13:bd"
+      - run:
+          name: Set BASH_ENV
+          command: |
+            set -e
+            echo "set -e" >> $BASH_ENV
+      # Don't try to deploy if nothing is there or not on the right branch
+      - run:
+          name: Check docs
+          command: |
+            if [ ! -f /tmp/build/html/index.html ] ; then
+              echo "No files found to upload (build: ${CIRCLE_BRANCH}).";
+              circleci-agent step halt;
+            fi;
+      - run:
+          name: Fetch docs
+          command: |
+            mkdir -p ~/.ssh
+            echo -e "Host *\nStrictHostKeyChecking no" > ~/.ssh/config
+            chmod og= ~/.ssh/config
+            if [ ! -d ~/mne-tools.github.io ]; then
+              git clone git@github.com:/mne-tools/mne-tools.github.io.git ~/mne-tools.github.io --depth=1
+            fi
+      - run:
+          name: Deploy docs
+          command: |
+            git config --global user.email "circle@mne.tools";
+            git config --global user.name "Circle CI";
+            ssh-add -D && ssh-add ~/.ssh/id_rsa_19fe1dc3c7af7e16944ce1e70a5613bd
+            cd ~/mne-tools.github.io;
+            git checkout main
+            git remote -v
+            git fetch origin
+            git reset --hard origin/main
+            git clean -xdf
+            if [ "${CIRCLE_BRANCH}" == "main" ]; then
+              echo "Deploying dev docs for ${CIRCLE_BRANCH}.";
+              rm -Rf dev;
+              cp -a /tmp/build/html dev;
+              git add -A;
+              git commit -m "CircleCI update of dev docs (${CIRCLE_BUILD_NUM}).";
+            else
+              echo "Deploying stable docs for ${CIRCLE_BRANCH}.";
+              rm -Rf stable;
+              cp -a /tmp/build/html stable;
+              git add -A;
+              git commit -m "CircleCI update of stable docs (${CIRCLE_BUILD_NUM}).";
+            fi;
+            git push origin main;
+      - save_cache:
+          key: website-cache-1
+          paths:
+            - ~/mne-tools.github.io
+
+workflows:
+  default:
+    jobs:
+      - build_docs:
+          name: build_docs
+      - linkcheck:
+          name: linkcheck
+      - deploy:
+          name: deploy
+          requires:
+            - build_docs
+          filters:
+            branches:
+              only:
+                - main
+                - /maint\/.*/
+
+  main:
+    jobs:
+      - build_docs:
+          scheduled: "true"
+          name: build_docs_main
+      - deploy:
+          name: deploy_main
+          requires:
+            - build_docs_main
+    triggers:
+      - schedule:
+          # "At 6:00 AM GMT every day"
+          cron: "0 6 * * *"
+          filters:
+            branches:
+              only:
+                - main
+
+  monthly:
+    jobs:
+      - linkcheck:
+          name: linkcheck_monthly
+          scheduled: "true"
+    triggers:
+      - schedule:
+          # "At 6:00 AM GMT on the first day of each month"
+          cron: "0 6 1 * *"
+          filters:
+            branches:
+              only:
+                - main

mne-python/source/.coveragerc

@@ -0,0 +1,16 @@
+[run]
+branch = True
+source = mne
+omit =
+    */bin/*
+    */setup.py
+    */mne/fixes*
+    */mne/utils/linalg.py
+    */mne/conftest.py
+
+[report]
+exclude_lines =
+    pragma: no cover
+    if __name__ == .__main__.:
+    @abstractmethod
+    @abstractclassmethod

mne-python/source/.mailmap

@@ -0,0 +1,379 @@
+Adam Li <adam2392@gmail.com> Adam Li <adam2392@Adams-MBP-2.home>
+Adam Li <adam2392@gmail.com> Adam Li <adam2392@new-host-2.home>
+Alan Leggitt <leggitta3@gmail.com> leggitta <leggitta3@gmail.com>
+Alessandro Tonin <alessandro.tonin@wysscenter.ch> Lychfindel <58313635+Lychfindel@users.noreply.github.com>
+Alex Lepauvre <alex.lepauvre@ae.mpg.de> Alex lepauvre <alex.lepauvre@ae.mpg.de>
+Alex Rockhill <aprockhill206@gmail.com> Alex <aprockhill206@gmail.com>
+Alex Rockhill <aprockhill206@gmail.com> Alex <aprockhill@mailbox.org>
+Alex Rockhill <aprockhill206@gmail.com> Alex Rockhill <aprock@uw.edu>
+Alex Rockhill <aprockhill206@gmail.com> Alex Rockhill <aprockhill@mailbox.org>
+Alexander Rudiuk <alxanderr@gmail.com> Alexander Rudiuk <al629748@dal.ca>
+Alexandre Barachant <alexandre.barachant@gmail.com> alexandre barachant <alexandre.barachant@gmail.com>
+Alexandre Gramfort <alexandre.gramfort@inria.fr> Alexandre Gramfort <alexandre.gramfort@gmail.com>
+Alexandre Gramfort <alexandre.gramfort@inria.fr> Alexandre Gramfort <alexandre.gramfort@inria.fr>
+Alexandre Gramfort <alexandre.gramfort@inria.fr> Alexandre Gramfort <alexandre.gramfort@m4x.org>
+Alexandre Gramfort <alexandre.gramfort@inria.fr> Alexandre Gramfort <alexandre.gramfort@telecom-paristech.fr>
+Alexandre Gramfort <alexandre.gramfort@inria.fr> Alexandre Gramfort <gramfort@localhost.(none)>
+Ana Radanovic <anaradanovica@gmail.com> anaradanovic <79697247+anaradanovic@users.noreply.github.com>
+Andres Rodriguez <rodriguezandr@gmail.com>
+Andrew Dykstra <andrew.r.dykstra@gmail.com>
+Andrew Quinn <AJQuinn@users.noreply.github.com> AJQuinn <AJQuinn@users.noreply.github.com>
+Andy Gilbert <7andy121@gmail.com> Andrew Gilbert <adgilbert21@icloud.com>
+Andy Gilbert <7andy121@gmail.com> Andrew Gilbert <andrew.gilbert@irhythmtech.com>
+Aniket Singh Yadav <148300120+Aniketsy@users.noreply.github.com> Aniket <148300120+Aniketsy@users.noreply.github.com>
+Anna Padee <anna.padee@gmail.com> apadee <44297909+apadee@users.noreply.github.com>
+Anne-Sophie Dubarry <as_dub@hotmail.com> annesodub <as_dub@hotmail.com>
+Archit Singhal <43236121+architsinghal-mriirs@users.noreply.github.com> archit singhal <zyphergiest@pop-os.localdomain>
+Arne Pelzer <arne.pelzer@idmt.fraunhofer.de> aplzr <7202498+aplzr@users.noreply.github.com>
+Arne Pelzer <arne.pelzer@idmt.fraunhofer.de> pzr <arne.pelzer@idmt.fraunhofer.de>
+Ashley Drew <ashdrew@uw.edu> ashdrew <33734402+ashdrew@users.noreply.github.com>
+Asish Panda <asishrocks95@gmail.com> kaichogami <asishrocks95@gmail.com>
+Basile Pinsard <basile.pinsard@umontreal.ca>
+Brad Buran <bburan@galenea.com> Brad Buran <bburan@alum.mit.edu>
+Britta Westner <britta.wstnr@gmail.com> britta-wstnr <britta.wstnr@gmail.com>
+Bruno Aristimunha <b.aristimunha@gmail.com>
+btkcodedev <btk.codedev@gmail.com>
+buildqa <s1152yb68@contbay.com>
+Burkhard Maess <burkhard.maess@arcor.de> Burkhard Maess <bmaess@users.noreply.github.com>
+Carina Forster <carinaforster0611@gmail.com> Carina <carinaforster0611@gmail.com>
+Carlos de la Torre <ctorre@mailbox.org> carlos <ctorre@mailbox.org>
+Catalina María Galván <79813952+catalinamagalvan@users.noreply.github.com> Catalina Magalvan <79813952+catalinamagalvan@users.noreply.github.com>
+Catalina María Galván <79813952+catalinamagalvan@users.noreply.github.com> catalinamagalvan <79813952+catalinamagalvan@users.noreply.github.com>
+Cathy Nangini <cnangini@gmail.com> CN <cnangini@gmail.com>
+Chetan Gohil <53237863+cgohil8@users.noreply.github.com> cgohil8 <53237863+cgohil8@users.noreply.github.com>
+Chris Holdgraf <choldgraf@gmail.com> Chris Holdgraf <choldgraf@berkeley.edu>
+Chris Holdgraf <choldgraf@gmail.com> Christopher Holdgraf <choldgraf@gmail.com>
+Christian Brodbeck <christianmbrodbeck@gmail.com> Christian Brodbeck <christianbrodbeck@nyu.edu>
+Christian Brodbeck <christianmbrodbeck@gmail.com> christianmbrodbeck <christianmbrodbeck@gmail.com>
+Christian Mista <cmista@ingenieria.uner.edu.ar> cmista <79416030+cmista@users.noreply.github.com>
+Christina Zhao <zhaotc@uw.edu> ChristinaZhao <zhaotc@uw.edu>
+Christoph Dinh <chdinh@nmr.mgh.harvard.edu> Christoph Dinh <christoph.dinh@tu-ilmenau.de>
+Christopher J. Bailey <bailey.cj@gmail.com> Chris Bailey <bailey.cj@gmail.com>
+Claire Braboszcz <claire@guakamole.org> claire-braboszcz <claire@guakamole.org>
+Clemens Brunner <clemens.brunner@gmail.com>
+Clément Moutard <clement.moutard@gmail.com>
+Cora Kim <kimjico@gmail.com> kimcoco <41998428+kimcoco@users.noreply.github.com>
+Cristóbal Moënne-Loccoz <cmmoenne@gmail.com> Cristóbal <cmmoenne@gmail.com>
+Dan G. Wakeman <dgwakeman@gmail.com> Daniel G. Wakeman <dgwakeman@gmail.com>
+Dan G. Wakeman <dgwakeman@gmail.com> Daniel Wakeman <dwakeman@marcie.nmr.mgh.harvard.edu>
+Dan G. Wakeman <dgwakeman@gmail.com> dgwakeman <dgwakeman@gmail.com>
+Dan G. Wakeman <dgwakeman@gmail.com> dgwakeman <dgwakeman@users.noreply.github.com>
+Daniel C Schad <daniel.c.schad@protonmail.com> Daniel C Schad <daniel@schad.se>
+Daniel C Schad <daniel.c.schad@protonmail.com> Daniel Carlström Schad <daniel.c.schad@protonmail.com>
+Daniel McCloy <dan@mccloy.info> Daniel McCloy <dan.mccloy@gmail.com>
+Daniel McCloy <dan@mccloy.info> Daniel McCloy <drammock@users.noreply.github.com>
+Daniel McCloy <dan@mccloy.info> drammock <dan.mccloy@gmail.com>
+Daniel Strohmeier <daniel.strohmeier@googlemail.com> Daniel Strohmeier <daniel.strohmeier@googlemail.com>
+Daniel Strohmeier <daniel.strohmeier@googlemail.com> joewalter <daniel.strohmeier@googlemail.com>
+David Julien <david.julien@ifsttar.fr> David JULIEN <david.julien@ifsttar.fr>
+David Sabbagh <dav.sabbagh@gmail.com> DavidSabbagh <33925146+DavidSabbagh@users.noreply.github.com>
+Demetres Kostas <40433000+kostasde@users.noreply.github.com> kostasde <40433000+kostasde@users.noreply.github.com>
+Denis A. Engemann <denis.engemann@gmail.com> dengemann <d.engemann@fz-juelich.de>
+Denis A. Engemann <denis.engemann@gmail.com> dengemann <denis.engemann@gmail.com>
+Denis A. Engemann <denis.engemann@gmail.com> denis <denis.engemann@gmail.com>
+Denis A. Engemann <denis.engemann@gmail.com> Denis A. Engemann <d.engemann@fz-juelich.de>
+Denis A. Engemann <denis.engemann@gmail.com> Denis A. Engemann <denis-alexander.engemann@inria.fr>
+Denis A. Engemann <denis.engemann@gmail.com> Denis A. Engemann <denisaengemann@Denis-A-Engemanns-MacBook-Air.local>
+Denis A. Engemann <denis.engemann@gmail.com> Denis Engemann <dengemann@Deniss-MacBook-Pro.local>
+Denis A. Engemann <denis.engemann@gmail.com> Denis Engemann <dengemann@pool-186-21-zam037.wlan.kfa-juelich.de>
+Dmitrii Altukhov <dm.altukhov@ya.ru> dmalt <dm.altukhov@ya.ru>
+Dominik Krzemiński <raymon92@gmail.com> dokato <raymon92@gmail.com>
+Dominik Welke <dominik.welke@ae.mpg.de> dominikwelke <33089761+dominikwelke@users.noreply.github.com>
+Dominik Welke <dominik.welke@ae.mpg.de> dominikwelke <dominik.welke@web.de>
+Dominik Wetzel <dimonok@web.de> Dominik Wetzel <dominik.wetzel@fh-zwickau.de>
+Eberhard Eich <e.eich@fz-juelich.de> ebeich <ebeich@users.noreply.github.com>
+Eduard Ort <eduardxort@gmail.com> Eduard Ort <edaurdxort@gmail.com>
+Eduard Ort <eduardxort@gmail.com> eort <eduardxort@gmail.com>
+Eduard Ort <eduardxort@gmail.com> examplename <e.ort@vu.nl>
+Ellen Lau <ellenlau@umd.edu> ellenlau <ellenlau@umd.edu>
+Emily Stephen <emilyps14@gmail.com> Emily P. Stephen <emilyps14@gmail.com>
+Emily Stephen <emilyps14@gmail.com> emilyps14 <emilyps14@gmail.com>
+Emma Bailey <93327939+emma-bailey@users.noreply.github.com> emma-bailey <93327939+emma-bailey@users.noreply.github.com>
+Emma Zhang <150376834+zhijingz@users.noreply.github.com> Emma <150376834+zhijingz@users.noreply.github.com>
+Enrico Varano <enricovarano@gmail.com> enricovara <69973551+enricovara@users.noreply.github.com>
+Enzo Altamiranda <enzo.alt@gmail.com> enzo <enzo.alt@gmail.com>
+Eric Larson <larson.eric.d@gmail.com> Eric Larson <larson.eric.d@gmail.com>
+Eric Larson <larson.eric.d@gmail.com> Eric Larson <larsoner@monolith.local>
+Eric Larson <larson.eric.d@gmail.com> Eric Larson <larsoner@uw.edu>
+Eric Larson <larson.eric.d@gmail.com> Eric89GXL <larson.eric.d@gmail.com>
+Eric Larson <larson.eric.d@gmail.com> Eric89GXL <larsoner@uw.edu>
+Erica Peterson <nordme@uw.edu> nordme <38704848+nordme@users.noreply.github.com>
+Erica Peterson <nordme@uw.edu> nordme <nordme@uw.edu>
+Erik Hornberger <erik.hornberger@shi-g.com> er06645810 <erik.hornberger@shi-g.com>
+Erik Hornberger <erik.hornberger@shi-g.com> Erik Hornberger <hornbergererik@gmail.com>
+Erkka Heinila <erkkahe@gmail.com> Teekuningas <erkka.heinila@jyu.fi>
+Erkka Heinila <erkkahe@gmail.com> Teekuningas <erkkahe@gmail.com>
+Etienne de Montalivet <etiennedemontalivet@users.noreply.github.com>
+Evgenii Kalenkovich <e.kalenkovich@gmail.com> kalenkovich <e.kalenkovich@gmail.com>
+Evgeny Goldstein <84768107+evgenygoldstein@users.noreply.github.com> evgenygoldstein <84768107+evgenygoldstein@users.noreply.github.com>
+Ezequiel Mikulan <e.mikulan@gmail.com> ezemikulan <39155887+ezemikulan@users.noreply.github.com>
+Fahimeh Mamashli <33672431+fmamashli@users.noreply.github.com> fmamashli <33672431+fmamashli@users.noreply.github.com>
+Fede Raimondo <federaimondo@gmail.com> Fede <slashack@gmail.com>
+Fede Raimondo <federaimondo@gmail.com> Fede Raimondo <federaimondo@gmail.com>
+Fede Raimondo <federaimondo@gmail.com> Fede Raimondo <fraimondo@dc.uba.ar>
+Fede Raimondo <federaimondo@gmail.com> Fede Raimondo <slashack@gmail.com>
+Fede Raimondo <federaimondo@gmail.com> Federico Raimondo <fraimondo@dc.uba.ar>
+Fede Raimondo <federaimondo@gmail.com> Federico Raimondo <slashack@gmail.com>
+Federico Zamberlan <44038765+fzamberlan@users.noreply.github.com>
+Felix Klotzsche <klotzsche@cbs.mpg.de> eioe <felix_klotzsche@web.de>
+Felix Klotzsche <klotzsche@cbs.mpg.de> eioe <klotzsche@cbs.mpg.de>
+Frederik D. Weber <Frederik-D-Weber@users.noreply.github.com> Frederik-D-Weber <Frederik-D-Weber@users.noreply.github.com>
+Fu-Te Wong <zuxfoucault@gmail.com> foucault <zuxfoucault@gmail.com>
+Fu-Te Wong <zuxfoucault@gmail.com> zuxfoucault <zuxfoucault@yahoo.com.tw>
+Félix Raimundo <gamaz3ps@gmail.com> Felix Raimundo <gamaz3ps@gmail.com>
+Gansheng Tan <49130176+GanshengT@users.noreply.github.com> Gansheng TAN <49130176+GanshengT@users.noreply.github.com>
+Gennadiy Belonosov <7503709+Genuster@users.noreply.github.com> Gennadiy <7503709+Genuster@users.noreply.github.com>
+Gennadiy Belonosov <7503709+Genuster@users.noreply.github.com> Genuster <7503709+Genuster@users.noreply.github.com>
+Giorgio Marinato <giorgio.marinato@unitn.it> neurogima <76406896+neurogima@users.noreply.github.com>
+Giulio Gabrieli <giulio.gabrieli@iit.it>
+Guillaume Dumas <deep@introspection.eu> deep-introspection <deep@introspection.eu>
+Guillaume Dumas <deep@introspection.eu> Guillaume Dumas <deep-introspection@users.noreply.github.com>
+Hakimeh Aslsardroud <hakimeh.aslsardroud@localhost>
+Hamid Maymandi <46011104+HamidMandi@users.noreply.github.com> Hamid <46011104+HamidMandi@users.noreply.github.com>
+Hasrat Ali Arzoo <hasrat407@gmail.com> hasrat17 <56307533+hasrat17@users.noreply.github.com>
+Hongjiang Ye <rubyyhj@gmail.com> YE Hongjiang <hongjiang.ye@outlook.com>
+Hongjiang Ye <rubyyhj@gmail.com> YE Hongjiang <rubyyhj@gmail.com>
+Hubert Banville <hubert.jbanville@gmail.com> hubertjb <hubert.jbanville@gmail.com>
+Hyonyoung Shin <55095699+mcvain@users.noreply.github.com> mcvain <55095699+mcvain@users.noreply.github.com>
+Hüseyin Orkun Elmas <huseyinorkunelmas@gmail.com> Hüseyin <huseyinorkunelmas@gmail.com>
+Ingoo Lee <dlsrnsladlek@naver.com> dlsrnsi <dlsrnsladlek@naver.com>
+Ivo de Jong <ivopascal@gmail.com> ivopascal <ivopascal@gmail.com>
+Jaakko Leppakangas <jaeilepp@gmail.com> Jaakko Leppakangas <jaeilepp@student.jyu.fi>
+Jaakko Leppakangas <jaeilepp@gmail.com> jaeilepp <jaeilepp@gmail.com>
+Jaakko Leppakangas <jaeilepp@gmail.com> jaeilepp <jaeilepp@student.jyu.fi>
+Jacob Phelan <jacob.phelan.jp@gmail.com>
+Jair Montoya <montoya.jair.m@gmail.com> jmontoyam <montoya.jair.m@gmail.com>
+Jan Ebert <janpublicebert@posteo.net> janEbert <janpublicebert@posteo.net>
+Jan Sedivy <sedivy@rtsoft.cz>
+Jan Sosulski <mail@jan-sosulski.de> jsosulski <mail@jan-sosulski.de>
+Jean-Baptiste Schiratti <jean.baptiste.schiratti@gmail.com> Jean-Baptiste SCHIRATTI <jean.baptiste.schiratti@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> Jean-Rémi KING <jeanremi.king@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> kingjr <jeanremi.kibng+github@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> kingjr <jeanremi.king+github@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> kingjr <jeanremi.king@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> UMR9752 <jeanremi.king+github@gmail.com>
+Jean-Rémi King <jeanremi.king+github@gmail.com> UMR9752 <umr9752@umr9752-desktop.(none)>
+Jeff Stout <stoutjd@nih.gov> jstout211 <jstout211@yahoo.com>
+Jennifer Behnke <jennifer.behnke@localhost>
+Jesper Duemose Nielsen <jdue@dtu.dk> jdue <jdue@dtu.dk>
+Jevri Hanna <jevri.hanna@gmail.com> Jeff Hanna <jeff.hanna@gmail.com>
+Jevri Hanna <jevri.hanna@gmail.com> Jevri Hanna <jeff.hanna@gmail.com>
+Joan Massich <mailsik@gmail.com> Joan Massich <sik@visor.udg.edu>
+Joan Massich <mailsik@gmail.com> massich <sik@visor.udg.edu>
+Johannes Kasper <jeythekey@tutanota.com> jeythekey <44215387+jeythekey@users.noreply.github.com>
+John Samuelsson <johnsam@mit.edu> johnsam7 <johnsam@mit.edu>
+John Veillette <johnv@uchicago.edu>
+Jon Houck <jon.houck@gmail.com> Jon Houck <jhouck@users.noreply.github.com>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> jona <jona.sassenhagen@gmail.com>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> Jona Sassenhagen <jona.sassenhagen@staff.uni-marburg.de>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> jona-sassenhagen <jona.sassenhagen@gmail.com>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> jona-sassenhagen <jona.sassenhagen@staff.uni-marburg.de>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> jona-sassenhagen@ <jona.sassenhagen@gmail.com>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> jona.sassenhagen@gmail.com <jona.sassenhagen@gmail.com>
+Jona Sassenhagen <jona.sassenhagen@gmail.com> sassenha <sassenha@fiebach1.rz.uni-frankfurt.de>
+Jonathan Kuziek <kuziek@ualberta.ca>
+Jordan Drew <39603454+jadrew43@users.noreply.github.com> jadrew43 <39603454+jadrew43@users.noreply.github.com>
+Joris Van den Bossche <jorisvandenbossche@gmail.com> Joris Van den Bossche <jorisvandenbossche@gmail.com>
+Joshua Calder-Travis <38797399+jCalderTravis@users.noreply.github.com> jCalderTravis <38797399+jCalderTravis@users.noreply.github.com>
+Joshua J Bear <joshbear@users.noreply.github.com>
+Joshua Teves <jbtevespro@gmail.com> Joshua Teves <joshua.teves@nih.gov>
+José C. García Alanis <joialanisson@gmail.com> Jose Alanis <joialanisson@gmail.com>
+José C. García Alanis <joialanisson@gmail.com> Jose C. G. Alanis <12409129+JoseAlanis@users.noreply.github.com>
+José C. García Alanis <joialanisson@gmail.com> José C. G. Alanis <12409129+JoseAlanis@users.noreply.github.com>
+José C. García Alanis <joialanisson@gmail.com> José C. García Alanis <12409129+JoseAlanis@users.noreply.github.com>
+Julius Welzel <52565341+JuliusWelzel@users.noreply.github.com> jwelzel <52565341+JuliusWelzel@users.noreply.github.com>
+Justus Schwabedal <jschwabedal@gmail.com>
+Kaisu Lankinen <41806798+klankinen@users.noreply.github.com> klankinen <41806798+klankinen@users.noreply.github.com>
+Kambiz Tabavi <ktavabi@gmail.com> Kambiz Tavabi <ktavabi@uw.edu>
+Kambiz Tabavi <ktavabi@gmail.com> kambysese <ktavabi@gmail.com>
+Katarina Slama <slama@berkeley.edu> katarinaslama <slama@berkeley.edu>
+Katia Al-Amir <129207373+katia-sentry@users.noreply.github.com> Katia <129207373+katia-sentry@users.noreply.github.com>
+Kostiantyn Maksymenko <makkostya@ukr.net> kostiantyn maksymenko <kostiantyn.maksymenko@inria.fr>
+Kostiantyn Maksymenko <makkostya@ukr.net> Maksymenko Kostiantyn <kostiantyn.maksymenko@inria.fr>
+Kostiantyn Maksymenko <makkostya@ukr.net> Maksymenko Kostiantyn <makkostya@ukr.net>
+Laetitia Grabot <laetitia.grabot@gmail.com> LaetitiaG <laetitia.grabot@gmail.com>
+Larry Eisenman <leisenman@wustl.edu> lneisenman <lneisenman@hotmail.com>
+Laurent Lementec <laurent.lementec@gmail.com>
+Lenny Varghese <lennyvarghese@users.noreply.github.com> lennyvarghese <lennyvarghese@users.noreply.github.com>
+Liberty Hamilton <libertyhamilton@gmail.com>
+Lorenz Esch <Lorenz.Esch@tu-ilmenau.de> Lorenz Esch <lorenzesch@hotmail.com>
+Lorenzo Alfine <lorenzo.alfine@gmail.com> lorrandal <lorenzo.alfine@gmail.com>
+Louis Thibault <louist87@gmail.com> = <louist87@gmail.com>
+Louis Thibault <louist87@gmail.com> Louis Thibault <louist@ltpc.(none)>
+Lukas Gemein <lukas.gemein@gmx.de> gemeinl <gemeinl@users.noreply.github.com>
+Lukáš Hejtmánek <hejtmy@gmail.com> hejtmy <hejtmy@gmail.com>
+Mads Jensen <mje.mads@gmail.com> mads jensen <mje.mads@gmail.com>
+Mainak Jas <mainakjas@gmail.com> Mainak <mainakjas@gmail.com>
+Mainak Jas <mainakjas@gmail.com> Mainak Jas <jasmainak@users.noreply.github.com>
+Mainak Jas <mainakjas@gmail.com> Mainak Jas <mainak.jas@telecom-paristech.fr>
+Mainak Jas <mainakjas@gmail.com> Mainak Jas <mainak@neuro.hut.fi> <mainakjas@users.noreply.github.com>
+Mainak Jas <mainakjas@gmail.com> mainakjas <mainakjas@users.noreply.github.com>
+Manoj Kumar <manojkumarsivaraj334@gmail.com> MechCoder <manojkumarsivaraj334@gmail.com>
+Manu Sutela <manu.sutela@gmail.com> MJAS1 <manu.sutela@gmail.com>
+Marian Dovgialo <marian.dowgialo@gmail.com> Marian Dovgialo <mdovgialo@fabrizzio.zfb.fuw.edu.pl>
+Marian Dovgialo <marian.dowgialo@gmail.com> Marian Dovgialo <mdovgialo@users.noreply.github.com>
+Marian Dovgialo <marian.dowgialo@gmail.com> mdovgialo <mdovgialo@users.noreply.github.com>
+Marijn van Vliet <w.m.vanvliet@gmail.com> Marijn van Vliet <w.m.vanvliet@student.utwente.nl>
+Mark Henney <mah@optoceutics.com> Mark <mah@optoceutics.com>
+Mark Henney <mah@optoceutics.com> Mark Alexander Henney <mah@optoceutics.com>
+Mark Henney <mah@optoceutics.com> Mark Henney <120719655+henneysq@users.noreply.github.com>
+Mark Wronkiewicz <wronk.mark@gmail.com> wronk <wronk.mark@gmail.com>
+Marmaduke Woodman <mmwoodman@gmail.com> maedoc <maedoc@mm.st>
+Martin BaBer <Martinb.nmb@gmail.com>
+Martin Billinger <flKazemakase@gmail.com> kazemakase <kazemakase@users.noreply.github.com>
+Martin Billinger <flKazemakase@gmail.com> kazemakase <kazemakase@users.noreply.github.com>
+Martin Billinger <flKazemakase@gmail.com> Martin Billinger <martin.billinger@tugraz.at>
+Martin Billinger <flKazemakase@gmail.com> mbillingr <mbillingr@users.noreply.github.com>
+Martin Luessi <mluessi@nmr.mgh.harvard.edu> martin <martin@think.(none)>
+Martin Luessi <mluessi@nmr.mgh.harvard.edu> martin <martin@think.hsd1.ma.comcast.net>
+Martin Luessi <mluessi@nmr.mgh.harvard.edu> mluessi@nmr.mgh.harvard.edu <mluessi@nmr.mgh.harvard.edu>
+Martin Perez-Guevara <mperezguevara@gmail.com>
+Martin Schulz <dev@mgschulz.de> Martin Schulz <46245704+marsipu@users.noreply.github.com>
+Martin Schulz <dev@mgschulz.de> Martin Schulz <dev@earthman-music.de>
+Martin van Harmelen <1544429+MPvHarmelen@users.noreply.github.com> Martin <1544429+MPvHarmelen@users.noreply.github.com>
+Mathieu Scheltienne <mathieu.scheltienne@gmail.com> Mathieu Scheltienne <73893616+mscheltienne@users.noreply.github.com>
+Mathieu Scheltienne <mathieu.scheltienne@gmail.com> Mathieu Scheltienne <mathieu.scheltienne@fcbg.ch>
+Mathurin Massias <mathurin.massias@gmail.com> mathurinm <mathurin.massias@gmail.com>
+Mathurin Massias <mathurin.massias@gmail.com> mathurinm <mathurinm@users.noreply.github.com>
+Mats van Es <mats.vanes@psych.ox.ac.uk> Mats <mats.vanes@psych.ox.ac.uk>
+Matt Sanderson <monkey_man_192@yahoo.com.au> monkeyman192 <monkey_man_192@yahoo.com.au>
+Matteo Anelli <matteo.anelli@aalto.fi> Matteo Anelli <matteanelli.96.11@gmail.com>
+Matteo Visconti di Oleggio Castello <matteo.visconti.gr@dartmouth.edu> Matteo Visconti dOC <matteo.visconti.gr@dartmouth.edu>
+Matthias Dold <matthias.dold@gmx.net> matthiasdold <62005770+matthiasdold@users.noreply.github.com>
+Matthias Eberlein <41163089+MatthiasEb@users.noreply.github.com> MatthiasEb <41163089+MatthiasEb@users.noreply.github.com>
+Matti Hämäläinen <msh@nmr.mgh.harvard.edu> Matti Hamalainen <msh@nmr.mgh.harvard.edu>
+Matti Hämäläinen <msh@nmr.mgh.harvard.edu> Matti Hamalainen <msh@parsley.nmr.mgh.harvard.edu>
+Matti Hämäl��inen <msh@nmr.mgh.harvard.edu> Matti Hämäläinen <msh@parsley.nmr.mgh.harvard.edu>
+Matti Hämäläinen <msh@nmr.mgh.harvard.edu> mshamalainen <msh@nmr.mgh.harvard.edu>
+Matti Toivonen <105695400+mattitoi@users.noreply.github.com> mattitoi <105695400+mattitoi@users.noreply.github.com>
+Maureen Shader <55732126+mshader@users.noreply.github.com> mshader <55732126+mshader@users.noreply.github.com>
+Melih Yayli <melihyayli@hotmail.com>
+Michiru Kaneda <rcmdnk@gmail.com> rcmdnk <rcmdnk@gmail.com>
+Mikołaj Magnuski <mmagnuski@swps.edu.pl> Mikolaj Magnuski <mmagnuski@swps.edu.pl>
+Mikołaj Magnuski <mmagnuski@swps.edu.pl> mmagnuski <mmagnuski@swps.edu.pl>
+Mohamed Sherif <molpsychistb@gmail.com> mohdsherif <molpsychistb@gmail.com>
+Mohammad Daneshzand <55800429+mdaneshzand@users.noreply.github.com> mdaneshzand <55800429+mdaneshzand@users.noreply.github.com>
+Mojackhak <23111220065@m.fudan.edu.cn> Ankang Hu <23111220065@m.fudan.edu.cn>
+Motofumi Fushimi <30593537+motofumi-fushimi@users.noreply.github.com> motofumi-fushimi <30593537+motofumi-fushimi@users.noreply.github.com>
+Natalie Klein <neklein@andrew.cmu.edu> natalieklein <neklein@andrew.cmu.edu>
+Nathalie Gayraud <nathalie.gayraud@inria.fr> Nathalie <nat.gayraud@gmail.com>
+Nathalie Gayraud <nathalie.gayraud@inria.fr> Nathalie <nathalie.gayraud@inria.fr>
+Natneal B <nati.new77@gmail.com>
+Naveen Srinivasan <172697+naveensrinivasan@users.noreply.github.com> Naveen <172697+naveensrinivasan@users.noreply.github.com>
+Nicolas Barascud <nbara@users.noreply.github.com> nbara <nbara@users.noreply.github.com>
+Nicolas Barascud <nbara@users.noreply.github.com> Nicolas Barascud <10333715+nbara@users.noreply.github.com>
+Nicolas Fourcaud-Trocmé <celicolimmo@free.fr> Fourcaud-Trocmé <nicolas.fourcaud-trocme@cnrs.fr>
+Nicolas Gensollen <nicolas.gensollen@gmail.com> Gensollen <nicolas.gensollen@gmail.com>
+Nicolas Legrand <legrand@cyceron.fr> Legrand Nicolas <legrand@cyceron.fr>
+Nicolas Legrand <legrand@cyceron.fr> LegrandNico <legrand@cyceron.fr>
+Nicolas Legrand <legrand@cyceron.fr> Nicolas Legrand <nicolas.legrand@cfin.au.dk>
+Niels Focke <nfocke@uni-goettingen.de> nmri-nfocke <114056301+nmri-nfocke@users.noreply.github.com>
+Niklas Wilming <niklas.wilming@gmail.com> Niklas Wilming <niklaswilming@fastmail.fm>
+Nikolai Chapochnikov <23103092+chapochn@users.noreply.github.com> chapochn <23103092+chapochn@users.noreply.github.com>
+Nikolai Chapochnikov <23103092+chapochn@users.noreply.github.com> Nikolai M Chapochnikov <23103092+chapochn@users.noreply.github.com>
+Nikolas Chalas <nikos.ch01@gmail.com> Nichalas <nikos.ch01@gmail.com>
+Noah Markowitz <34498671+nmarkowitz@users.noreply.github.com> NoahMarkowitz <34498671+nmarkowitz@users.noreply.github.com>
+Olaf Hauk <olaf.hauk@mrc-cbu.cam.ac.uk> Olaf Hauk <olaf@mac0086.local>
+Olaf Hauk <olaf.hauk@mrc-cbu.cam.ac.uk> olafhauk <olaf.hauk@mrc-cbu.cam.ac.uk>
+Omer Shubi <omer.shubi@gmail.com> Omer S <omer.shubi@gmail.com>
+Pablo Arias <pablo12co@hotmail.com>
+Paul Pasler <paul@ppasler.de> ppasler <paul@ppasler.de>
+Paul Roujansky <paul@roujansky.eu> Paul ROUJANSKY <paul.roujansky@bioserenity.com>
+Paul Roujansky <paul@roujansky.eu> paulroujansky <paul@roujansky.eu>
+Pavel Navratil <pavel.navratil@localhost>
+Pedro Silva <pedrobnsilva@gmail.com> pbnsilva <pedrobnsilva@gmail.com>
+Phillip Alday <phillip.alday@mpi.nl> Phillip Alday <palday@users.noreply.github.com>
+Phillip Alday <phillip.alday@mpi.nl> Phillip Alday <phillip.alday@unisa.edu.au>
+Pierre Ablin <pierreablin@gmail.com> pierreablin <pierreablin@gmail.com>
+Pierre-Antoine Bannier <pierreantoine.bannier@gmail.com> PAB <pierreantoine.bannier@gmail.com>
+Pierre-Antoine Bannier <pierreantoine.bannier@gmail.com> Pierre-Antoine Bannier <pierre-antoine@222-194.wifi-inria-saclay.saclay.inria.fr>
+Pierre-Antoine Bannier <pierreantoine.bannier@gmail.com> Pierre-Antoine Bannier <pierre-antoine@macbook-pro-de-pierre-antoine.home>
+Pierre-Antoine Bannier <pierreantoine.bannier@gmail.com> Pierre-Antoine Bannier <pierre-antoine@MacBook-Pro-de-Pierre-Antoine.local>
+Pierre-Antoine Bannier <pierreantoine.bannier@gmail.com> Pierre-Antoine Bannier <pierre-antoine@mbpdepieantoine.home>
+Ping-Keng Jao <ping-keng.jao@alumni.epfl.ch> nafraw <ping-keng.jao@alumni.epfl.ch>
+Pragnya Khandelwal <prag1704@gmail.com> Pragnya <prag1704@gmail.com>
+Pragnya Khandelwal <prag1704@gmail.com> PragnyaKhandelwal <prag1704@gmail.com>
+Praveen Sripad <pravsripad@gmail.com> prav <prav@prav-dell.(none)>
+Praveen Sripad <pravsripad@gmail.com> prav <pravsripad@gmail.com>
+Proloy Das <pdas6@mgh.harvard.edu> pdas6 <pdas6@mgh.harvard.edu>
+Ram Pari <ramsbam@gmail.com> Ram <ramsbam@gmail.com>
+Ramonapariciog Apariciogarcia <moncho_apa@hotmail.com> ramonapariciog <moncho_apa@hotmail.com>
+Rasmus Aagaard <roraa@dtu.dk> roraa <roraa@dtu.dk>
+Reza Nasri <reza@ddpo.ir> Reza <qablameh13@gmail.com>
+Reza Nasri <reza@ddpo.ir> RezaNasri <rezanasri@outlook.com>
+Riessarius Stargardsky <rie.acad@gmail.com>
+Roan LaPlante <aestrivex@gmail.com> aestrivex <aestrivex@gmail.com>
+Robert Luke <code@robertluke.net> Robert Luke <748691+rob-luke@users.noreply.github.com>
+Robert Luke <code@robertluke.net> Robert Luke <mail@robertluke.net>
+Robert Seymour <robbyseymour@gmail.com>
+Robin Tibor Schirrmeister <robintibor@gmail.com> robintibor <robintibor@gmail.com>
+Roeland Hancock <rhancock@gmail.com>
+Romain Derollepot <romain.derollepot@univ-eiffel.fr>
+Romain Trachel <romain.trachel@inria.fr> Romain Trachel <romain.trachel@ens.fr>
+Romain Trachel <romain.trachel@inria.fr> Romain Trachel <trachelr@gmail.com>
+Romain Trachel <romain.trachel@inria.fr> trachelr <romain.trachel@inria.fr>
+Roman Goj <roman.goj@gmail.com>
+Rongfei Jin <131315c@gmail.com> GreasyCat <131315c@gmail.com>
+Ross Maddox <ross.maddox@rochester.edu> rkmaddox <ross.maddox@gmail.com>
+Ross Maddox <ross.maddox@rochester.edu> Ross Maddox <rkmaddox@uw.edu>
+Ross Maddox <ross.maddox@rochester.edu> unknown <rkmaddox@uw.edu>
+Rotem Falach <falachrotem@gmail.com> Falach <rotemfa0@gmail.com>
+Roy Eric Wieske <139973278+Randomidous@users.noreply.github.com> Roy Eric <139973278+Randomidous@users.noreply.github.com>
+Ryan Law <ryan.law@mpi.nl> Ryan Law <ryalaw@dccn.nl>
+Ryan Law <ryan.law@mpi.nl> Ryan M.C. Law <ryan.law@mrc-cbu.cam.ac.uk>
+Sammi Chekroud <sammi.chekroud@psy.ox.ac.uk>
+Samuel Deslauriers-Gauthier <sam.deslauriers@gmail.com> Samuel Deslauriers-Gauthier <sdeslauriers@users.noreply.github.com>
+Santeri Ruuskanen <santeri.ruuskanen@aalto.fi> Santeri Ruuskanen <66060772+ruuskas@users.noreply.github.com>
+Santi Martínez <santiaguzz@gmail.com> szz-dvl <santiaguzz@gmail.com>
+Sara Sommariva <sommariva@dima.unige.it> sarasommariva <sommariva@dima.unige.it>
+Sebastien Treguer <sfox@riseup.net> DataFox <sfox@riseup.net>
+Sena Er <2799280+sena-neuro@users.noreply.github.com> Sena <2799280+sena-neuro@users.noreply.github.com>
+Senwen Deng <36327760+snwnde@users.noreply.github.com> Senwen DENG <36327760+snwnde@users.noreply.github.com>
+Shristi Baral <shristi.baral@aalto.fi> shristi <shristi.baral@aalto.fi>
+Silvia Cotroneo <78911192+sfc-neuro@users.noreply.github.com> sfc-neuro <78911192+sfc-neuro@users.noreply.github.com>
+Simon Kern <simon.kern@online.de> Simon Kern <14980558+skjerns@users.noreply.github.com>
+Simon Kern <simon.kern@online.de> skjerns <14980558+skjerns@users.noreply.github.com>
+Simon Kern <simon.kern@online.de> skjerns <simon.kern@online.de>
+Sondre Foslien <sondre.foslien@gmail.com> sondrfos <sondre.foslien@gmail.com>
+Sophie Herbst <ksherbst@gmail.com>
+Steinn Hauser Magnússon <hausersteinn@gmail.com> Steinn Magnusson <s.magnusson@senec.com>
+Steve Matindi <stevematindi@gmail.com> stevemats <stevematindi@gmail.com>
+Steven Bierer <neurolaunch@gmail.copm> Steven Bierer <40672003+NeuroLaunch@users.noreply.github.com>
+Steven M. Gutstein <s.m.gutstein@gmail.com> S. M. Gutstein <s.m.gutstein@gmail.com>
+Steven M. Gutstein <s.m.gutstein@gmail.com> smgutstein <s.m.gutstein@gmail.com>
+sviter <sviter33@gmail.com>
+T. Wang <twang5@swarthmore.edu> twang5 <81429617+twang5@users.noreply.github.com>
+Tanay Gahlot <tanaygahlot@gmail.com> Tanay <tanaygahlot@gmail.com>
+Teon L Brooks <teon.brooks@gmail.com>
+Teon L Brooks <teon.brooks@gmail.com> <teon@nyu.edu>
+Teon L Brooks <teon.brooks@gmail.com> Teon <teon@nyu.edu>
+Teon L Brooks <teon.brooks@gmail.com> Teon Brooks <teon@nyu.edu>
+Thomas Donoghue <tdonoghue.research@gmail.com> Tom <tdonoghue.research@gmail.com>
+Thomas Radman <radman.thomas@gmail.com>
+Timon Merk <timon.merk@charite.de>
+Timon Merk <timon.merk@charite.de> Timon Merk <38216460+timonmerk@users.noreply.github.com>
+Timon Merk <timon.merk@charite.de> timonmerk <38216460+timonmerk@users.noreply.github.com>
+Timothy Gates <tim.gates@iress.com> Tim Gates <tim.gates@iress.com>
+Timur Sokhin <qwinpin@gmail.com>
+Tod Flak <45362686+todflak@users.noreply.github.com> todflak <45362686+todflak@users.noreply.github.com>
+Tom Ma <myd7349@gmail.com> myd7349 <myd7349@gmail.com>
+Tom Stone <TASTONE@mgh.harvard.edu> Stone <TASTONE@mgh.harvard.edu>
+Tom Stone <TASTONE@mgh.harvard.edu> tomdstone <77251489+tomdstone@users.noreply.github.com>
+Tristan Stenner <ttstenner@gmail.com> Tristan Stenner <derstenner@gmail.com>
+Tziona NessAiver <tzionan@mail.tau.ac.il> TzionaN <tzionan@mail.tau.ac.il>
+user27182 <89109579+user27182@users.noreply.github.com>
+Valerii Chirkov <vagechirkov@gmail.com> Valerii <42982039+vagechirkov@users.noreply.github.com>
+Valerii Chirkov <vagechirkov@gmail.com> Valerii <vagechirkov@gmail.com>
+varshaa-1616 <varshaa.1616@gmail.com>
+Velu Prabhakar Kumaravel <veluprabhakarkumaravel@Velus-MBP.lan> Velu Prabhakar Kumaravel <veluprabhakarkumaravel@Velus-MBP.lan>
+Victoria Peterson <victoriapeterson09@gmail.com> vpeterson <victoriapeterson09@gmail.com>
+Wei Xu <weixu@mail.bnu.edu.cn> Wei <weixu@mail.bnu.edu.cn>
+Will Turner <wturner@student.unimelb.edu.au> Will Turner <wturner@student.unimelb.edu.au>
+Yiping Zuo <frostime@foxmail.com> Frostime <frostime@foxmail.com>
+Yousra Bekhti <yousra.bekhti@gmail.com> Yoursa BEKHTI <ybekhti@is222485.intra.cea.fr>
+Yousra Bekhti <yousra.bekhti@gmail.com> Yoursa BEKHTI <yousra.bekhti@gmail.com>
+Yousra Bekhti <yousra.bekhti@gmail.com> Yousra BEKHTI <yousra.bekhti@gmail.com>
+Yousra Bekhti <yousra.bekhti@gmail.com> yousrabk <yousra.bekhti@gmail.com>
+Zhi Zhang <850734033@qq.com> ZHANG Zhi <850734033@qq.com>
+Zhi Zhang <850734033@qq.com> ZHANG Zhi <zhi271.zhang@connect.polyu.hk>
+Ziyi ZENG <ziyizeng@link.cuhk.edu.cn> ZIYI ZENG <CME1909120@XMU.EDU.MY>

mne-python/source/.pre-commit-config.yaml

@@ -0,0 +1,106 @@
+repos:
+  # Ruff mne
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.5
+    hooks:
+      - id: ruff-check
+        name: ruff lint mne
+        args: ["--fix"]
+        files: ^mne/|^tools/
+        exclude: vulture_allowlist.py
+      - id: ruff-check
+        name: ruff lint mne preview
+        args: ["--fix", "--preview", "--select=NPY201"]
+        files: ^mne/|^tools/
+      - id: ruff-check
+        name: ruff lint doc, tutorials, and examples
+        # D103: missing docstring in public function
+        # D400: docstring first line must end with period
+        args: ["--ignore=D103,D400", "--fix"]
+        files: ^doc/|^tutorials/|^examples/
+      - id: ruff-format
+        files: ^mne/|^doc/|^tutorials/|^examples/|^tools/
+
+  # Codespell
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+        files: ^mne/|^doc/|^examples/|^tutorials/|^tools/
+        types_or: [python, bib, rst, inc]
+
+  # yamllint
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.38.0
+    hooks:
+      - id: yamllint
+        args: [--strict, -c, .yamllint.yml]
+
+  # rstcheck
+  - repo: https://github.com/rstcheck/rstcheck.git
+    rev: v6.2.5
+    hooks:
+      - id: rstcheck
+        additional_dependencies:
+          - tomli
+        files: ^doc/.*\.(rst|inc)$
+        # Credit is problematic because we generate an include on the fly
+        exclude: ^doc/credit.rst$
+
+  # sorting
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: file-contents-sorter
+        files: ^doc/changes/names.inc|^.mailmap|^doc/sphinxext/related_software.txt
+        args: ["--ignore-case"]
+
+  - repo: https://github.com/pappasam/toml-sort
+    rev: v0.24.3
+    hooks:
+      - id: toml-sort-fix
+        files: pyproject.toml
+
+  # dependencies
+  - repo: local
+    hooks:
+      - id: update-env-file
+        name: Copy dependency changes from pyproject.toml to environment.yml
+        language: python
+        entry: ./tools/hooks/update_environment_file.py
+        files: '^(pyproject.toml|tools/hooks/update_environment_file.py)$'
+  - repo: local
+    hooks:
+      - id: dependency-sync
+        name: Copy core dependencies from pyproject.toml to README.rst
+        language: python
+        entry: ./tools/hooks/sync_dependencies.py
+        files: '^(pyproject.toml|tools/hooks/sync_dependencies.py)$'
+        additional_dependencies: ["mne==1.11.0"]
+
+  # zizmor
+  - repo: https://github.com/woodruffw/zizmor-pre-commit
+    rev: v1.23.1
+    hooks:
+      - id: zizmor
+        args: [--fix]
+        # We correctly use pull_request_trigger, and need Zizmor 2.0+ to configure the ignore
+        exclude: ^.github/workflows/automerge.yml
+
+# these should *not* be run on CIs:
+ci:
+  skip: [dependency-sync]  # needs MNE to work, which exceeds the free tier space alloc.
+
+# The following are too slow to run on local commits, so let's only run on CIs:
+#
+#   - repo: https://github.com/pre-commit/mirrors-mypy
+#     rev: v1.9.0
+#     hooks:
+#       - id: mypy
+#
+#   - repo: https://github.com/jendrikseipp/vulture
+#     rev: 'v2.11'  # or any later Vulture version
+#     hooks:
+#       - id: vulture

mne-python/source/.yamllint.yml

@@ -0,0 +1,10 @@
+extends: default
+
+ignore: |
+  .github/workflows/codeql-analysis.yml
+
+rules:
+  line-length: disable
+  document-start: disable
+  new-lines:
+    type: platform

mne-python/source/CITATION.cff

@@ -0,0 +1,877 @@
+cff-version: 1.2.0
+title: "MNE-Python"
+message: "If you use this software, please cite both the software itself, and the paper listed in the preferred-citation field."
+version: 1.11.0
+date-released: "2025-11-21"
+commit: 07328a6a7fa974b24455e1ac333d7607b154f87c
+doi: 10.5281/zenodo.592483
+keywords:
+  - MEG
+  - magnetoencephalography
+  - EEG
+  - electroencephalography
+  - fNIRS
+  - "functional near-infrared spectroscopy"
+  - iEEG
+  - "intracranial EEG"
+  - eCoG
+  - electrocorticography
+  - DBS
+  - "deep brain stimulation"
+authors:
+  - family-names: Larson
+    given-names: Eric
+  - family-names: Gramfort
+    given-names: Alexandre
+  - family-names: Engemann
+    given-names: Denis A
+  - family-names: Leppakangas
+    given-names: Jaakko
+  - family-names: Brodbeck
+    given-names: Christian
+  - family-names: Jas
+    given-names: Mainak
+  - family-names: Brooks
+    given-names: Teon L
+  - family-names: Sassenhagen
+    given-names: Jona
+  - family-names: McCloy
+    given-names: Daniel
+  - family-names: Luessi
+    given-names: Martin
+  - family-names: King
+    given-names: Jean-Rémi
+  - family-names: Höchenberger
+    given-names: Richard
+  - family-names: Brunner
+    given-names: Clemens
+  - family-names: Goj
+    given-names: Roman
+  - family-names: Favelier
+    given-names: Guillaume
+  - family-names: van Vliet
+    given-names: Marijn
+  - family-names: Wronkiewicz
+    given-names: Mark
+  - family-names: Appelhoff
+    given-names: Stefan
+  - family-names: Rockhill
+    given-names: Alex
+  - family-names: Holdgraf
+    given-names: Chris
+  - family-names: Scheltienne
+    given-names: Mathieu
+  - family-names: Massich
+    given-names: Joan
+  - family-names: Bekhti
+    given-names: Yousra
+  - family-names: Leggitt
+    given-names: Alan
+  - family-names: Dykstra
+    given-names: Andrew
+  - family-names: Trachel
+    given-names: Romain
+  - family-names: Luke
+    given-names: Robert
+  - family-names: De Santis
+    given-names: Lorenzo
+  - family-names: Panda
+    given-names: Asish
+  - family-names: Magnuski
+    given-names: Mikołaj
+  - family-names: Westner
+    given-names: Britta
+  - family-names: Wakeman
+    given-names: Dan G
+  - family-names: Strohmeier
+    given-names: Daniel
+  - family-names: Bharadwaj
+    given-names: Hari
+  - family-names: Linzen
+    given-names: Tal
+  - family-names: Barachant
+    given-names: Alexandre
+  - family-names: Ruzich
+    given-names: Emily
+  - family-names: Huberty
+    given-names: Scott
+  - family-names: Bailey
+    given-names: Christopher J
+  - family-names: Li
+    given-names: Adam
+  - family-names: Moutard
+    given-names: Clément
+  - family-names: Bloy
+    given-names: Luke
+  - family-names: Raimondo
+    given-names: Fede
+  - family-names: Nurminen
+    given-names: Jussi
+  - family-names: Billinger
+    given-names: Martin
+  - family-names: Montoya
+    given-names: Jair
+  - family-names: Woodman
+    given-names: Marmaduke
+  - family-names: Lee
+    given-names: Ingoo
+  - family-names: Schulz
+    given-names: Martin
+  - family-names: Foti
+    given-names: Nick
+  - family-names: Nangini
+    given-names: Cathy
+  - family-names: García Alanis
+    given-names: José C
+  - family-names: Binns
+    given-names: Thomas S
+  - family-names: Orfanos
+    given-names: Dimitri Papadopoulos
+  - family-names: Hauk
+    given-names: Olaf
+  - family-names: Maddox
+    given-names: Ross
+  - family-names: LaPlante
+    given-names: Roan
+  - family-names: Drew
+    given-names: Ashley
+  - family-names: Dinh
+    given-names: Christoph
+  - family-names: Dumas
+    given-names: Guillaume
+  - name: Martin
+  - family-names: Benerradi
+    given-names: Johann
+  - family-names: Hartmann
+    given-names: Thomas
+  - family-names: Ort
+    given-names: Eduard
+  - family-names: Billinger
+    given-names: Martin
+  - family-names: Pasler
+    given-names: Paul
+  - family-names: Repplinger
+    given-names: Stefan
+  - family-names: Rudiuk
+    given-names: Alexander
+  - family-names: Radanovic
+    given-names: Ana
+  - family-names: Buran
+    given-names: Brad
+  - family-names: Woessner
+    given-names: Jacob
+  - family-names: Massias
+    given-names: Mathurin
+  - family-names: Hämäläinen
+    given-names: Matti
+  - family-names: Sripad
+    given-names: Praveen
+  - family-names: Chirkov
+    given-names: Valerii
+  - family-names: Mullins
+    given-names: Christopher
+  - family-names: Raimundo
+    given-names: Félix
+  - family-names: Belonosov
+    given-names: Gennadiy
+  - family-names: Kaneda
+    given-names: Michiru
+  - family-names: Alday
+    given-names: Phillip
+  - family-names: Pari
+    given-names: Ram
+  - family-names: Kornblith
+    given-names: Simon
+  - family-names: Halchenko
+    given-names: Yaroslav
+  - family-names: Luo
+    given-names: Yu-Han
+  - family-names: Gramfort
+    given-names: Alexandre
+  - family-names: Kasper
+    given-names: Johannes
+  - family-names: Doelling
+    given-names: Keith
+  - family-names: Jensen
+    given-names: Mads
+  - family-names: Ruuskanen
+    given-names: Santeri
+  - family-names: Kern
+    given-names: Simon
+  - family-names: Gahlot
+    given-names: Tanay
+  - family-names: Nunes
+    given-names: Adonay
+  - family-names: Gütlin
+    given-names: Dirk
+  - family-names: Heinila
+    given-names: Erkka
+  - family-names: Armeni
+    given-names: Kristijan
+  - name: kjs
+  - family-names: Weinstein
+    given-names: Alejandro
+  - family-names: Lamus
+    given-names: Camilo
+  - family-names: Galván
+    given-names: Catalina María
+  - family-names: Moënne-Loccoz
+    given-names: Cristóbal
+  - family-names: Altukhov
+    given-names: Dmitrii
+  - family-names: Peterson
+    given-names: Erica
+  - family-names: Hanna
+    given-names: Jevri
+  - family-names: Houck
+    given-names: Jon
+  - family-names: Klein
+    given-names: Natalie
+  - family-names: Roujansky
+    given-names: Paul
+  - family-names: Luke
+    given-names: Rob
+  - family-names: Rantala
+    given-names: Antti
+  - family-names: Maess
+    given-names: Burkhard
+  - family-names: Forster
+    given-names: Carina
+  - family-names: O'Reilly
+    given-names: Christian
+  - family-names: Welke
+    given-names: Dominik
+  - family-names: Welke
+    given-names: Dominik
+  - family-names: Kolkhorst
+    given-names: Henrich
+  - family-names: Banville
+    given-names: Hubert
+  - family-names: Zhang
+    given-names: Jack
+  - family-names: Maksymenko
+    given-names: Kostiantyn
+  - family-names: Clarke
+    given-names: Maggie
+  - family-names: Anelli
+    given-names: Matteo
+  - family-names: Straube
+    given-names: Michael
+  - family-names: Chapochnikov
+    given-names: Nikolai
+  - family-names: Bannier
+    given-names: Pierre-Antoine
+  - family-names: Choudhary
+    given-names: Saket
+  - family-names: Férat
+    given-names: Victor
+  - family-names: Kim
+    given-names: Cora
+  - family-names: Klotzsche
+    given-names: Felix
+  - family-names: Wong
+    given-names: Fu-Te
+  - family-names: Kojcic
+    given-names: Ivana
+  - family-names: Nielsen
+    given-names: Jesper Duemose
+  - family-names: Lankinen
+    given-names: Kaisu
+  - family-names: Tabavi
+    given-names: Kambiz
+  - family-names: Thibault
+    given-names: Louis
+  - family-names: Gerster
+    given-names: Moritz
+  - family-names: Alibou
+    given-names: Nabil
+  - family-names: Gayraud
+    given-names: Nathalie
+  - family-names: Ward
+    given-names: Nick
+  - family-names: Chu
+    given-names: Qian
+  - family-names: Herbst
+    given-names: Sophie
+  - family-names: Ma
+    given-names: Tom
+  - family-names: Radanovic
+    given-names: Ana
+  - family-names: Quinn
+    given-names: Andrew
+  - family-names: Gauthier
+    given-names: Antoine
+  - family-names: Pinsard
+    given-names: Basile
+  - family-names: Stephen
+    given-names: Emily
+  - family-names: Hornberger
+    given-names: Erik
+  - family-names: Hathaway
+    given-names: Evan
+  - family-names: Kalenkovich
+    given-names: Evgenii
+  - family-names: Mamashli
+    given-names: Fahimeh
+  - family-names: O'Neill
+    given-names: George
+  - family-names: Marinato
+    given-names: Giorgio
+  - family-names: Anevar
+    given-names: Hafeza
+  - family-names: Abdelhedi
+    given-names: Hamza
+  - family-names: Sosulski
+    given-names: Jan
+  - family-names: Stout
+    given-names: Jeff
+  - family-names: Calder-Travis
+    given-names: Joshua
+  - family-names: Zhu
+    given-names: Judy D
+  - family-names: Eisenman
+    given-names: Larry
+  - family-names: Esch
+    given-names: Lorenz
+  - family-names: Dovgialo
+    given-names: Marian
+  - family-names: Barascud
+    given-names: Nicolas
+  - family-names: Legrand
+    given-names: Nicolas
+  - family-names: Kapralov
+    given-names: Nikolai
+  - family-names: Molfese
+    given-names: Peter J
+  - family-names: Falach
+    given-names: Rotem
+  - family-names: Deslauriers-Gauthier
+    given-names: Samuel
+  - family-names: Cotroneo
+    given-names: Silvia
+  - family-names: Matindi
+    given-names: Steve
+  - family-names: Bierer
+    given-names: Steven
+  - family-names: Papadopoulo
+    given-names: Theodore
+  - family-names: Binns
+    given-names: Thomas Samuel
+  - family-names: Stenner
+    given-names: Tristan
+  - family-names: Peterson
+    given-names: Victoria
+  - family-names: Baratz
+    given-names: Zvi
+  - family-names: Tonin
+    given-names: Alessandro
+  - family-names: Kovrig
+    given-names: Alexander
+  - family-names: Pascarella
+    given-names: Annalisa
+  - family-names: Karekal
+    given-names: Apoorva
+  - family-names: Aristimunha
+    given-names: Bruno
+  - family-names: de la Torre
+    given-names: Carlos
+  - family-names: Gohil
+    given-names: Chetan
+  - family-names: Zhao
+    given-names: Christina
+  - family-names: Krzemiński
+    given-names: Dominik
+  - family-names: Makowski
+    given-names: Dominique
+  - family-names: Mikulan
+    given-names: Ezequiel
+  - family-names: Hofer
+    given-names: Florian
+  - family-names: Ritz
+    given-names: Harrison
+  - family-names: Schiratti
+    given-names: Jean-Baptiste
+  - family-names: Evans
+    given-names: Jen
+  - family-names: Herforth
+    given-names: Johannes
+  - family-names: Veillette
+    given-names: John
+  - family-names: Drew
+    given-names: Jordan
+  - family-names: Teves
+    given-names: Joshua
+  - family-names: Mathewson
+    given-names: Kyle
+  - family-names: Gwilliams
+    given-names: Laura
+  - family-names: Lementec
+    given-names: Laurent
+  - family-names: Varghese
+    given-names: Lenny
+  - family-names: Hamilton
+    given-names: Liberty
+  - family-names: Gemein
+    given-names: Lukas
+  - family-names: Hecker
+    given-names: Lukas
+  - name: Lx37
+  - family-names: van Es
+    given-names: Mats
+  - family-names: Boggess
+    given-names: Matt
+  - family-names: Eberlein
+    given-names: Matthias
+  - family-names: Žák
+    given-names: Michal
+  - family-names: Sherif
+    given-names: Mohamed
+  - family-names: Kozhemiako
+    given-names: Nataliia
+  - family-names: Srinivasan
+    given-names: Naveen
+  - family-names: Wilming
+    given-names: Niklas
+  - family-names: Kozynets
+    given-names: Oleh
+  - family-names: Ablin
+    given-names: Pierre
+  - family-names: Das
+    given-names: Proloy
+  - family-names: Bertrand
+    given-names: Quentin
+  - family-names: Shoorangiz
+    given-names: Reza
+  - family-names: Scholz
+    given-names: Richard
+  - family-names: Hübner
+    given-names: Rodrigo
+  - family-names: Sommariva
+    given-names: Sara
+  - family-names: Er
+    given-names: Sena
+  - family-names: Khan
+    given-names: Sheraz
+  - family-names: Datta
+    given-names: Sumalyo
+  - family-names: Donoghue
+    given-names: Thomas
+  - family-names: Jochmann
+    given-names: Thomas
+  - family-names: Merk
+    given-names: Timon
+  - family-names: Flak
+    given-names: Tod
+  - family-names: Dupré la Tour
+    given-names: Tom
+  - family-names: NessAiver
+    given-names: Tziona
+  - name: akshay0724
+  - name: sviter
+  - family-names: Earle-Richardson
+    given-names: Aaron
+  - family-names: Hindle
+    given-names: Abram
+  - family-names: Koutsou
+    given-names: Achilleas
+  - family-names: Fecker
+    given-names: Adeline
+  - family-names: Wagner
+    given-names: Adina
+  - family-names: Ciok
+    given-names: Alex
+  - family-names: Lepauvre
+    given-names: Alex
+  - family-names: Kiefer
+    given-names: Alexander
+  - family-names: Gilbert
+    given-names: Andy
+  - family-names: Pradhan
+    given-names: Aniket
+  - family-names: Padee
+    given-names: Anna
+  - family-names: Dubarry
+    given-names: Anne-Sophie
+  - family-names: Collas
+    given-names: Antoine
+  - family-names: Waniek
+    given-names: Anton Nikolas
+  - family-names: Singhal
+    given-names: Archit
+  - family-names: Rokem
+    given-names: Ariel
+  - family-names: Pelzer
+    given-names: Arne
+  - family-names: Hurst
+    given-names: Austin
+  - family-names: Jin
+    given-names: Beige Jerry
+  - family-names: Beasley
+    given-names: Ben
+  - family-names: Nicenboim
+    given-names: Bruno
+  - family-names: de la Torre
+    given-names: Carlos
+  - family-names: Clauss
+    given-names: Christian
+  - family-names: Mista
+    given-names: Christian
+  - family-names: Kechris
+    given-names: Christodoulos
+  - family-names: Li
+    given-names: Chun-Hui
+  - family-names: Braboszcz
+    given-names: Claire
+  - family-names: Schad
+    given-names: Daniel C
+  - family-names: Hasegan
+    given-names: Daniel
+  - family-names: Tse
+    given-names: Daniel
+  - family-names: Sleiter
+    given-names: Darin Erat
+  - family-names: Haslacher
+    given-names: David
+  - family-names: Sabbagh
+    given-names: David
+  - family-names: Kostas
+    given-names: Demetres
+  - family-names: Petkova
+    given-names: Desislava
+  - family-names: Issagaliyeva
+    given-names: Dinara
+  - family-names: Das
+    given-names: Diptyajit
+  - family-names: Wetzel
+    given-names: Dominik
+  - family-names: Eich
+    given-names: Eberhard
+  - family-names: DuPre
+    given-names: Elizabeth
+  - family-names: Lau
+    given-names: Ellen
+  - family-names: Olivetti
+    given-names: Emanuele
+  - family-names: Zhang
+    given-names: Emma
+  - family-names: Ferdman
+    given-names: Emmanuel
+  - family-names: Çelik
+    given-names: Emrecan
+  - family-names: Varano
+    given-names: Enrico
+  - family-names: Altamiranda
+    given-names: Enzo
+  - family-names: Brayet
+    given-names: Eric
+  - family-names: de Montalivet
+    given-names: Etienne
+  - family-names: Goldstein
+    given-names: Evgeny
+  - family-names: Mamashli
+    given-names: Fahimeh
+  - family-names: Negahbani
+    given-names: Farzin
+  - family-names: Zamberlan
+    given-names: Federico
+  - family-names: Pop
+    given-names: Florin
+  - family-names: Weber
+    given-names: Frederik D
+  - family-names: Tan
+    given-names: Gansheng
+  - family-names: Brookshire
+    given-names: Geoff
+  - family-names: O'Neill
+    given-names: George
+  - name: Giulio
+  - family-names: Reina
+    given-names: Gonzalo
+  - family-names: Maymandi
+    given-names: Hamid
+  - family-names: Arzoo
+    given-names: Hasrat Ali
+  - family-names: Sonntag
+    given-names: Hermann
+  - family-names: Ye
+    given-names: Hongjiang
+  - family-names: Shin
+    given-names: Hyonyoung
+  - family-names: Elmas
+    given-names: Hüseyin Orkun
+  - family-names: AZZ
+    given-names: Ilian
+  - family-names: Machairas
+    given-names: Ilias
+  - family-names: Zubarev
+    given-names: Ivan
+  - family-names: de Jong
+    given-names: Ivo
+  - family-names: Phelan
+    given-names: Jacob
+  - family-names: Kaczmarzyk
+    given-names: Jakub
+  - family-names: Zerfowski
+    given-names: Jan
+  - family-names: van den Bosch
+    given-names: Jasper J F
+  - family-names: Van Der Donckt
+    given-names: Jeroen
+  - family-names: van der Meer
+    given-names: Johan
+  - family-names: Niediek
+    given-names: Johannes
+  - family-names: Koen
+    given-names: Josh
+  - family-names: Bear
+    given-names: Joshua J
+  - family-names: Dammers
+    given-names: Juergen
+  - family-names: Galán
+    given-names: Julia Guiomar Niso
+  - family-names: Welzel
+    given-names: Julius
+  - family-names: Slama
+    given-names: Katarina
+  - family-names: Al-Amir
+    given-names: Katia
+  - family-names: Leinweber
+    given-names: Katrin
+  - family-names: Grabot
+    given-names: Laetitia
+  - family-names: Andersen
+    given-names: Lau Møller
+  - family-names: Almeida
+    given-names: Leonardo Rochael
+  - family-names: Barbosa
+    given-names: Leonardo S
+  - family-names: Alfine
+    given-names: Lorenzo
+  - family-names: Hejtmánek
+    given-names: Lukáš
+  - family-names: Balatsko
+    given-names: Maksym
+  - family-names: Kitzbichler
+    given-names: Manfred
+  - family-names: Kumar
+    given-names: Manoj
+  - family-names: Kadwani
+    given-names: Manorama
+  - family-names: Sutela
+    given-names: Manu
+  - family-names: Koculak
+    given-names: Marcin
+  - family-names: Henney
+    given-names: Mark
+  - family-names: BaBer
+    given-names: Martin
+  - family-names: Oberg
+    given-names: Martin
+  - family-names: van Harmelen
+    given-names: Martin
+  - family-names: Scheltienne
+    given-names: Mathieu
+  - family-names: Courtemanche
+    given-names: Matt
+  - family-names: Tucker
+    given-names: Matt
+  - family-names: Visconti di Oleggio Castello
+    given-names: Matteo
+  - family-names: Dold
+    given-names: Matthias
+  - family-names: Toivonen
+    given-names: Matti
+  - family-names: Shader
+    given-names: Maureen
+  - family-names: Cespedes
+    given-names: Mauricio
+  - family-names: Krause
+    given-names: Michael
+  - family-names: Rybář
+    given-names: Milan
+  - family-names: He
+    given-names: Mingjian
+  - family-names: Daneshzand
+    given-names: Mohammad
+  - name: Mojackhak
+  - family-names: Fourcaud-Trocmé
+    given-names: Nicolas
+  - family-names: Gensollen
+    given-names: Nicolas
+  - family-names: Proulx
+    given-names: Nicole
+  - family-names: Focke
+    given-names: Niels
+  - family-names: Chalas
+    given-names: Nikolas
+  - family-names: Markowitz
+    given-names: Noah
+  - family-names: Shubi
+    given-names: Omer
+  - family-names: Mainar
+    given-names: Pablo
+  - family-names: Sundaram
+    given-names: Padma
+  - family-names: Anders
+    given-names: Paul
+  - family-names: Silva
+    given-names: Pedro
+  - family-names: Guetschel
+    given-names: Pierre
+  - family-names: Li
+    given-names: Quanliang
+  - family-names: Barthélemy
+    given-names: Quentin
+  - family-names: Nadkarni
+    given-names: Rahul
+  - family-names: Gatti
+    given-names: Ramiro
+  - family-names: Apariciogarcia
+    given-names: Ramonapariciog
+  - family-names: Aagaard
+    given-names: Rasmus
+  - family-names: Nasri
+    given-names: Reza
+  - family-names: Koehler
+    given-names: Richard
+  - family-names: Stargardsky
+    given-names: Riessarius
+  - family-names: Oostenveld
+    given-names: Robert
+  - family-names: Seymour
+    given-names: Robert
+  - family-names: Schirrmeister
+    given-names: Robin Tibor
+  - family-names: Jin
+    given-names: Rongfei
+  - family-names: Wieske
+    given-names: Roy Eric
+  - family-names: Law
+    given-names: Ryan
+  - family-names: Pai
+    given-names: Sagun
+  - family-names: Perry
+    given-names: Sam
+  - family-names: Louviot
+    given-names: Samuel
+  - family-names: Martínez
+    given-names: Santi
+  - family-names: Saha
+    given-names: Sawradip
+  - family-names: Mathot
+    given-names: Sebastiaan
+  - family-names: Jentschke
+    given-names: Sebastian
+  - family-names: Major
+    given-names: Sebastian
+  - family-names: Treguer
+    given-names: Sebastien
+  - family-names: Castaño
+    given-names: Sebastián
+  - family-names: Deng
+    given-names: Senwen
+  - family-names: Antopolskiy
+    given-names: Sergey
+  - family-names: Shirazi
+    given-names: Seyed (Yahya)
+  - family-names: Keshari
+    given-names: Shresth
+  - family-names: Baral
+    given-names: Shristi
+  - family-names: Baral
+    given-names: Shristi
+  - family-names: Wong
+    given-names: Simeon
+  - family-names: Wong
+    given-names: Simeon
+  - family-names: Hofmann
+    given-names: Simon M
+  - family-names: Poil
+    given-names: Simon-Shlomo
+  - family-names: Foslien
+    given-names: Sondre
+  - family-names: Singh
+    given-names: Sourav
+  - family-names: Chambon
+    given-names: Stanislas
+  - family-names: Magnússon
+    given-names: Steinn Hauser
+  - family-names: Bethard
+    given-names: Steven
+  - family-names: Gutstein
+    given-names: Steven M
+  - family-names: Meyer
+    given-names: Svea Marie
+  - family-names: Wang
+    given-names: T
+  - family-names: Jayawardana
+    given-names: Tharupahan
+  - family-names: Moreau
+    given-names: Thomas
+  - family-names: Radman
+    given-names: Thomas
+  - family-names: Gates
+    given-names: Timothy
+  - family-names: Stone
+    given-names: Tom
+  - family-names: Clausner
+    given-names: Tommy
+  - family-names: Anijärv
+    given-names: Toomas Erik
+  - family-names: Kumaravel
+    given-names: Velu Prabhakar
+  - family-names: Xu
+    given-names: Wei
+  - family-names: Turner
+    given-names: Will
+  - family-names: Zuazo
+    given-names: Xabier de
+  - family-names: Xia
+    given-names: Xiaokai
+  - family-names: Zuo
+    given-names: Yiping
+  - family-names: Shen
+    given-names: Yixiao
+  - family-names: Truong
+    given-names: Young
+  - family-names: Zhang
+    given-names: Zhi
+  - family-names: ZENG
+    given-names: Ziyi
+  - name: btkcodedev
+  - name: buildqa
+  - name: luzpaz
+  - name: user27182
+preferred-citation:
+  title: "MEG and EEG Data Analysis with MNE-Python"
+  journal: "Frontiers in Neuroscience"
+  type: article
+  year: 2013
+  volume: 7
+  issue: 267
+  start: 1
+  end: 13
+  doi: 10.3389/fnins.2013.00267
+  authors:
+    - family-names: Gramfort
+      given-names: Alexandre
+    - family-names: Luessi
+      given-names: Martin
+    - family-names: Larson
+      given-names: Eric
+    - family-names: Engemann
+      given-names: Denis A.
+    - family-names: Strohmeier
+      given-names: Daniel
+    - family-names: Brodbeck
+      given-names: Christian
+    - family-names: Goj
+      given-names: Roman
+    - family-names: Jas
+      given-names: Mainak
+    - family-names: Brooks
+      given-names: Teon
+    - family-names: Parkkonen
+      given-names: Lauri
+    - family-names: Hämäläinen
+      given-names: Matti S.

mne-python/source/CONTRIBUTING.md

@@ -0,0 +1,9 @@
+Contributing to MNE-Python
+==========================
+
+MNE-Python is maintained by a community of scientists and research labs. The project accepts contributions in the form of bug reports, fixes, feature additions, and documentation improvements (including typo corrections). The best way to start contributing is by [opening an issue](https://github.com/mne-tools/mne-python/issues/new/choose) on our GitHub page to discuss ideas for changes or enhancements, or to tell us about behavior that you think might be a bug. For *general troubleshooting* or *usage questions*, please consider posting your questions on our [MNE Forum](https://mne.discourse.group).
+
+Users and contributors to MNE-Python are expected to follow our [code of conduct](https://github.com/mne-tools/.github/blob/main/CODE_OF_CONDUCT.md).
+
+The [contributing guide](https://mne.tools/dev/development/contributing.html) has details on the preferred contribution workflow
+and the recommended system configuration for a smooth contribution/development experience.

mne-python/source/LICENSE.txt

@@ -0,0 +1,11 @@
+Copyright 2011-2025 MNE-Python authors
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

mne-python/source/Makefile

@@ -0,0 +1,62 @@
+# simple makefile to simplify repetitive build env management tasks under posix
+
+PYTHON ?= python
+PYTESTS ?= py.test
+CODESPELL_SKIPS ?= "doc/_build,doc/auto_*,*.fif,*.eve,*.gz,*.tgz,*.zip,*.mat,*.stc,*.label,*.w,*.bz2,*.annot,*.sulc,*.log,*.local-copy,*.orig_avg,*.inflated_avg,*.gii,*.pyc,*.doctree,*.pickle,*.inv,*.png,*.edf,*.touch,*.thickness,*.nofix,*.volume,*.defect_borders,*.mgh,lh.*,rh.*,COR-*,FreeSurferColorLUT.txt,*.examples,.xdebug_mris_calc,bad.segments,BadChannels,*.hist,empty_file,*.orig,*.js,*.map,*.ipynb,searchindex.dat,install_mne_c.rst,plot_*.rst,*.rst.txt,c_EULA.rst*,*.html,gdf_encodes.txt,*.svg,references.bib,*.css,*.edf,*.bdf,*.vhdr"
+CODESPELL_DIRS ?= mne/ doc/ tutorials/ examples/
+all: clean test-doc
+
+clean-pyc:
+	find . -name "*.pyc" | xargs rm -f
+
+clean-so:
+	find . -name "*.so" | xargs rm -f
+	find . -name "*.pyd" | xargs rm -f
+
+clean-build:
+	rm -rf build dist
+
+clean-ctags:
+	rm -f tags
+
+clean-cache:
+	find . -name "__pycache__" | xargs rm -rf
+
+clean: clean-build clean-pyc clean-so clean-ctags clean-cache
+
+wheel:
+	$(PYTHON) -m build -w
+
+sample_data:
+	@python -c "import mne; mne.datasets.sample.data_path(verbose=True);"
+
+testing_data:
+	@python -c "import mne; mne.datasets.testing.data_path(verbose=True);"
+
+test-no-network: in
+	sudo unshare -n -- sh -c 'MNE_SKIP_NETWORK_TESTS=1 py.test mne'
+
+test-no-testing-data: in
+	@MNE_SKIP_TESTING_DATASET_TESTS=true \
+	$(PYTESTS) mne
+
+test-doc: sample_data testing_data
+	$(PYTESTS) --tb=short --cov=mne --cov-report=xml --cov-branch --doctest-modules --doctest-ignore-import-errors --doctest-glob='*.rst' ./doc/ --ignore=./doc/auto_examples --ignore=./doc/auto_tutorials --ignore=./doc/_build --ignore=./doc/conf.py --ignore=doc/sphinxext --fulltrace
+
+pre-commit:
+	@pre-commit run -a --show-diff-on-failure
+
+# Aliases for stuff we used to support or users might think of
+ruff: pre-commit
+flake: pre-commit
+pep: pre-commit
+
+codespell:  # running manually
+	@codespell --builtin clear,rare,informal,names,usage -w -i 3 -q 3 -S $(CODESPELL_SKIPS) --ignore-words=ignore_words.txt --uri-ignore-words-list=bu $(CODESPELL_DIRS)
+
+check-readme: clean wheel
+	twine check dist/*
+
+nesting:
+	@echo "Running import nesting tests"
+	@$(PYTESTS) mne/tests/test_import_nesting.py

mne-python/source/README.rst

@@ -0,0 +1,144 @@
+.. -*- mode: rst -*-
+
+|MNE|
+
+MNE-Python
+==========
+
+MNE-Python is an open-source Python package for exploring,
+visualizing, and analyzing human neurophysiological data such as MEG, EEG, sEEG,
+ECoG, and more. It includes modules for data input/output, preprocessing,
+visualization, source estimation, time-frequency analysis, connectivity analysis,
+machine learning, statistics, and more.
+
+
+Documentation
+^^^^^^^^^^^^^
+
+`Documentation`_ for MNE-Python encompasses installation instructions, tutorials,
+and examples for a wide variety of topics, contributing guidelines, and an API
+reference.
+
+
+Forum
+^^^^^^
+
+The `user forum`_ is the best place to ask questions about MNE-Python usage or
+the contribution process. The forum also features job opportunities and other
+announcements.
+
+If you find a bug or have an idea for a new feature that should be added to
+MNE-Python, please use the
+`issue tracker <https://github.com/mne-tools/mne-python/issues/new/choose>`__ of
+our GitHub repository.
+
+
+Installation
+^^^^^^^^^^^^
+
+To install the latest stable version of MNE-Python with minimal dependencies
+only, use pip_ in a terminal:
+
+.. code-block:: console
+
+    $ pip install --upgrade mne
+
+For more complete instructions, including our standalone installers and more
+advanced installation methods, please refer to the `installation guide`_.
+
+
+Get the development version
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To install the latest development version of MNE-Python using pip_, open a
+terminal and type:
+
+.. code-block:: console
+
+    $ pip install --upgrade https://github.com/mne-tools/mne-python/archive/refs/heads/main.zip
+
+To clone the repository with `git <https://git-scm.com/>`__, open a terminal
+and type:
+
+.. code-block:: console
+
+    $ git clone https://github.com/mne-tools/mne-python.git
+
+
+Dependencies
+^^^^^^^^^^^^
+
+The minimum required dependencies to run MNE-Python are:
+
+.. ↓↓↓ BEGIN CORE DEPS LIST. DO NOT EDIT! HANDLED BY PRE-COMMIT HOOK ↓↓↓
+
+- `Python <https://www.python.org>`__ ≥ 3.10
+- `NumPy <https://numpy.org>`__ ≥ 1.26
+- `SciPy <https://scipy.org>`__ ≥ 1.11
+- `Matplotlib <https://matplotlib.org>`__ ≥ 3.8
+- `Pooch <https://www.fatiando.org/pooch/latest/>`__ ≥ 1.5
+- `tqdm <https://tqdm.github.io>`__
+- `Jinja2 <https://palletsprojects.com/p/jinja/>`__
+- `decorator <https://github.com/micheles/decorator>`__
+- `lazy-loader <https://pypi.org/project/lazy_loader>`__ ≥ 0.3
+- `packaging <https://packaging.pypa.io/en/stable/>`__
+
+.. ↑↑↑ END CORE DEPS LIST. DO NOT EDIT! HANDLED BY PRE-COMMIT HOOK ↑↑↑
+
+Contributing
+^^^^^^^^^^^^
+
+Please see the `contributing guidelines <https://mne.tools/dev/development/contributing.html>`__ on our documentation website.
+
+
+About
+^^^^^
+
++---------+------------+----------------+
+| CI      | |Codecov|  | |Bandit|       |
++---------+------------+----------------+
+| Package | |PyPI|     | |conda-forge|  |
++---------+------------+----------------+
+| Docs    | |Docs|     | |Discourse|    |
++---------+------------+----------------+
+| Meta    | |Zenodo|   | |OpenSSF|      |
++---------+------------+----------------+
+
+
+License
+^^^^^^^
+
+MNE-Python is licensed under the BSD-3-Clause license.
+
+
+.. _Documentation: https://mne.tools/dev/
+.. _user forum: https://mne.discourse.group
+.. _installation guide: https://mne.tools/dev/install/index.html
+.. _pip: https://pip.pypa.io/en/stable/
+
+.. |PyPI| image:: https://img.shields.io/pypi/dm/mne.svg?label=PyPI
+   :target: https://pypi.org/project/mne/
+
+.. |conda-forge| image:: https://img.shields.io/conda/dn/conda-forge/mne.svg?label=Conda
+   :target: https://anaconda.org/conda-forge/mne
+
+.. |Docs| image:: https://img.shields.io/badge/Docs-online-green?label=Documentation
+   :target: https://mne.tools/dev/
+
+.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.592483.svg
+   :target: https://doi.org/10.5281/zenodo.592483
+
+.. |Discourse| image:: https://img.shields.io/discourse/status?label=Forum&server=https%3A%2F%2Fmne.discourse.group%2F
+   :target: https://mne.discourse.group/
+
+.. |Codecov| image:: https://img.shields.io/codecov/c/github/mne-tools/mne-python?label=Coverage
+   :target: https://codecov.io/gh/mne-tools/mne-python
+
+.. |Bandit| image:: https://img.shields.io/badge/Security-Bandit-yellow.svg
+   :target: https://github.com/PyCQA/bandit
+
+.. |OpenSSF| image:: https://www.bestpractices.dev/projects/7783/badge
+   :target: https://www.bestpractices.dev/projects/7783
+
+.. |MNE| image:: https://mne.tools/dev/_static/mne_logo_gray.svg
+   :target: https://mne.tools/dev/

mne-python/source/SECURITY.md

@@ -0,0 +1,30 @@
+# Security Policy
+
+## Supported Versions
+
+New minor versions of MNE-Python are typically released twice per year.
+Only the most current stable release is officially supported.
+The unreleased, unstable "dev version" is also supported, though users
+should beware that the API of the dev version is subject to change
+without a proper 6-month deprecation cycle.
+
+| Version | Supported                |
+| ------- | ------------------------ |
+| 1.12.x  | :heavy_check_mark: (dev) |
+| 1.11.x  | :heavy_check_mark:       |
+| < 1.11  | :x:                      |
+
+## Reporting a Vulnerability
+
+MNE-Python is software for analysis and visualization of brain activity
+recorded with a variety of devices/modalities (EEG, MEG, ECoG, fNIRS, etc).
+It is not expected that using MNE-Python will lead to security
+vulnerabilities under normal use cases (i.e., running without administrator
+privileges). However, if you think you have found a security vulnerability
+in MNE-Python, **please do not report it as a GitHub issue**, in order to
+keep the vulnerability confidential. Instead, please report it to
+mne-core-dev-team@groups.io and include a description and proof-of-concept
+that is [short and self-contained](http://www.sscce.org/).
+
+Generally you will receive a response within one week. MNE-Python does not
+award bounties for security vulnerabilities.

mne-python/source/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+"""
+mne-python Project Package Initialization File
+"""

mne-python/source/azure-pipelines.yml

@@ -0,0 +1,303 @@
+trigger:
+  # start a new build for every push
+  batch: false
+  branches:
+    include:
+      - 'main'
+      - 'maint/*'
+pr:
+  branches:
+    include:
+      - '*'  # must quote since "*" is a YAML reserved character; we want a string
+
+
+stages:
+
+  - stage: Check
+    jobs:
+      - job: Skip
+        pool:
+          vmImage: 'ubuntu-latest'
+        variables:
+          DECODE_PERCENTS: 'false'
+          RET: 'true'
+          BUILD_REASON: $(Build.Reason)
+        steps:
+          - bash: |
+              git_log=`git log --format=oneline -n 1 --skip=1`
+              echo "##vso[task.setvariable variable=log]$git_log"
+          - bash: echo "##vso[task.setvariable variable=RET]false"
+            condition: and(eq(variables.BUILD_REASON, 'PullRequest'), or(contains(variables.log, '[skip azp]'), contains(variables.log, '[azp skip]'), contains(variables.log, '[skip ci]'), contains(variables.log, '[ci skip]')))
+          - bash: echo "##vso[task.setvariable variable=start_main;isOutput=true]$RET"
+            name: result
+
+  - stage: Style
+    variables:
+      AZURE_CI: 'true'
+    jobs:
+      - job: All
+        pool:
+          vmImage: 'ubuntu-latest'
+        variables:
+          PYTHON_VERSION: '3.11'
+          PYTHON_ARCH: 'x64'
+        steps:
+          - bash: echo $(COMMIT_MSG)
+          - task: UsePythonVersion@0
+            inputs:
+              versionSpec: $(PYTHON_VERSION)
+              architecture: $(PYTHON_ARCH)
+              addToPath: true
+            displayName: 'Get Python'
+          - bash: |
+              set -eo pipefail
+              python -m pip install --progress-bar off --upgrade pip build
+              python -m pip install --progress-bar off -ve .[hdf5] --group=test
+              python -m pip uninstall -yq pytest-qt  # don't want to set up display, etc. for this
+              pre-commit install --install-hooks
+            displayName: Install dependencies
+          - bash: |
+              make pre-commit
+            displayName: make pre-commit
+            condition: always()
+          - bash: |
+              make nesting
+            displayName: make nesting
+            condition: always()
+          - bash: |
+              make check-readme
+            displayName: make check-readme
+            condition: always()
+          - bash: mypy
+            displayName: mypy
+            condition: always()
+          - bash: vulture
+            displayName: vulture
+            condition: always()
+
+
+  - stage: Test
+    condition: and(succeeded(), eq(dependencies.Check.outputs['Skip.result.start_main'], 'true'))
+    dependsOn: ['Style', 'Check']
+    variables:
+      AZURE_CI: 'true'
+    jobs:
+      - job: Ultraslow_PG
+        pool:
+          vmImage: 'ubuntu-22.04'
+        variables:
+          DISPLAY: ':99'
+          OPENBLAS_NUM_THREADS: '1'
+          OMP_NUM_THREADS: '1'
+          MNE_TEST_ALLOW_SKIP: '^.*(PySide6 causes segfaults).*$'
+          MNE_BROWSER_PRECOMPUTE: 'false'
+        steps:
+          - bash: |
+              set -e
+              ./tools/setup_xvfb.sh
+              sudo apt install -yq tcsh
+            displayName: 'Install Ubuntu dependencies'
+          - bash: |
+              source tools/get_minimal_commands.sh
+            displayName: 'Install minimal commands'
+          - bash: |
+              echo $PATH
+              mne_surf2bem --version
+              fsl_rigid_register --version
+            displayName: 'Test minimal commands'
+          - task: UsePythonVersion@0
+            inputs:
+              versionSpec: '3.12'
+              architecture: 'x64'
+              addToPath: true
+            displayName: 'Get Python'
+          - bash: |
+              set -e
+              python -m pip install --progress-bar off --upgrade pip
+              python -m pip install --progress-bar off "mne-qt-browser[opengl] @ git+https://github.com/mne-tools/mne-qt-browser.git" pyvista scikit-learn python-picard qtpy nibabel sphinx-gallery "PySide6!=6.8.0,!=6.8.0.1,!=6.8.1.1,!=6.9.1" pandas neo pymatreader antio defusedxml curryreader pymef
+              python -m pip uninstall -yq mne
+              python -m pip install --progress-bar off --upgrade -e . --group=test
+            displayName: 'Install dependencies with pip'
+          - bash: |
+              set -e
+              mne sys_info -pd
+              mne sys_info -pd | grep "qtpy .*(PySide6=.*)$"
+            displayName: Print config
+          - bash: |
+              set -e
+              LD_DEBUG=libs python -c "from PySide6.QtWidgets import QApplication, QWidget; app = QApplication([]); import matplotlib; matplotlib.use('QtAgg'); import matplotlib.pyplot as plt; plt.figure()"
+          - bash: source tools/get_testing_version.sh
+            displayName: 'Get testing version'
+          - task: Cache@2
+            inputs:
+              key: $(testing_version)
+              path: /home/vsts/mne_data
+            displayName: 'Cache testing data'
+          - script: python -c "import mne; mne.datasets.testing.data_path(verbose=True)"
+            displayName: 'Get test data'
+          - script: pytest -m "ultraslowtest or pgtest" --tb=short --cov=mne --cov-report=xml -vv mne
+            displayName: 'slow and mne-qt-browser tests'
+          # Coverage
+          - bash: bash <(curl -s https://codecov.io/bash)
+            displayName: 'Codecov'
+            condition: succeededOrFailed()
+          - task: PublishTestResults@2
+            inputs:
+              testResultsFiles: '**/junit-*.xml'
+              testRunTitle: 'Publish test results for $(Agent.JobName)'
+              failTaskOnFailedTests: true
+            condition: succeededOrFailed()
+          - task: PublishCodeCoverageResults@2
+            inputs:
+              summaryFileLocation: '$(System.DefaultWorkingDirectory)/**/coverage.xml'
+
+      - job: Qt
+        pool:
+          vmImage: 'ubuntu-22.04'
+        variables:
+          DISPLAY: ':99'
+          OPENBLAS_NUM_THREADS: '1'
+          TEST_OPTIONS: "--tb=short --cov=mne --cov-report=xml --cov-append -vv mne/viz/_brain mne/viz/backends mne/viz/tests/test_evoked.py mne/gui mne/report"
+          MNE_TEST_ALLOW_SKIP: '^.*(PySide6 causes segfaults).*$'
+        steps:
+          - bash: ./tools/setup_xvfb.sh
+            displayName: 'Install Ubuntu dependencies'
+          - task: UsePythonVersion@0
+            inputs:
+              versionSpec: '3.10'
+              architecture: 'x64'
+              addToPath: true
+            displayName: 'Get Python'
+          - bash: |
+              set -e
+              python -m pip install --progress-bar off --upgrade pip
+              python -m pip install --progress-bar off --upgrade --pre --only-binary=\"numpy,scipy,matplotlib,vtk\" numpy scipy matplotlib vtk
+              python -c "import vtk"
+              python -m pip install --progress-bar off --upgrade -ve .[full] --group=test_extra
+            displayName: 'Install dependencies with pip'
+          - bash: |
+              set -e
+              which mne
+              mne sys_info -pd
+              python ./tools/check_mne_location.py
+            displayName: Print config
+          - bash: source tools/get_testing_version.sh
+            displayName: 'Get testing version'
+          - task: Cache@2
+            inputs:
+              key: $(testing_version)
+              path: /home/vsts/mne_data
+            displayName: 'Cache testing data'
+          - script: python -c "import mne; mne.datasets.testing.data_path(verbose=True)"
+            displayName: 'Get test data'
+          - bash: |
+              set -eo pipefail
+              python -m pip install PyQt6
+              LD_DEBUG=libs python -c "from PyQt6.QtWidgets import QApplication, QWidget; app = QApplication([]); import matplotlib; matplotlib.use('QtAgg'); import matplotlib.pyplot as plt; plt.figure()"
+            displayName: 'Check Qt import'
+          - bash: |
+              set -eo pipefail
+              mne sys_info -pd
+              mne sys_info -pd | grep "qtpy .* (PyQt6=.*)$"
+              PYTEST_QT_API=PyQt6 pytest -m "not ultraslowtest" ${TEST_OPTIONS}
+              python -m pip uninstall -yq PyQt6 PyQt6-sip PyQt6-Qt6
+            displayName: 'PyQt6'
+          - bash: |
+              set -eo pipefail
+              python -m pip install "PySide6!=6.8.0,!=6.8.0.1,!=6.9.1"
+              mne sys_info -pd
+              mne sys_info -pd | grep "qtpy .* (PySide6=.*)$"
+              PYTEST_QT_API=PySide6 pytest -m "not ultraslowtest" ${TEST_OPTIONS}
+              python -m pip uninstall -yq PySide6
+            displayName: 'PySide6'
+          # PyQt5 leaves cruft behind, so run it last
+          - bash: |
+              set -eo pipefail
+              python -m pip install PyQt5
+              mne sys_info -pd
+              mne sys_info -pd | grep "qtpy .* (PyQt5=.*)$"
+              PYTEST_QT_API=PyQt5 pytest -m "not ultraslowtest" ${TEST_OPTIONS}
+              python -m pip uninstall -yq PyQt5 PyQt5-sip PyQt5-Qt5
+            displayName: 'PyQt5'
+          # Coverage
+          - bash: bash <(curl -s https://codecov.io/bash)
+            displayName: 'Codecov'
+            condition: succeededOrFailed()
+          - task: PublishTestResults@2
+            inputs:
+              testResultsFiles: '**/junit-*.xml'
+              testRunTitle: 'Publish test results for $(Agent.JobName)'
+              failTaskOnFailedTests: true
+            condition: succeededOrFailed()
+          - task: PublishCodeCoverageResults@2
+            inputs:
+              summaryFileLocation: '$(System.DefaultWorkingDirectory)/**/coverage.xml'
+
+      - job: Windows
+        pool:
+          vmImage: 'windows-latest'
+        variables:
+          MNE_LOGGING_LEVEL: 'warning'
+          MNE_FORCE_SERIAL: 'true'
+          OPENBLAS_NUM_THREADS: '2'
+          OMP_DYNAMIC: 'false'
+          PYTHONUNBUFFERED: 1
+          PYTHONIOENCODING: 'utf-8'
+          AZURE_CI_WINDOWS: 'true'
+          PYTHON_ARCH: 'x64'
+          MNE_CI_KIND: $(TEST_MODE)
+        timeoutInMinutes: 95
+        strategy:
+          maxParallel: 4
+          matrix:
+            3.10 pip:
+              TEST_MODE: 'pip'
+              PYTHON_VERSION: '3.10'
+            3.13 pip pre:
+              TEST_MODE: 'pip-pre'
+              PYTHON_VERSION: '3.13'
+        steps:
+          - task: UsePythonVersion@0
+            inputs:
+              versionSpec: $(PYTHON_VERSION)
+              architecture: $(PYTHON_ARCH)
+              addToPath: true
+            displayName: 'Get Python'
+          - bash: |
+              set -eo pipefail
+              git clone --depth 1 https://github.com/pyvista/setup-headless-display-action.git
+              MESA3D_VERSION=24.3.0 bash setup-headless-display-action/windows/install_opengl.sh
+            displayName: Install OpenGL
+          - bash: ./tools/azure_dependencies.sh
+            displayName: Install dependencies with pip
+          - script: pip install -e .
+            displayName: 'Install MNE-Python dev'
+          - script: mne sys_info -pd
+            displayName: 'Print config'
+          - script: python -c "import numpy; numpy.show_config()"
+            displayName: Print NumPy config
+          - script: python -c "import numpy; import scipy.linalg; import sklearn.neighbors; from threadpoolctl import threadpool_info; from pprint import pprint; pprint(threadpool_info())"
+            displayName: Print threadpoolctl info
+          - bash: source tools/get_testing_version.sh
+            displayName: 'Get testing version'
+          - task: Cache@2
+            inputs:
+              key: $(testing_version)
+              path: C:\Users\VssAdministrator\mne_data
+            displayName: 'Cache testing data'
+          - script: python -c "import mne; mne.datasets.testing.data_path(verbose=True)"
+            displayName: 'Get test data'
+          - script: pytest -m "not (slowtest or pgtest)" --tb=short --cov=mne --cov-report=xml -vv mne
+            displayName: 'Run tests'
+          - bash: bash <(curl -s https://codecov.io/bash)
+            displayName: 'Codecov'
+            condition: succeededOrFailed()
+          - task: PublishTestResults@2
+            inputs:
+              testResultsFiles: '**/junit-*.xml'
+              testRunTitle: 'Publish test results for $(Agent.JobName) $(TEST_MODE) $(PYTHON_VERSION)'
+              failTaskOnFailedTests: true
+            condition: succeededOrFailed()
+          - task: PublishCodeCoverageResults@2
+            inputs:
+              summaryFileLocation: '$(System.DefaultWorkingDirectory)/**/coverage.xml'

mne-python/source/codecov.yml

@@ -0,0 +1,25 @@
+comment: false
+github_checks:  # too noisy, even though "a" interactively disables them
+  annotations: false
+
+codecov:
+  notify:
+    require_ci_to_pass: false
+
+coverage:
+  status:
+    patch:
+      default:
+        informational: true
+        target: 95%
+        if_no_uploads: error
+        if_not_found: success
+        if_ci_failed: failure
+    project:
+      default: false
+      library:
+        informational: true
+        target: 90%
+        if_no_uploads: error
+        if_not_found: success
+        if_ci_failed: failure

mne-python/source/codemeta.json

@@ -0,0 +1,2555 @@
+{
+    "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
+    "@type": "SoftwareSourceCode",
+    "license": "https://spdx.org/licenses/BSD-3-Clause",
+    "codeRepository": "git+https://github.com/mne-tools/mne-python.git",
+    "dateCreated": "2010-12-26",
+    "datePublished": "2014-08-04",
+    "dateModified": "2025-11-21",
+    "downloadUrl": "https://github.com/mne-tools/mne-python/archive/v1.11.0.zip",
+    "issueTracker": "https://github.com/mne-tools/mne-python/issues",
+    "name": "MNE-Python",
+    "version": "1.11.0",
+    "description": "MNE-Python is an open-source Python package for exploring, visualizing, and analyzing human neurophysiological data. It provides methods for data input/output, preprocessing, visualization, source estimation, time-frequency analysis, connectivity analysis, machine learning, and statistics.",
+    "applicationCategory": "Neuroscience",
+    "developmentStatus": "active",
+    "referencePublication": "https://doi.org/10.3389/fnins.2013.00267",
+    "keywords": [
+        "MEG",
+        "magnetoencephalography",
+        "EEG",
+        "electroencephalography",
+        "fNIRS",
+        "functional near-infrared spectroscopy",
+        "iEEG",
+        "intracranial EEG",
+        "eCoG",
+        "electrocorticography",
+        "DBS",
+        "deep brain stimulation"
+    ],
+    "programmingLanguage": [
+        "Python"
+    ],
+    "operatingSystem": [
+        "Linux",
+        "Windows",
+        "macOS"
+    ],
+    "softwareRequirements": [
+        "python>= 3.10",
+        "decorator",
+        "jinja2",
+        "lazy_loader >= 0.3",
+        "matplotlib >= 3.8",
+        "numpy >= 1.26, < 3",
+        "packaging",
+        "pooch >= 1.5",
+        "scipy >= 1.11",
+        "tqdm"
+    ],
+    "author": [
+        {
+           "@type":"Person",
+           "email":"larson.eric.d@gmail.com",
+           "givenName":"Eric",
+           "familyName": "Larson"
+        },
+        {
+           "@type":"Person",
+           "email":"alexandre.gramfort@inria.fr",
+           "givenName":"Alexandre",
+           "familyName": "Gramfort"
+        },
+        {
+           "@type":"Person",
+           "email":"denis.engemann@gmail.com",
+           "givenName":"Denis A",
+           "familyName": "Engemann"
+        },
+        {
+           "@type":"Person",
+           "email":"jaeilepp@gmail.com",
+           "givenName":"Jaakko",
+           "familyName": "Leppakangas"
+        },
+        {
+           "@type":"Person",
+           "email":"christianmbrodbeck@gmail.com",
+           "givenName":"Christian",
+           "familyName": "Brodbeck"
+        },
+        {
+           "@type":"Person",
+           "email":"mainakjas@gmail.com",
+           "givenName":"Mainak",
+           "familyName": "Jas"
+        },
+        {
+           "@type":"Person",
+           "email":"teon.brooks@gmail.com",
+           "givenName":"Teon L",
+           "familyName": "Brooks"
+        },
+        {
+           "@type":"Person",
+           "email":"jona.sassenhagen@gmail.com",
+           "givenName":"Jona",
+           "familyName": "Sassenhagen"
+        },
+        {
+           "@type":"Person",
+           "email":"dan@mccloy.info",
+           "givenName":"Daniel",
+           "familyName": "McCloy"
+        },
+        {
+           "@type":"Person",
+           "email":"mluessi@nmr.mgh.harvard.edu",
+           "givenName":"Martin",
+           "familyName": "Luessi"
+        },
+        {
+           "@type":"Person",
+           "email":"jeanremi.king+github@gmail.com",
+           "givenName":"Jean-Rémi",
+           "familyName": "King"
+        },
+        {
+           "@type":"Person",
+           "email":"richard.hoechenberger@gmail.com",
+           "givenName":"Richard",
+           "familyName": "Höchenberger"
+        },
+        {
+           "@type":"Person",
+           "email":"clemens.brunner@gmail.com",
+           "givenName":"Clemens",
+           "familyName": "Brunner"
+        },
+        {
+           "@type":"Person",
+           "email":"roman.goj@gmail.com",
+           "givenName":"Roman",
+           "familyName": "Goj"
+        },
+        {
+           "@type":"Person",
+           "email":"guillaume.favelier@gmail.com",
+           "givenName":"Guillaume",
+           "familyName": "Favelier"
+        },
+        {
+           "@type":"Person",
+           "email":"w.m.vanvliet@gmail.com",
+           "givenName":"Marijn",
+           "familyName": "van Vliet"
+        },
+        {
+           "@type":"Person",
+           "email":"wronk.mark@gmail.com",
+           "givenName":"Mark",
+           "familyName": "Wronkiewicz"
+        },
+        {
+           "@type":"Person",
+           "email":"stefan.appelhoff@mailbox.org",
+           "givenName":"Stefan",
+           "familyName": "Appelhoff"
+        },
+        {
+           "@type":"Person",
+           "email":"aprockhill206@gmail.com",
+           "givenName":"Alex",
+           "familyName": "Rockhill"
+        },
+        {
+           "@type":"Person",
+           "email":"choldgraf@gmail.com",
+           "givenName":"Chris",
+           "familyName": "Holdgraf"
+        },
+        {
+           "@type":"Person",
+           "email":"mathieu.scheltienne@gmail.com",
+           "givenName":"Mathieu",
+           "familyName": "Scheltienne"
+        },
+        {
+           "@type":"Person",
+           "email":"mailsik@gmail.com",
+           "givenName":"Joan",
+           "familyName": "Massich"
+        },
+        {
+           "@type":"Person",
+           "email":"yousra.bekhti@gmail.com",
+           "givenName":"Yousra",
+           "familyName": "Bekhti"
+        },
+        {
+           "@type":"Person",
+           "email":"leggitta3@gmail.com",
+           "givenName":"Alan",
+           "familyName": "Leggitt"
+        },
+        {
+           "@type":"Person",
+           "email":"andrew.r.dykstra@gmail.com",
+           "givenName":"Andrew",
+           "familyName": "Dykstra"
+        },
+        {
+           "@type":"Person",
+           "email":"romain.trachel@inria.fr",
+           "givenName":"Romain",
+           "familyName": "Trachel"
+        },
+        {
+           "@type":"Person",
+           "email":"code@robertluke.net",
+           "givenName":"Robert",
+           "familyName": "Luke"
+        },
+        {
+           "@type":"Person",
+           "email":"desantis.lnz@gmail.com",
+           "givenName":"Lorenzo",
+           "familyName": "De Santis"
+        },
+        {
+           "@type":"Person",
+           "email":"asishrocks95@gmail.com",
+           "givenName":"Asish",
+           "familyName": "Panda"
+        },
+        {
+           "@type":"Person",
+           "email":"mmagnuski@swps.edu.pl",
+           "givenName":"Mikołaj",
+           "familyName": "Magnuski"
+        },
+        {
+           "@type":"Person",
+           "email":"britta.wstnr@gmail.com",
+           "givenName":"Britta",
+           "familyName": "Westner"
+        },
+        {
+           "@type":"Person",
+           "email":"dgwakeman@gmail.com",
+           "givenName":"Dan G",
+           "familyName": "Wakeman"
+        },
+        {
+           "@type":"Person",
+           "email":"daniel.strohmeier@googlemail.com",
+           "givenName":"Daniel",
+           "familyName": "Strohmeier"
+        },
+        {
+           "@type":"Person",
+           "email":"hari@nmr.mgh.harvard.edu",
+           "givenName":"Hari",
+           "familyName": "Bharadwaj"
+        },
+        {
+           "@type":"Person",
+           "email":"tal.linzen@gmail.com",
+           "givenName":"Tal",
+           "familyName": "Linzen"
+        },
+        {
+           "@type":"Person",
+           "email":"alexandre.barachant@gmail.com",
+           "givenName":"Alexandre",
+           "familyName": "Barachant"
+        },
+        {
+           "@type":"Person",
+           "email":"emilyr@nmr.mgh.harvard.edu",
+           "givenName":"Emily",
+           "familyName": "Ruzich"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Scott",
+           "familyName": "Huberty"
+        },
+        {
+           "@type":"Person",
+           "email":"bailey.cj@gmail.com",
+           "givenName":"Christopher J",
+           "familyName": "Bailey"
+        },
+        {
+           "@type":"Person",
+           "email":"adam2392@gmail.com",
+           "givenName":"Adam",
+           "familyName": "Li"
+        },
+        {
+           "@type":"Person",
+           "email":"clement.moutard@gmail.com",
+           "givenName":"Clément",
+           "familyName": "Moutard"
+        },
+        {
+           "@type":"Person",
+           "email":"luke.bloy@gmail.com",
+           "givenName":"Luke",
+           "familyName": "Bloy"
+        },
+        {
+           "@type":"Person",
+           "email":"federaimondo@gmail.com",
+           "givenName":"Fede",
+           "familyName": "Raimondo"
+        },
+        {
+           "@type":"Person",
+           "email":"jnu@iki.fi",
+           "givenName":"Jussi",
+           "familyName": "Nurminen"
+        },
+        {
+           "@type":"Person",
+           "email":"flKazemakase@gmail.com",
+           "givenName":"Martin",
+           "familyName": "Billinger"
+        },
+        {
+           "@type":"Person",
+           "email":"montoya.jair.m@gmail.com",
+           "givenName":"Jair",
+           "familyName": "Montoya"
+        },
+        {
+           "@type":"Person",
+           "email":"mmwoodman@gmail.com",
+           "givenName":"Marmaduke",
+           "familyName": "Woodman"
+        },
+        {
+           "@type":"Person",
+           "email":"dlsrnsladlek@naver.com",
+           "givenName":"Ingoo",
+           "familyName": "Lee"
+        },
+        {
+           "@type":"Person",
+           "email":"dev@mgschulz.de",
+           "givenName":"Martin",
+           "familyName": "Schulz"
+        },
+        {
+           "@type":"Person",
+           "email":"nfoti01@gmail.com",
+           "givenName":"Nick",
+           "familyName": "Foti"
+        },
+        {
+           "@type":"Person",
+           "email":"cnangini@gmail.com",
+           "givenName":"Cathy",
+           "familyName": "Nangini"
+        },
+        {
+           "@type":"Person",
+           "email":"joialanisson@gmail.com",
+           "givenName":"José C",
+           "familyName": "García Alanis"
+        },
+        {
+           "@type":"Person",
+           "email":"t.s.binns@outlook.com",
+           "givenName":"Thomas S",
+           "familyName": "Binns"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Dimitri Papadopoulos",
+           "familyName": "Orfanos"
+        },
+        {
+           "@type":"Person",
+           "email":"olaf.hauk@mrc-cbu.cam.ac.uk",
+           "givenName":"Olaf",
+           "familyName": "Hauk"
+        },
+        {
+           "@type":"Person",
+           "email":"ross.maddox@rochester.edu",
+           "givenName":"Ross",
+           "familyName": "Maddox"
+        },
+        {
+           "@type":"Person",
+           "email":"aestrivex@gmail.com",
+           "givenName":"Roan",
+           "familyName": "LaPlante"
+        },
+        {
+           "@type":"Person",
+           "email":"ashdrew@uw.edu",
+           "givenName":"Ashley",
+           "familyName": "Drew"
+        },
+        {
+           "@type":"Person",
+           "email":"chdinh@nmr.mgh.harvard.edu",
+           "givenName":"Christoph",
+           "familyName": "Dinh"
+        },
+        {
+           "@type":"Person",
+           "email":"deep@introspection.eu",
+           "givenName":"Guillaume",
+           "familyName": "Dumas"
+        },
+        {
+           "@type":"Person",
+           "email":"martin.billinger@tugraz.at",
+           "givenName":"",
+           "familyName": "Martin"
+        },
+        {
+           "@type":"Person",
+           "email":"johann.benerradi@gmail.com",
+           "givenName":"Johann",
+           "familyName": "Benerradi"
+        },
+        {
+           "@type":"Person",
+           "email":"thomas.hartmann@th-ht.de",
+           "givenName":"Thomas",
+           "familyName": "Hartmann"
+        },
+        {
+           "@type":"Person",
+           "email":"eduardxort@gmail.com",
+           "givenName":"Eduard",
+           "familyName": "Ort"
+        },
+        {
+           "@type":"Person",
+           "email":"flkazemakase@gmail.com",
+           "givenName":"Martin",
+           "familyName": "Billinger"
+        },
+        {
+           "@type":"Person",
+           "email":"paul@ppasler.de",
+           "givenName":"Paul",
+           "familyName": "Pasler"
+        },
+        {
+           "@type":"Person",
+           "email":"stefan.repplinger@posteo.net",
+           "givenName":"Stefan",
+           "familyName": "Repplinger"
+        },
+        {
+           "@type":"Person",
+           "email":"alxanderr@gmail.com",
+           "givenName":"Alexander",
+           "familyName": "Rudiuk"
+        },
+        {
+           "@type":"Person",
+           "email":"anaradanovica@gmail.com",
+           "givenName":"Ana",
+           "familyName": "Radanovic"
+        },
+        {
+           "@type":"Person",
+           "email":"bburan@galenea.com",
+           "givenName":"Brad",
+           "familyName": "Buran"
+        },
+        {
+           "@type":"Person",
+           "email":"Woessner.jacob@gmail.com",
+           "givenName":"Jacob",
+           "familyName": "Woessner"
+        },
+        {
+           "@type":"Person",
+           "email":"mathurin.massias@gmail.com",
+           "givenName":"Mathurin",
+           "familyName": "Massias"
+        },
+        {
+           "@type":"Person",
+           "email":"msh@nmr.mgh.harvard.edu",
+           "givenName":"Matti",
+           "familyName": "Hämäläinen"
+        },
+        {
+           "@type":"Person",
+           "email":"pravsripad@gmail.com",
+           "givenName":"Praveen",
+           "familyName": "Sripad"
+        },
+        {
+           "@type":"Person",
+           "email":"vagechirkov@gmail.com",
+           "givenName":"Valerii",
+           "familyName": "Chirkov"
+        },
+        {
+           "@type":"Person",
+           "email":"christopherrmullins@gmail.com",
+           "givenName":"Christopher",
+           "familyName": "Mullins"
+        },
+        {
+           "@type":"Person",
+           "email":"gamaz3ps@gmail.com",
+           "givenName":"Félix",
+           "familyName": "Raimundo"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Gennadiy",
+           "familyName": "Belonosov"
+        },
+        {
+           "@type":"Person",
+           "email":"rcmdnk@gmail.com",
+           "givenName":"Michiru",
+           "familyName": "Kaneda"
+        },
+        {
+           "@type":"Person",
+           "email":"phillip.alday@mpi.nl",
+           "givenName":"Phillip",
+           "familyName": "Alday"
+        },
+        {
+           "@type":"Person",
+           "email":"ramsbam@gmail.com",
+           "givenName":"Ram",
+           "familyName": "Pari"
+        },
+        {
+           "@type":"Person",
+           "email":"simon@simonster.com",
+           "givenName":"Simon",
+           "familyName": "Kornblith"
+        },
+        {
+           "@type":"Person",
+           "email":"debian@onerussian.com",
+           "givenName":"Yaroslav",
+           "familyName": "Halchenko"
+        },
+        {
+           "@type":"Person",
+           "email":"yuhanluo1994@gmail.com",
+           "givenName":"Yu-Han",
+           "familyName": "Luo"
+        },
+        {
+           "@type":"Person",
+           "email":"agramfort@fb.com",
+           "givenName":"Alexandre",
+           "familyName": "Gramfort"
+        },
+        {
+           "@type":"Person",
+           "email":"jeythekey@tutanota.com",
+           "givenName":"Johannes",
+           "familyName": "Kasper"
+        },
+        {
+           "@type":"Person",
+           "email":"kd889@nyu.edu",
+           "givenName":"Keith",
+           "familyName": "Doelling"
+        },
+        {
+           "@type":"Person",
+           "email":"mje.mads@gmail.com",
+           "givenName":"Mads",
+           "familyName": "Jensen"
+        },
+        {
+           "@type":"Person",
+           "email":"santeri.ruuskanen@aalto.fi",
+           "givenName":"Santeri",
+           "familyName": "Ruuskanen"
+        },
+        {
+           "@type":"Person",
+           "email":"simon.kern@online.de",
+           "givenName":"Simon",
+           "familyName": "Kern"
+        },
+        {
+           "@type":"Person",
+           "email":"tanaygahlot@gmail.com",
+           "givenName":"Tanay",
+           "familyName": "Gahlot"
+        },
+        {
+           "@type":"Person",
+           "email":"adonay.s.nunes@gmail.com",
+           "givenName":"Adonay",
+           "familyName": "Nunes"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Dirk",
+           "familyName": "Gütlin"
+        },
+        {
+           "@type":"Person",
+           "email":"erkkahe@gmail.com",
+           "givenName":"Erkka",
+           "familyName": "Heinila"
+        },
+        {
+           "@type":"Person",
+           "email":"kristijan.armeni@gmail.com",
+           "givenName":"Kristijan",
+           "familyName": "Armeni"
+        },
+        {
+           "@type":"Person",
+           "email":"kjs@llama",
+           "givenName":"",
+           "familyName": "kjs"
+        },
+        {
+           "@type":"Person",
+           "email":"alejandro.weinstein@gmail.com",
+           "givenName":"Alejandro",
+           "familyName": "Weinstein"
+        },
+        {
+           "@type":"Person",
+           "email":"camilo@neurostat.mit.edu",
+           "givenName":"Camilo",
+           "familyName": "Lamus"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Catalina María",
+           "familyName": "Galván"
+        },
+        {
+           "@type":"Person",
+           "email":"cmmoenne@gmail.com",
+           "givenName":"Cristóbal",
+           "familyName": "Moënne-Loccoz"
+        },
+        {
+           "@type":"Person",
+           "email":"dm.altukhov@ya.ru",
+           "givenName":"Dmitrii",
+           "familyName": "Altukhov"
+        },
+        {
+           "@type":"Person",
+           "email":"nordme@uw.edu",
+           "givenName":"Erica",
+           "familyName": "Peterson"
+        },
+        {
+           "@type":"Person",
+           "email":"jevri.hanna@gmail.com",
+           "givenName":"Jevri",
+           "familyName": "Hanna"
+        },
+        {
+           "@type":"Person",
+           "email":"jon.houck@gmail.com",
+           "givenName":"Jon",
+           "familyName": "Houck"
+        },
+        {
+           "@type":"Person",
+           "email":"neklein@andrew.cmu.edu",
+           "givenName":"Natalie",
+           "familyName": "Klein"
+        },
+        {
+           "@type":"Person",
+           "email":"paul@roujansky.eu",
+           "givenName":"Paul",
+           "familyName": "Roujansky"
+        },
+        {
+           "@type":"Person",
+           "email":"code@robertluke.net",
+           "givenName":"Rob",
+           "familyName": "Luke"
+        },
+        {
+           "@type":"Person",
+           "email":"antti.rantala90@gmail.com",
+           "givenName":"Antti",
+           "familyName": "Rantala"
+        },
+        {
+           "@type":"Person",
+           "email":"burkhard.maess@arcor.de",
+           "givenName":"Burkhard",
+           "familyName": "Maess"
+        },
+        {
+           "@type":"Person",
+           "email":"carinaforster0611@gmail.com",
+           "givenName":"Carina",
+           "familyName": "Forster"
+        },
+        {
+           "@type":"Person",
+           "email":"christian.oreilly@gmail.com",
+           "givenName":"Christian",
+           "familyName": "O'Reilly"
+        },
+        {
+           "@type":"Person",
+           "email":"dominik.welke@ae.mpg.de",
+           "givenName":"Dominik",
+           "familyName": "Welke"
+        },
+        {
+           "@type":"Person",
+           "email":"dominik.welke@web.de",
+           "givenName":"Dominik",
+           "familyName": "Welke"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Henrich",
+           "familyName": "Kolkhorst"
+        },
+        {
+           "@type":"Person",
+           "email":"hubert.jbanville@gmail.com",
+           "givenName":"Hubert",
+           "familyName": "Banville"
+        },
+        {
+           "@type":"Person",
+           "email":"zhangmengyu10@gmail.com",
+           "givenName":"Jack",
+           "familyName": "Zhang"
+        },
+        {
+           "@type":"Person",
+           "email":"makkostya@ukr.net",
+           "givenName":"Kostiantyn",
+           "familyName": "Maksymenko"
+        },
+        {
+           "@type":"Person",
+           "email":"mdclarke@uw.edu",
+           "givenName":"Maggie",
+           "familyName": "Clarke"
+        },
+        {
+           "@type":"Person",
+           "email":"matteo.anelli@aalto.fi",
+           "givenName":"Matteo",
+           "familyName": "Anelli"
+        },
+        {
+           "@type":"Person",
+           "email":"michael.straube.d@gmail.com",
+           "givenName":"Michael",
+           "familyName": "Straube"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Nikolai",
+           "familyName": "Chapochnikov"
+        },
+        {
+           "@type":"Person",
+           "email":"pierreantoine.bannier@gmail.com",
+           "givenName":"Pierre-Antoine",
+           "familyName": "Bannier"
+        },
+        {
+           "@type":"Person",
+           "email":"saketkc@gmail.com",
+           "givenName":"Saket",
+           "familyName": "Choudhary"
+        },
+        {
+           "@type":"Person",
+           "email":"victor.ferat@live.Fr",
+           "givenName":"Victor",
+           "familyName": "Férat"
+        },
+        {
+           "@type":"Person",
+           "email":"kimjico@gmail.com",
+           "givenName":"Cora",
+           "familyName": "Kim"
+        },
+        {
+           "@type":"Person",
+           "email":"klotzsche@cbs.mpg.de",
+           "givenName":"Felix",
+           "familyName": "Klotzsche"
+        },
+        {
+           "@type":"Person",
+           "email":"zuxfoucault@gmail.com",
+           "givenName":"Fu-Te",
+           "familyName": "Wong"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Ivana",
+           "familyName": "Kojcic"
+        },
+        {
+           "@type":"Person",
+           "email":"jdue@dtu.dk",
+           "givenName":"Jesper Duemose",
+           "familyName": "Nielsen"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Kaisu",
+           "familyName": "Lankinen"
+        },
+        {
+           "@type":"Person",
+           "email":"ktavabi@gmail.com",
+           "givenName":"Kambiz",
+           "familyName": "Tabavi"
+        },
+        {
+           "@type":"Person",
+           "email":"louist87@gmail.com",
+           "givenName":"Louis",
+           "familyName": "Thibault"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Moritz",
+           "familyName": "Gerster"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Nabil",
+           "familyName": "Alibou"
+        },
+        {
+           "@type":"Person",
+           "email":"nathalie.gayraud@inria.fr",
+           "givenName":"Nathalie",
+           "familyName": "Gayraud"
+        },
+        {
+           "@type":"Person",
+           "email":"ward.nickjames@gmail.com",
+           "givenName":"Nick",
+           "familyName": "Ward"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Qian",
+           "familyName": "Chu"
+        },
+        {
+           "@type":"Person",
+           "email":"ksherbst@gmail.com",
+           "givenName":"Sophie",
+           "familyName": "Herbst"
+        },
+        {
+           "@type":"Person",
+           "email":"myd7349@gmail.com",
+           "givenName":"Tom",
+           "familyName": "Ma"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Ana",
+           "familyName": "Radanovic"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Andrew",
+           "familyName": "Quinn"
+        },
+        {
+           "@type":"Person",
+           "email":"antoine.gauthier@ensta.fr",
+           "givenName":"Antoine",
+           "familyName": "Gauthier"
+        },
+        {
+           "@type":"Person",
+           "email":"basile.pinsard@umontreal.ca",
+           "givenName":"Basile",
+           "familyName": "Pinsard"
+        },
+        {
+           "@type":"Person",
+           "email":"emilyps14@gmail.com",
+           "givenName":"Emily",
+           "familyName": "Stephen"
+        },
+        {
+           "@type":"Person",
+           "email":"erik.hornberger@shi-g.com",
+           "givenName":"Erik",
+           "familyName": "Hornberger"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Evan",
+           "familyName": "Hathaway"
+        },
+        {
+           "@type":"Person",
+           "email":"e.kalenkovich@gmail.com",
+           "givenName":"Evgenii",
+           "familyName": "Kalenkovich"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Fahimeh",
+           "familyName": "Mamashli"
+        },
+        {
+           "@type":"Person",
+           "email":"g.o'neill@ucl.ac.uk",
+           "givenName":"George",
+           "familyName": "O'Neill"
+        },
+        {
+           "@type":"Person",
+           "email":"giorgio.marinato@unitn.it",
+           "givenName":"Giorgio",
+           "familyName": "Marinato"
+        },
+        {
+           "@type":"Person",
+           "email":"hafiza.taj@gmail.com",
+           "givenName":"Hafeza",
+           "familyName": "Anevar"
+        },
+        {
+           "@type":"Person",
+           "email":"hamza.abdelhedii@gmail.com",
+           "givenName":"Hamza",
+           "familyName": "Abdelhedi"
+        },
+        {
+           "@type":"Person",
+           "email":"mail@jan-sosulski.de",
+           "givenName":"Jan",
+           "familyName": "Sosulski"
+        },
+        {
+           "@type":"Person",
+           "email":"stoutjd@nih.gov",
+           "givenName":"Jeff",
+           "familyName": "Stout"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Joshua",
+           "familyName": "Calder-Travis"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Judy D",
+           "familyName": "Zhu"
+        },
+        {
+           "@type":"Person",
+           "email":"leisenman@wustl.edu",
+           "givenName":"Larry",
+           "familyName": "Eisenman"
+        },
+        {
+           "@type":"Person",
+           "email":"Lorenz.Esch@tu-ilmenau.de",
+           "givenName":"Lorenz",
+           "familyName": "Esch"
+        },
+        {
+           "@type":"Person",
+           "email":"marian.dowgialo@gmail.com",
+           "givenName":"Marian",
+           "familyName": "Dovgialo"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Nicolas",
+           "familyName": "Barascud"
+        },
+        {
+           "@type":"Person",
+           "email":"legrand@cyceron.fr",
+           "givenName":"Nicolas",
+           "familyName": "Legrand"
+        },
+        {
+           "@type":"Person",
+           "email":"4dvlup@gmail.com",
+           "givenName":"Nikolai",
+           "familyName": "Kapralov"
+        },
+        {
+           "@type":"Person",
+           "email":"pmolfese@gmail.com",
+           "givenName":"Peter J",
+           "familyName": "Molfese"
+        },
+        {
+           "@type":"Person",
+           "email":"falachrotem@gmail.com",
+           "givenName":"Rotem",
+           "familyName": "Falach"
+        },
+        {
+           "@type":"Person",
+           "email":"sam.deslauriers@gmail.com",
+           "givenName":"Samuel",
+           "familyName": "Deslauriers-Gauthier"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Silvia",
+           "familyName": "Cotroneo"
+        },
+        {
+           "@type":"Person",
+           "email":"stevematindi@gmail.com",
+           "givenName":"Steve",
+           "familyName": "Matindi"
+        },
+        {
+           "@type":"Person",
+           "email":"neurolaunch@gmail.copm",
+           "givenName":"Steven",
+           "familyName": "Bierer"
+        },
+        {
+           "@type":"Person",
+           "email":"Theodore.Papadopoulo@inria.fr",
+           "givenName":"Theodore",
+           "familyName": "Papadopoulo"
+        },
+        {
+           "@type":"Person",
+           "email":"t.s.binns@outlook.com",
+           "givenName":"Thomas Samuel",
+           "familyName": "Binns"
+        },
+        {
+           "@type":"Person",
+           "email":"ttstenner@gmail.com",
+           "givenName":"Tristan",
+           "familyName": "Stenner"
+        },
+        {
+           "@type":"Person",
+           "email":"victoriapeterson09@gmail.com",
+           "givenName":"Victoria",
+           "familyName": "Peterson"
+        },
+        {
+           "@type":"Person",
+           "email":"z.baratz@gmail.com",
+           "givenName":"Zvi",
+           "familyName": "Baratz"
+        },
+        {
+           "@type":"Person",
+           "email":"alessandro.tonin@wysscenter.ch",
+           "givenName":"Alessandro",
+           "familyName": "Tonin"
+        },
+        {
+           "@type":"Person",
+           "email":"alexander.kovrig@gmail.com",
+           "givenName":"Alexander",
+           "familyName": "Kovrig"
+        },
+        {
+           "@type":"Person",
+           "email":"a.pascarella@iac.cnr.it",
+           "givenName":"Annalisa",
+           "familyName": "Pascarella"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Apoorva",
+           "familyName": "Karekal"
+        },
+        {
+           "@type":"Person",
+           "email":"b.aristimunha@gmail.com",
+           "givenName":"Bruno",
+           "familyName": "Aristimunha"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Carlos",
+           "familyName": "de la Torre"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Chetan",
+           "familyName": "Gohil"
+        },
+        {
+           "@type":"Person",
+           "email":"zhaotc@uw.edu",
+           "givenName":"Christina",
+           "familyName": "Zhao"
+        },
+        {
+           "@type":"Person",
+           "email":"raymon92@gmail.com",
+           "givenName":"Dominik",
+           "familyName": "Krzemiński"
+        },
+        {
+           "@type":"Person",
+           "email":"dom.mak19@gmail.com",
+           "givenName":"Dominique",
+           "familyName": "Makowski"
+        },
+        {
+           "@type":"Person",
+           "email":"e.mikulan@gmail.com",
+           "givenName":"Ezequiel",
+           "familyName": "Mikulan"
+        },
+        {
+           "@type":"Person",
+           "email":"hofaflo@gmail.com",
+           "givenName":"Florian",
+           "familyName": "Hofer"
+        },
+        {
+           "@type":"Person",
+           "email":"harrison.ritz@gmail.com",
+           "givenName":"Harrison",
+           "familyName": "Ritz"
+        },
+        {
+           "@type":"Person",
+           "email":"jean.baptiste.schiratti@gmail.com",
+           "givenName":"Jean-Baptiste",
+           "familyName": "Schiratti"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Jen",
+           "familyName": "Evans"
+        },
+        {
+           "@type":"Person",
+           "email":"johannes@herforth.net",
+           "givenName":"Johannes",
+           "familyName": "Herforth"
+        },
+        {
+           "@type":"Person",
+           "email":"johnv@uchicago.edu",
+           "givenName":"John",
+           "familyName": "Veillette"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Jordan",
+           "familyName": "Drew"
+        },
+        {
+           "@type":"Person",
+           "email":"jbtevespro@gmail.com",
+           "givenName":"Joshua",
+           "familyName": "Teves"
+        },
+        {
+           "@type":"Person",
+           "email":"kylemath@gmail.com",
+           "givenName":"Kyle",
+           "familyName": "Mathewson"
+        },
+        {
+           "@type":"Person",
+           "email":"lgwilliams90@gmail.com",
+           "givenName":"Laura",
+           "familyName": "Gwilliams"
+        },
+        {
+           "@type":"Person",
+           "email":"laurent.lementec@gmail.com",
+           "givenName":"Laurent",
+           "familyName": "Lementec"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Lenny",
+           "familyName": "Varghese"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Liberty",
+           "familyName": "Hamilton"
+        },
+        {
+           "@type":"Person",
+           "email":"lukas.gemein@gmx.de",
+           "givenName":"Lukas",
+           "familyName": "Gemein"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Lukas",
+           "familyName": "Hecker"
+        },
+        {
+           "@type":"Person",
+           "email":"capmanip@DESKTOP-TLIFEG1.localdomain",
+           "givenName":"",
+           "familyName": "Lx37"
+        },
+        {
+           "@type":"Person",
+           "email":"mats.vanes@psych.ox.ac.uk",
+           "givenName":"Mats",
+           "familyName": "van Es"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Matt",
+           "familyName": "Boggess"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Matthias",
+           "familyName": "Eberlein"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Michal",
+           "familyName": "Žák"
+        },
+        {
+           "@type":"Person",
+           "email":"molpsychistb@gmail.com",
+           "givenName":"Mohamed",
+           "familyName": "Sherif"
+        },
+        {
+           "@type":"Person",
+           "email":"natakozh22@gmail.com",
+           "givenName":"Nataliia",
+           "familyName": "Kozhemiako"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Naveen",
+           "familyName": "Srinivasan"
+        },
+        {
+           "@type":"Person",
+           "email":"niklas.wilming@gmail.com",
+           "givenName":"Niklas",
+           "familyName": "Wilming"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Oleh",
+           "familyName": "Kozynets"
+        },
+        {
+           "@type":"Person",
+           "email":"pierreablin@gmail.com",
+           "givenName":"Pierre",
+           "familyName": "Ablin"
+        },
+        {
+           "@type":"Person",
+           "email":"proloy@umd.edu",
+           "givenName":"Proloy",
+           "familyName": "Das"
+        },
+        {
+           "@type":"Person",
+           "email":"quentinbertrand54@gmail.com",
+           "givenName":"Quentin",
+           "familyName": "Bertrand"
+        },
+        {
+           "@type":"Person",
+           "email":"r.shoorangiz@live.com",
+           "givenName":"Reza",
+           "familyName": "Shoorangiz"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Richard",
+           "familyName": "Scholz"
+        },
+        {
+           "@type":"Person",
+           "email":"rhubner@gmail.com",
+           "givenName":"Rodrigo",
+           "familyName": "Hübner"
+        },
+        {
+           "@type":"Person",
+           "email":"sommariva@dima.unige.it",
+           "givenName":"Sara",
+           "familyName": "Sommariva"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sena",
+           "familyName": "Er"
+        },
+        {
+           "@type":"Person",
+           "email":"sheraz@nmr.mgh.harvard.edu",
+           "givenName":"Sheraz",
+           "familyName": "Khan"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sumalyo",
+           "familyName": "Datta"
+        },
+        {
+           "@type":"Person",
+           "email":"tdonoghue.research@gmail.com",
+           "givenName":"Thomas",
+           "familyName": "Donoghue"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Thomas",
+           "familyName": "Jochmann"
+        },
+        {
+           "@type":"Person",
+           "email":"timon.merk@charite.de",
+           "givenName":"Timon",
+           "familyName": "Merk"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Tod",
+           "familyName": "Flak"
+        },
+        {
+           "@type":"Person",
+           "email":"tom.dupre-la-tour@m4x.org",
+           "givenName":"Tom",
+           "familyName": "Dupré la Tour"
+        },
+        {
+           "@type":"Person",
+           "email":"tzionan@mail.tau.ac.il",
+           "givenName":"Tziona",
+           "familyName": "NessAiver"
+        },
+        {
+           "@type":"Person",
+           "email":"akshay0724@gmail.com",
+           "givenName":"",
+           "familyName": "akshay0724"
+        },
+        {
+           "@type":"Person",
+           "email":"sviter33@gmail.com",
+           "givenName":"",
+           "familyName": "sviter"
+        },
+        {
+           "@type":"Person",
+           "email":"Jakdaxter31@gmail.com",
+           "givenName":"Aaron",
+           "familyName": "Earle-Richardson"
+        },
+        {
+           "@type":"Person",
+           "email":"abram.hindle@softwareprocess.es",
+           "givenName":"Abram",
+           "familyName": "Hindle"
+        },
+        {
+           "@type":"Person",
+           "email":"achilleas.k@gmail.com",
+           "givenName":"Achilleas",
+           "familyName": "Koutsou"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Adeline",
+           "familyName": "Fecker"
+        },
+        {
+           "@type":"Person",
+           "email":"adina.wagner@t-online.de",
+           "givenName":"Adina",
+           "familyName": "Wagner"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Alex",
+           "familyName": "Ciok"
+        },
+        {
+           "@type":"Person",
+           "email":"alex.lepauvre@ae.mpg.de",
+           "givenName":"Alex",
+           "familyName": "Lepauvre"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Alexander",
+           "familyName": "Kiefer"
+        },
+        {
+           "@type":"Person",
+           "email":"7andy121@gmail.com",
+           "givenName":"Andy",
+           "familyName": "Gilbert"
+        },
+        {
+           "@type":"Person",
+           "email":"aniket17133@iiitd.ac.in",
+           "givenName":"Aniket",
+           "familyName": "Pradhan"
+        },
+        {
+           "@type":"Person",
+           "email":"anna.padee@gmail.com",
+           "givenName":"Anna",
+           "familyName": "Padee"
+        },
+        {
+           "@type":"Person",
+           "email":"as_dub@hotmail.com",
+           "givenName":"Anne-Sophie",
+           "familyName": "Dubarry"
+        },
+        {
+           "@type":"Person",
+           "email":"contact@antoinecollas.fr",
+           "givenName":"Antoine",
+           "familyName": "Collas"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Anton Nikolas",
+           "familyName": "Waniek"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Archit",
+           "familyName": "Singhal"
+        },
+        {
+           "@type":"Person",
+           "email":"arokem@gmail.com",
+           "givenName":"Ariel",
+           "familyName": "Rokem"
+        },
+        {
+           "@type":"Person",
+           "email":"arne.pelzer@idmt.fraunhofer.de",
+           "givenName":"Arne",
+           "familyName": "Pelzer"
+        },
+        {
+           "@type":"Person",
+           "email":"mynameisaustinhurst@gmail.com",
+           "givenName":"Austin",
+           "familyName": "Hurst"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Beige Jerry",
+           "familyName": "Jin"
+        },
+        {
+           "@type":"Person",
+           "email":"code@musicinmybrain.net",
+           "givenName":"Ben",
+           "familyName": "Beasley"
+        },
+        {
+           "@type":"Person",
+           "email":"bruno.nicenboim@gmail.com",
+           "givenName":"Bruno",
+           "familyName": "Nicenboim"
+        },
+        {
+           "@type":"Person",
+           "email":"ctorre@mailbox.org",
+           "givenName":"Carlos",
+           "familyName": "de la Torre"
+        },
+        {
+           "@type":"Person",
+           "email":"cclauss@me.com",
+           "givenName":"Christian",
+           "familyName": "Clauss"
+        },
+        {
+           "@type":"Person",
+           "email":"cmista@ingenieria.uner.edu.ar",
+           "givenName":"Christian",
+           "familyName": "Mista"
+        },
+        {
+           "@type":"Person",
+           "email":"kechrisc@gmail.com",
+           "givenName":"Christodoulos",
+           "familyName": "Kechris"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Chun-Hui",
+           "familyName": "Li"
+        },
+        {
+           "@type":"Person",
+           "email":"claire@guakamole.org",
+           "givenName":"Claire",
+           "familyName": "Braboszcz"
+        },
+        {
+           "@type":"Person",
+           "email":"daniel.c.schad@protonmail.com",
+           "givenName":"Daniel C",
+           "familyName": "Schad"
+        },
+        {
+           "@type":"Person",
+           "email":"danielhasegan@gmail.com",
+           "givenName":"Daniel",
+           "familyName": "Hasegan"
+        },
+        {
+           "@type":"Person",
+           "email":"xiezhibin.0.0.superman@gmail.com",
+           "givenName":"Daniel",
+           "familyName": "Tse"
+        },
+        {
+           "@type":"Person",
+           "email":"darin.sleiter@gmail.com",
+           "givenName":"Darin Erat",
+           "familyName": "Sleiter"
+        },
+        {
+           "@type":"Person",
+           "email":"haslacherdavid@gmail.com",
+           "givenName":"David",
+           "familyName": "Haslacher"
+        },
+        {
+           "@type":"Person",
+           "email":"dav.sabbagh@gmail.com",
+           "givenName":"David",
+           "familyName": "Sabbagh"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Demetres",
+           "familyName": "Kostas"
+        },
+        {
+           "@type":"Person",
+           "email":"desislavka@gmail.com",
+           "givenName":"Desislava",
+           "familyName": "Petkova"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Dinara",
+           "familyName": "Issagaliyeva"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Diptyajit",
+           "familyName": "Das"
+        },
+        {
+           "@type":"Person",
+           "email":"dimonok@web.de",
+           "givenName":"Dominik",
+           "familyName": "Wetzel"
+        },
+        {
+           "@type":"Person",
+           "email":"e.eich@fz-juelich.de",
+           "givenName":"Eberhard",
+           "familyName": "Eich"
+        },
+        {
+           "@type":"Person",
+           "email":"emd222@cornell.edu",
+           "givenName":"Elizabeth",
+           "familyName": "DuPre"
+        },
+        {
+           "@type":"Person",
+           "email":"ellenlau@umd.edu",
+           "givenName":"Ellen",
+           "familyName": "Lau"
+        },
+        {
+           "@type":"Person",
+           "email":"emanuele@relativita.com",
+           "givenName":"Emanuele",
+           "familyName": "Olivetti"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Emma",
+           "familyName": "Zhang"
+        },
+        {
+           "@type":"Person",
+           "email":"emmanuelferdman@gmail.com",
+           "givenName":"Emmanuel",
+           "familyName": "Ferdman"
+        },
+        {
+           "@type":"Person",
+           "email":"emrecncelik@gmail.com",
+           "givenName":"Emrecan",
+           "familyName": "Çelik"
+        },
+        {
+           "@type":"Person",
+           "email":"enricovarano@gmail.com",
+           "givenName":"Enrico",
+           "familyName": "Varano"
+        },
+        {
+           "@type":"Person",
+           "email":"enzo.alt@gmail.com",
+           "givenName":"Enzo",
+           "familyName": "Altamiranda"
+        },
+        {
+           "@type":"Person",
+           "email":"eric.brayet@mybraintech.com",
+           "givenName":"Eric",
+           "familyName": "Brayet"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Etienne",
+           "familyName": "de Montalivet"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Evgeny",
+           "familyName": "Goldstein"
+        },
+        {
+           "@type":"Person",
+           "email":"fmamashli@gmail.com",
+           "givenName":"Fahimeh",
+           "familyName": "Mamashli"
+        },
+        {
+           "@type":"Person",
+           "email":"farzin.negahbani@gmail.com",
+           "givenName":"Farzin",
+           "familyName": "Negahbani"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Federico",
+           "familyName": "Zamberlan"
+        },
+        {
+           "@type":"Person",
+           "email":"florinpop@me.com",
+           "givenName":"Florin",
+           "familyName": "Pop"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Frederik D",
+           "familyName": "Weber"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Gansheng",
+           "familyName": "Tan"
+        },
+        {
+           "@type":"Person",
+           "email":"Geoff.Brookshire@gmail.com",
+           "givenName":"Geoff",
+           "familyName": "Brookshire"
+        },
+        {
+           "@type":"Person",
+           "email":"george.oneill.90@gmail.com",
+           "givenName":"George",
+           "familyName": "O'Neill"
+        },
+        {
+           "@type":"Person",
+           "email":"gack94@gmail.com",
+           "givenName":"",
+           "familyName": "Giulio"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Gonzalo",
+           "familyName": "Reina"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Hamid",
+           "familyName": "Maymandi"
+        },
+        {
+           "@type":"Person",
+           "email":"hasrat407@gmail.com",
+           "givenName":"Hasrat Ali",
+           "familyName": "Arzoo"
+        },
+        {
+           "@type":"Person",
+           "email":"hermann.sonntag@gmail.com",
+           "givenName":"Hermann",
+           "familyName": "Sonntag"
+        },
+        {
+           "@type":"Person",
+           "email":"rubyyhj@gmail.com",
+           "givenName":"Hongjiang",
+           "familyName": "Ye"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Hyonyoung",
+           "familyName": "Shin"
+        },
+        {
+           "@type":"Person",
+           "email":"huseyinorkunelmas@gmail.com",
+           "givenName":"Hüseyin Orkun",
+           "familyName": "Elmas"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Ilian",
+           "familyName": "AZZ"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Ilias",
+           "familyName": "Machairas"
+        },
+        {
+           "@type":"Person",
+           "email":"ivan.zubarev@aalto.fi",
+           "givenName":"Ivan",
+           "familyName": "Zubarev"
+        },
+        {
+           "@type":"Person",
+           "email":"ivopascal@gmail.com",
+           "givenName":"Ivo",
+           "familyName": "de Jong"
+        },
+        {
+           "@type":"Person",
+           "email":"jacob.phelan.jp@gmail.com",
+           "givenName":"Jacob",
+           "familyName": "Phelan"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Jakub",
+           "familyName": "Kaczmarzyk"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Jan",
+           "familyName": "Zerfowski"
+        },
+        {
+           "@type":"Person",
+           "email":"japsai@gmail.com",
+           "givenName":"Jasper J F",
+           "familyName": "van den Bosch"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Jeroen",
+           "familyName": "Van Der Donckt"
+        },
+        {
+           "@type":"Person",
+           "email":"johanvandermeer@gmail.com",
+           "givenName":"Johan",
+           "familyName": "van der Meer"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Johannes",
+           "familyName": "Niediek"
+        },
+        {
+           "@type":"Person",
+           "email":"koen.joshua@gmail.com",
+           "givenName":"Josh",
+           "familyName": "Koen"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Joshua J",
+           "familyName": "Bear"
+        },
+        {
+           "@type":"Person",
+           "email":"j.dammers@fz-juelich.de",
+           "givenName":"Juergen",
+           "familyName": "Dammers"
+        },
+        {
+           "@type":"Person",
+           "email":"guiomar.niso@ctb.upm.es",
+           "givenName":"Julia Guiomar Niso",
+           "familyName": "Galán"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Julius",
+           "familyName": "Welzel"
+        },
+        {
+           "@type":"Person",
+           "email":"slama@berkeley.edu",
+           "givenName":"Katarina",
+           "familyName": "Slama"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Katia",
+           "familyName": "Al-Amir"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Katrin",
+           "familyName": "Leinweber"
+        },
+        {
+           "@type":"Person",
+           "email":"laetitia.grabot@gmail.com",
+           "givenName":"Laetitia",
+           "familyName": "Grabot"
+        },
+        {
+           "@type":"Person",
+           "email":"ualsbombe@protonmail.com",
+           "givenName":"Lau Møller",
+           "familyName": "Andersen"
+        },
+        {
+           "@type":"Person",
+           "email":"leorochael@gmail.com",
+           "givenName":"Leonardo Rochael",
+           "familyName": "Almeida"
+        },
+        {
+           "@type":"Person",
+           "email":"lsbarbosa@gmail.com",
+           "givenName":"Leonardo S",
+           "familyName": "Barbosa"
+        },
+        {
+           "@type":"Person",
+           "email":"lorenzo.alfine@gmail.com",
+           "givenName":"Lorenzo",
+           "familyName": "Alfine"
+        },
+        {
+           "@type":"Person",
+           "email":"hejtmy@gmail.com",
+           "givenName":"Lukáš",
+           "familyName": "Hejtmánek"
+        },
+        {
+           "@type":"Person",
+           "email":"mbalatsko@gmail.com",
+           "givenName":"Maksym",
+           "familyName": "Balatsko"
+        },
+        {
+           "@type":"Person",
+           "email":"manfredg@nmr.mgh.harvard.edu",
+           "givenName":"Manfred",
+           "familyName": "Kitzbichler"
+        },
+        {
+           "@type":"Person",
+           "email":"manojkumarsivaraj334@gmail.com",
+           "givenName":"Manoj",
+           "familyName": "Kumar"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Manorama",
+           "familyName": "Kadwani"
+        },
+        {
+           "@type":"Person",
+           "email":"manu.sutela@gmail.com",
+           "givenName":"Manu",
+           "familyName": "Sutela"
+        },
+        {
+           "@type":"Person",
+           "email":"koculak.marcin@gmail.com",
+           "givenName":"Marcin",
+           "familyName": "Koculak"
+        },
+        {
+           "@type":"Person",
+           "email":"mah@optoceutics.com",
+           "givenName":"Mark",
+           "familyName": "Henney"
+        },
+        {
+           "@type":"Person",
+           "email":"Martinb.nmb@gmail.com",
+           "givenName":"Martin",
+           "familyName": "BaBer"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Martin",
+           "familyName": "Oberg"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Martin",
+           "familyName": "van Harmelen"
+        },
+        {
+           "@type":"Person",
+           "email":"mathieu.scheltienne@dandelion.science",
+           "givenName":"Mathieu",
+           "familyName": "Scheltienne"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Matt",
+           "familyName": "Courtemanche"
+        },
+        {
+           "@type":"Person",
+           "email":"matt.tucker@nyu.edu",
+           "givenName":"Matt",
+           "familyName": "Tucker"
+        },
+        {
+           "@type":"Person",
+           "email":"matteo.visconti.gr@dartmouth.edu",
+           "givenName":"Matteo",
+           "familyName": "Visconti di Oleggio Castello"
+        },
+        {
+           "@type":"Person",
+           "email":"matthias.dold@gmx.net",
+           "givenName":"Matthias",
+           "familyName": "Dold"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Matti",
+           "familyName": "Toivonen"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Maureen",
+           "familyName": "Shader"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Mauricio",
+           "familyName": "Cespedes"
+        },
+        {
+           "@type":"Person",
+           "email":"krause@mpib-berlin.mpg.de",
+           "givenName":"Michael",
+           "familyName": "Krause"
+        },
+        {
+           "@type":"Person",
+           "email":"kontakt@milanrybar.cz",
+           "givenName":"Milan",
+           "familyName": "Rybář"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Mingjian",
+           "familyName": "He"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Mohammad",
+           "familyName": "Daneshzand"
+        },
+        {
+           "@type":"Person",
+           "email":"23111220065@m.fudan.edu.cn",
+           "givenName":"",
+           "familyName": "Mojackhak"
+        },
+        {
+           "@type":"Person",
+           "email":"celicolimmo@free.fr",
+           "givenName":"Nicolas",
+           "familyName": "Fourcaud-Trocmé"
+        },
+        {
+           "@type":"Person",
+           "email":"nicolas.gensollen@gmail.com",
+           "givenName":"Nicolas",
+           "familyName": "Gensollen"
+        },
+        {
+           "@type":"Person",
+           "email":"nh.proulx@gmail.com",
+           "givenName":"Nicole",
+           "familyName": "Proulx"
+        },
+        {
+           "@type":"Person",
+           "email":"nfocke@uni-goettingen.de",
+           "givenName":"Niels",
+           "familyName": "Focke"
+        },
+        {
+           "@type":"Person",
+           "email":"nikos.ch01@gmail.com",
+           "givenName":"Nikolas",
+           "familyName": "Chalas"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Noah",
+           "familyName": "Markowitz"
+        },
+        {
+           "@type":"Person",
+           "email":"omer.shubi@gmail.com",
+           "givenName":"Omer",
+           "familyName": "Shubi"
+        },
+        {
+           "@type":"Person",
+           "email":"pablomainar.pm@gmail.com",
+           "givenName":"Pablo",
+           "familyName": "Mainar"
+        },
+        {
+           "@type":"Person",
+           "email":"tottochan@gmail.com",
+           "givenName":"Padma",
+           "familyName": "Sundaram"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Paul",
+           "familyName": "Anders"
+        },
+        {
+           "@type":"Person",
+           "email":"pedrobnsilva@gmail.com",
+           "givenName":"Pedro",
+           "familyName": "Silva"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Pierre",
+           "familyName": "Guetschel"
+        },
+        {
+           "@type":"Person",
+           "email":"glia@dtu.dk",
+           "givenName":"Quanliang",
+           "familyName": "Li"
+        },
+        {
+           "@type":"Person",
+           "email":"q.barthelemy@gmail.com",
+           "givenName":"Quentin",
+           "familyName": "Barthélemy"
+        },
+        {
+           "@type":"Person",
+           "email":"rahuln@cs.washington.edu",
+           "givenName":"Rahul",
+           "familyName": "Nadkarni"
+        },
+        {
+           "@type":"Person",
+           "email":"rmrgatti@gmail.com",
+           "givenName":"Ramiro",
+           "familyName": "Gatti"
+        },
+        {
+           "@type":"Person",
+           "email":"moncho_apa@hotmail.com",
+           "givenName":"Ramonapariciog",
+           "familyName": "Apariciogarcia"
+        },
+        {
+           "@type":"Person",
+           "email":"raagaard97@gmail.com",
+           "givenName":"Rasmus",
+           "familyName": "Aagaard"
+        },
+        {
+           "@type":"Person",
+           "email":"reza@ddpo.ir",
+           "givenName":"Reza",
+           "familyName": "Nasri"
+        },
+        {
+           "@type":"Person",
+           "email":"richard.koehler@outlook.de",
+           "givenName":"Richard",
+           "familyName": "Koehler"
+        },
+        {
+           "@type":"Person",
+           "email":"rie.acad@gmail.com",
+           "givenName":"Riessarius",
+           "familyName": "Stargardsky"
+        },
+        {
+           "@type":"Person",
+           "email":"r.oostenveld@gmail.com",
+           "givenName":"Robert",
+           "familyName": "Oostenveld"
+        },
+        {
+           "@type":"Person",
+           "email":"robbyseymour@gmail.com",
+           "givenName":"Robert",
+           "familyName": "Seymour"
+        },
+        {
+           "@type":"Person",
+           "email":"robintibor@gmail.com",
+           "givenName":"Robin Tibor",
+           "familyName": "Schirrmeister"
+        },
+        {
+           "@type":"Person",
+           "email":"131315c@gmail.com",
+           "givenName":"Rongfei",
+           "familyName": "Jin"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Roy Eric",
+           "familyName": "Wieske"
+        },
+        {
+           "@type":"Person",
+           "email":"ryan.law@mpi.nl",
+           "givenName":"Ryan",
+           "familyName": "Law"
+        },
+        {
+           "@type":"Person",
+           "email":"sagung.pai@gmail.com",
+           "givenName":"Sagun",
+           "familyName": "Pai"
+        },
+        {
+           "@type":"Person",
+           "email":"u1265119@unimail.hud.ac.uk",
+           "givenName":"Sam",
+           "familyName": "Perry"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Samuel",
+           "familyName": "Louviot"
+        },
+        {
+           "@type":"Person",
+           "email":"santiaguzz@gmail.com",
+           "givenName":"Santi",
+           "familyName": "Martínez"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sawradip",
+           "familyName": "Saha"
+        },
+        {
+           "@type":"Person",
+           "email":"s.mathot@cogsci.nl",
+           "givenName":"Sebastiaan",
+           "familyName": "Mathot"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sebastian",
+           "familyName": "Jentschke"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sebastian",
+           "familyName": "Major"
+        },
+        {
+           "@type":"Person",
+           "email":"sfox@riseup.net",
+           "givenName":"Sebastien",
+           "familyName": "Treguer"
+        },
+        {
+           "@type":"Person",
+           "email":"sebastian.castano@blbt.uni-freiburg.de",
+           "givenName":"Sebastián",
+           "familyName": "Castaño"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Senwen",
+           "familyName": "Deng"
+        },
+        {
+           "@type":"Person",
+           "email":"s.antopolsky@gmail.com",
+           "givenName":"Sergey",
+           "familyName": "Antopolskiy"
+        },
+        {
+           "@type":"Person",
+           "email":"shirazi@ieee.org",
+           "givenName":"Seyed (Yahya)",
+           "familyName": "Shirazi"
+        },
+        {
+           "@type":"Person",
+           "email":"kesharishresth5@gmail.com",
+           "givenName":"Shresth",
+           "familyName": "Keshari"
+        },
+        {
+           "@type":"Person",
+           "email":"baral.shristi@gmail.com",
+           "givenName":"Shristi",
+           "familyName": "Baral"
+        },
+        {
+           "@type":"Person",
+           "email":"baralshristi@gmail.com",
+           "givenName":"Shristi",
+           "familyName": "Baral"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Simeon",
+           "familyName": "Wong"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Simeon",
+           "familyName": "Wong"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Simon M",
+           "familyName": "Hofmann"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Simon-Shlomo",
+           "familyName": "Poil"
+        },
+        {
+           "@type":"Person",
+           "email":"sondre.foslien@gmail.com",
+           "givenName":"Sondre",
+           "familyName": "Foslien"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Sourav",
+           "familyName": "Singh"
+        },
+        {
+           "@type":"Person",
+           "email":"stan.chambon@gmail.com",
+           "givenName":"Stanislas",
+           "familyName": "Chambon"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Steinn Hauser",
+           "familyName": "Magnússon"
+        },
+        {
+           "@type":"Person",
+           "email":"bethard@email.arizona.edu",
+           "givenName":"Steven",
+           "familyName": "Bethard"
+        },
+        {
+           "@type":"Person",
+           "email":"s.m.gutstein@gmail.com",
+           "givenName":"Steven M",
+           "familyName": "Gutstein"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Svea Marie",
+           "familyName": "Meyer"
+        },
+        {
+           "@type":"Person",
+           "email":"twang5@swarthmore.edu",
+           "givenName":"T",
+           "familyName": "Wang"
+        },
+        {
+           "@type":"Person",
+           "email":"tharupahanjayawardana@gmail.com",
+           "givenName":"Tharupahan",
+           "familyName": "Jayawardana"
+        },
+        {
+           "@type":"Person",
+           "email":"thomas.moreau.2010@gmail.com",
+           "givenName":"Thomas",
+           "familyName": "Moreau"
+        },
+        {
+           "@type":"Person",
+           "email":"radman.thomas@gmail.com",
+           "givenName":"Thomas",
+           "familyName": "Radman"
+        },
+        {
+           "@type":"Person",
+           "email":"tim.gates@iress.com",
+           "givenName":"Timothy",
+           "familyName": "Gates"
+        },
+        {
+           "@type":"Person",
+           "email":"TASTONE@mgh.harvard.edu",
+           "givenName":"Tom",
+           "familyName": "Stone"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Tommy",
+           "familyName": "Clausner"
+        },
+        {
+           "@type":"Person",
+           "email":"toomaserikanijarv@gmail.com",
+           "givenName":"Toomas Erik",
+           "familyName": "Anijärv"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Velu Prabhakar",
+           "familyName": "Kumaravel"
+        },
+        {
+           "@type":"Person",
+           "email":"weixu@mail.bnu.edu.cn",
+           "givenName":"Wei",
+           "familyName": "Xu"
+        },
+        {
+           "@type":"Person",
+           "email":"williamfrancisturner@gmail.com",
+           "givenName":"Will",
+           "familyName": "Turner"
+        },
+        {
+           "@type":"Person",
+           "email":"xabier@zuazo.org",
+           "givenName":"Xabier de",
+           "familyName": "Zuazo"
+        },
+        {
+           "@type":"Person",
+           "email":"xia@xiaokai.me",
+           "givenName":"Xiaokai",
+           "familyName": "Xia"
+        },
+        {
+           "@type":"Person",
+           "email":"frostime@foxmail.com",
+           "givenName":"Yiping",
+           "familyName": "Zuo"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Yixiao",
+           "familyName": "Shen"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"Young",
+           "familyName": "Truong"
+        },
+        {
+           "@type":"Person",
+           "email":"850734033@qq.com",
+           "givenName":"Zhi",
+           "familyName": "Zhang"
+        },
+        {
+           "@type":"Person",
+           "email":"ziyizeng@link.cuhk.edu.cn",
+           "givenName":"Ziyi",
+           "familyName": "ZENG"
+        },
+        {
+           "@type":"Person",
+           "email":"btk.codedev@gmail.com",
+           "givenName":"",
+           "familyName": "btkcodedev"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"",
+           "familyName": "buildqa"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"",
+           "familyName": "luzpaz"
+        },
+        {
+           "@type":"Person",
+           "email":"",
+           "givenName":"",
+           "familyName": "user27182"
+        }
+    ]
+}

mne-python/source/doc/Makefile

@@ -0,0 +1,81 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    = -nWT --keep-going
+SPHINXBUILD   = sphinx-build
+MPROF         = SG_STAMP_STARTS=true mprof run -E --python sphinx
+
+# Internal variables.
+ALLSPHINXOPTS   = -d _build/doctrees $(SPHINXOPTS) .
+
+.PHONY: help clean html html-noplot html-pattern linkcheck linkcheck-grep doctest
+
+# make with no arguments will build the first target by default, i.e., build standalone HTML files
+first_target: html-noplot
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html             to make standalone HTML files"
+	@echo "  html-memory      to make standalone HTML files while monitoring memory usage"
+	@echo "  html-pattern     to make standalone HTML files for a specific filename pattern"
+	@echo "  html-front       to make standalone HTML files with only the frontpage examples"
+	@echo "  html-noplot      to make standalone HTML files without plotting"
+	@echo "  clean            to clean HTML files"
+	@echo "  linkcheck        to check all external links for integrity"
+	@echo "  linkcheck-grep   to grep the linkcheck result"
+	@echo "  doctest          to run all doctests embedded in the documentation (if enabled)"
+	@echo "  view             to view the built HTML"
+
+clean:
+	-rm -rf _build sg_execution_times.rst auto_examples auto_tutorials generated *.stc *.fif *.nii.gz
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html."
+
+html-memory:
+	$(MPROF) -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html."
+
+html-pattern:
+	$(SPHINXBUILD) -D sphinx_gallery_conf.filename_pattern=$(PATTERN) -D sphinx_gallery_conf.run_stale_examples=True -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html"
+
+html-pattern-memory:
+	$(MPROF) -D sphinx_gallery_conf.filename_pattern=$(PATTERN) -D sphinx_gallery_conf.run_stale_examples=True -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html"
+
+html-noplot:
+	$(SPHINXBUILD) -D plot_gallery=0 -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html."
+
+html-front:
+	@PATTERN="\(30_mne_dspm_loreta.py\|50_decoding.py\|30_strf.py\|20_cluster_1samp_spatiotemporal.py\|20_visualize_evoked.py\)" make html-pattern
+
+# Aliases for old methods
+html_dev-pattern-memory: html-pattern-memory
+html_dev-pattern: html-pattern
+html_dev-noplot: html-noplot
+html_dev-front: html-front
+
+linkcheck:
+	@$(SPHINXBUILD) -b linkcheck -D nitpicky=0 -q -D plot_gallery=0 -D exclude_patterns="cited.rst,whats_new.rst,configure_git.rst,_includes,changes/dev" -d _build/doctrees . _build/linkcheck
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) _build/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in _build/doctest/output.txt."
+
+view:
+	@python -c "import webbrowser; webbrowser.open_new_tab('file://$(PWD)/_build/html/sg_execution_times.html')"
+
+show: view
+
+serve:
+	python -m http.server -d _build/html

mne-python/source/doc/_includes/bem_model.rst

@@ -0,0 +1,162 @@
+:orphan:
+
+Creating the BEM meshes
+=======================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`bem-model` to link to that section of the implementation.rst page.
+   The next line is a target for :start-after: so we can omit the title from
+   the include:
+   bem-begin-content
+
+.. _bem_watershed_algorithm:
+
+Using the watershed algorithm
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The watershed algorithm [Segonne *et al.*,
+2004] is part of the FreeSurfer software.
+The name of the program is mri_watershed_.
+Its use in the MNE environment is facilitated by the script
+:ref:`mne watershed_bem`.
+
+After ``mne watershed_bem`` has completed, the following files appear in the
+subject's :file:`bem/watershed` directory:
+
+- :file:`{<subject>}_brain_surface` contains the brain surface triangulation.
+
+- :file:`{<subject>}_inner_skull_surface` contains the inner skull
+  triangulation.
+
+- :file:`{<subject>}_outer_skull_surface` contains the outer skull
+  triangulation.
+
+- :file:`{<subject>}_outer_skin_surface` contains the scalp triangulation.
+
+All of these surfaces are in the FreeSurfer format. In addition, there will be
+a file called :file:`bem/watershed/ws.mgz` which contains the brain MRI
+volume. Furthermore, ``mne watershed_bem`` script converts the scalp surface to
+fif format and saves the result to :file:`bem/{<subject>}-head.fif`.
+
+.. _bem_flash_algorithm:
+
+Using FLASH images
+~~~~~~~~~~~~~~~~~~
+
+This method depends on the availablily of MRI data acquired with a multi-echo
+FLASH sequence at two flip angles (5 and 30 degrees). These data can be
+acquired separately from the MPRAGE data employed in FreeSurfer cortical
+reconstructions but it is strongly recommended that they are collected at the
+same time with the MPRAGEs or at least with the same scanner. For easy
+co-registration, the images should have FOV, matrix, slice thickness, gap, and
+slice orientation as the MPRAGE data. For information on suitable pulse
+sequences, see :footcite:t:`FischlEtAl2004`.
+
+Creation of the BEM meshes using this method involves the following steps:
+
+- Creating a synthetic 5-degree flip angle FLASH volume, register
+  it with the MPRAGE data, and run the segmentation and meshing program.
+  This step is accomplished by running the script :ref:`mne flash_bem`.
+
+- Inspecting the meshes with tkmedit, see :ref:`inspecting-meshes`.
+
+.. note:: Different methods can be employed for the creation of the
+          individual surfaces. For example, it may turn out that the
+          watershed algorithm produces are better quality skin surface than
+          the segmentation approach based on the FLASH images. If this is
+          the case, ``outer_skin.surf`` can set to point to the corresponding
+          watershed output file while the other surfaces can be picked from
+          the FLASH segmentation data.
+
+
+Organizing MRI data into directories
+------------------------------------
+
+Since all images comprising the multi-echo FLASH data are contained in a single
+series, it is necessary to organize the images according to the echoes before
+proceeding to the BEM surface reconstruction. This can be accomplished by using
+`dcm2niix <https://www.nitrc.org/plugins/mwiki/index.php/dcm2nii:MainPage>`__
+or the MNE-C tool ``mne_organize_dicom`` if necessary, then use
+:func:`mne.bem.convert_flash_mris`.
+
+Creating the surface tessellations
+----------------------------------
+
+The BEM surface segmentation and tessellation is automated with the script
+:ref:`mne flash_bem`. It assumes that a FreeSurfer reconstruction for this
+subject is already in place.
+
+Before running :ref:`mne flash_bem` do the following:
+
+- Create symbolic links from the directories containing the 5-degree and
+  30-degree flip angle FLASH series to ``flash05`` and ``flash30``,
+  respectively:
+
+  - :samp:`ln -s {<FLASH 5 series dir>} flash05`
+
+  - :samp:`ln -s {<FLASH 30 series dir>} flash30`
+
+- Some partition formats (e.g. FAT32) do not support symbolic links. In this
+  case, copy the file to the appropriate series:
+
+  - :samp:`cp {<FLASH 5 series dir>} flash05`
+
+  - :samp:`cp {<FLASH 30 series dir>} flash30`
+
+- Set the ``SUBJECTS_DIR`` and ``SUBJECT`` environment variables or pass
+  the ``--subjects-dir`` and ``--subject`` options to ``mne flash_bem``
+
+.. note:: If ``mne flash_bem`` is run with the ``--noflash30`` option, the
+   :file:`flash30` directory is not needed, *i.e.*, only the 5-degree flip
+   angle flash data are employed.
+
+It may take a while for ``mne flash_bem`` to complete. It uses the FreeSurfer
+directory structure under ``$SUBJECTS_DIR/$SUBJECT``. The script encapsulates
+the following processing steps:
+
+- It creates an mgz file corresponding to each of the eight echoes in each of
+  the FLASH directories in ``mri/flash``. The files will be called
+  :file:`mef {<flip-angle>}_{<echo-number>}.mgz`.
+
+- If the ``unwarp=True`` option is specified, run grad_unwarp and produce
+  files :file:`mef {<flip-angle>}_{<echo-number>}u.mgz`. These files will be
+  then used in the following steps.
+
+- It creates parameter maps in :file:`mri/flash/parameter_maps` using
+  ``mri_ms_fitparms``.
+
+- It creates a synthetic 5-degree flip angle volume in
+  :file:`mri/flash/parameter_maps/flash5.mgz` using ``mri_synthesize``.
+
+- Using ``fsl_rigid_register``, it creates a registered 5-degree flip angle
+  volume ``mri/flash/parameter_maps/flash5_reg.mgz`` by registering
+  :file:`mri/flash/parameter_maps/flash5.mgz` to the *T1* volume under ``mri``.
+
+- Using ``mri_convert``, it converts the flash5_reg volume to COR format under
+  ``mri/flash5``. If necessary, the T1 and brain volumes are also converted
+  into the COR format.
+
+- It runs ``mri_make_bem_surfaces`` to create the BEM surface tessellations.
+
+- It creates the directory :file:`bem/flash`, moves the tri-format
+  tringulations there and creates the corresponding FreeSurfer surface files
+  in the same directory.
+
+- The COR format volumes created by ``mne flash_bem`` are removed.
+
+If the ``--noflash30`` option is specified to ``mne flash_bem``,
+steps 3 and 4 in the above are replaced by averaging over the different
+echo times in 5-degree flip angle data.
+
+.. _inspecting-meshes:
+
+Inspecting the meshes
+---------------------
+
+It is advisable to check the validity of the BEM meshes before
+using them. This can be done with:
+
+- the ``--view`` option of :ref:`mne flash_bem`
+- calling :func:`mne.viz.plot_bem` directly
+- Using FreeSurfer tools ``tkmedit`` or ``freeview``

mne-python/source/doc/_includes/channel_interpolation.rst

@@ -0,0 +1,70 @@
+:orphan:
+
+Bad channel repair via interpolation
+====================================
+
+Spherical spline interpolation (EEG)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`channel-interpolation` to link to that section of the
+   implementation.rst page. The next line is a target for :start-after: so we
+   can omit the title from the include:
+   channel-interpolation-begin-content
+
+In short, data repair using spherical spline interpolation :footcite:`PerrinEtAl1989` consists of the following steps:
+
+* Project the good and bad electrodes onto a unit sphere
+* Compute a mapping matrix that maps :math:`N` good channels to :math:`M` bad channels
+* Use this mapping matrix to compute interpolated data in the bad channels
+
+Spherical splines assume that the potential :math:`V(\boldsymbol{r_i})` at any point :math:`\boldsymbol{r_i}` on the surface of the sphere can be represented by:
+
+.. math:: V(\boldsymbol{r_i}) = c_0 + \sum_{j=1}^{N}c_{i}g_{m}(cos(\boldsymbol{r_i}, \boldsymbol{r_{j}}))
+   :name: model
+
+where the :math:`C = (c_{1}, ..., c_{N})^{T}` are constants which must be estimated. The function :math:`g_{m}(\cdot)` of order :math:`m` is given by:
+
+.. math:: g_{m}(x) = \frac{1}{4 \pi}\sum_{n=1}^{\infty} \frac{2n + 1}{(n(n + 1))^m}P_{n}(x)
+
+where :math:`P_{n}(x)` are `Legendre polynomials`_ of order :math:`n`.
+
+.. _Legendre polynomials: https://en.wikipedia.org/wiki/Legendre_polynomials
+
+To estimate the constants :math:`C`, we must solve the following two equations simultaneously:
+
+.. math:: G_{ss}C + T_{s}c_0 = X
+   :name: matrix_form
+
+.. math:: {T_s}^{T}C = 0
+   :name: constraint
+
+where :math:`G_{ss} \in R^{N \times N}` is a matrix whose entries are :math:`G_{ss}[i, j] = g_{m}(cos(\boldsymbol{r_i}, \boldsymbol{r_j}))` and :math:`X \in R^{N \times 1}` are the potentials :math:`V(\boldsymbol{r_i})` measured at the good channels. :math:`T_{s} = (1, 1, ..., 1)^\top` is a column vector of dimension :math:`N`. Equation :eq:`matrix_form` is the matrix formulation of Equation :eq:`model` and equation :eq:`constraint` is like applying an average reference to the data. From equation :eq:`matrix_form` and :eq:`constraint`, we get:
+
+.. math:: \begin{bmatrix} c_0 \\ C \end{bmatrix} = {\begin{bmatrix} {T_s}^{T} && 0 \\ T_s && G_{ss} \end{bmatrix}}^{-1} \begin{bmatrix} 0 \\ X \end{bmatrix} = C_{i}X
+   :name: estimate_constant
+
+:math:`C_{i}` is the same as matrix :math:`{\begin{bmatrix} {T_s}^{T} && 0 \\ T_s && G_{ss} \end{bmatrix}}^{-1}` but with its first column deleted, therefore giving a matrix of dimension :math:`(N + 1) \times N`.
+
+Now, to estimate the potentials :math:`\hat{X} \in R^{M \times 1}` at the bad channels, we have to do:
+
+.. math:: \hat{X} = G_{ds}C + T_{d}c_0
+   :name: estimate_data
+
+where :math:`G_{ds} \in R^{M \times N}` computes :math:`g_{m}(\boldsymbol{r_i}, \boldsymbol{r_j})` between the bad and good channels. :math:`T_{d} = (1, 1, ..., 1)^\top` is a column vector of dimension :math:`M`. Plugging in equation :eq:`estimate_constant` in :eq:`estimate_data`, we get
+
+.. math:: \hat{X} = \begin{bmatrix} T_d && G_{ds} \end{bmatrix} \begin{bmatrix} c_0 \\ C \end{bmatrix} = \underbrace{\begin{bmatrix} T_d && G_{ds} \end{bmatrix} C_{i}}_\text{mapping matrix}X
+
+
+To interpolate bad channels, one can simply do:
+
+    >>> evoked.interpolate_bads(reset_bads=False)  # doctest: +SKIP
+
+and the bad channel will be fixed.
+
+.. target for :end-before: channel-interpolation-end-content
+
+.. topic:: Examples:
+
+    * :ref:`ex-interpolate-bad-channels`

mne-python/source/doc/_includes/channel_types.rst

@@ -0,0 +1,104 @@
+:orphan:
+
+Supported channel types
+=======================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`channel-types` to link to that section of the implementation.rst
+   page. The next line is a target for :start-after: so we can omit the title
+   from the include:
+   channel-types-begin-content
+
+.. NOTE: In the future, this table should be automatically synchronized with
+   the sensor types listed in the glossary. Perhaps a table showing data type
+   channels as well as non-data type channels should be added to the glossary
+   and displayed here too.
+
+Channel types are represented in MNE-Python with shortened or abbreviated
+names. This page lists all supported channel types, their abbreviated names,
+and the measurement unit used to represent data of that type. Where channel
+types occur in two or more sub-types, the sub-type abbreviations are given in
+parentheses. More information about measurement units is given in the
+:ref:`units` section.
+
+.. NOTE: To include only the table, here's a different target for :start-after:
+   channel-types-begin-table
+
+.. cssclass:: table-bordered
+.. rst-class:: midvalign
+
+================= ========================================= =================
+Channel type      Description                               Measurement unit
+================= ========================================= =================
+eeg               scalp electroencephalography (EEG)        Volts
+
+meg (mag)         Magnetoencephalography (magnetometers)    Teslas
+
+meg (grad)        Magnetoencephalography (gradiometers)     Teslas/meter
+
+ecg               Electrocardiography (ECG)                 Volts
+
+seeg              Stereotactic EEG channels                 Volts
+
+dbs               Deep brain stimulation (DBS)              Volts
+
+ecog              Electrocorticography (ECoG)               Volts
+
+fnirs (hbo)       Functional near-infrared spectroscopy     Moles/liter
+                  (oxyhemoglobin)
+
+fnirs (hbr)       Functional near-infrared spectroscopy     Moles/liter
+                  (deoxyhemoglobin)
+
+emg               Electromyography (EMG)                    Volts
+
+eog               Electrooculography  (EOG)                 Volts
+
+bio               Miscellaneous biological channels (e.g.,  Arbitrary units
+                  skin conductance)
+
+stim              stimulus (a.k.a. trigger) channels        Arbitrary units
+
+resp              respiration monitoring channel            Volts
+
+chpi              continuous head position indicator        Teslas
+                  (HPI) coil channels
+
+exci              Flux excitation channel
+
+ias               Internal Active Shielding data
+                  (Triux systems only?)
+
+syst              System status channel information
+                  (Triux systems only)
+
+temperature       Temperature                               Degrees Celsius
+
+gsr               Galvanic skin response                    Siemens
+
+ref_meg           Reference Magnetometers                   Teslas
+
+dipole            Dipole amplitude                          Amperes
+
+gof               Goodness of fit (GOF)                     Goodness-of-fit
+
+cw-nirs (amp)     Continuous-wave functional near-infrared  Volts
+                  spectroscopy (CW-fNIRS) (CW amplitude)
+
+fd-nirs (ac amp)  Frequency-domain near-infrared            Volts
+                  spectroscopy (FD-NIRS AC amplitude)
+
+fd-nirs (phase)   Frequency-domain near-infrared            Radians
+                  spectroscopy (FD-NIRS phase)
+
+fnirs (od)        Functional near-infrared spectroscopy     Volts
+                  (optical density)
+
+csd               Current source density                    Volts per square
+                                                            meter
+
+eyegaze           Eye-tracking (gaze position)              Arbitrary units
+
+pupil             Eye-tracking (pupil size)                 Arbitrary units
+================= ========================================= =================

mne-python/source/doc/_includes/data_formats.rst

@@ -0,0 +1,86 @@
+:orphan:
+
+Supported data formats
+======================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content,
+   link to :ref:`data-formats`. The next line is
+   a target for :start-after: so we can omit the title above:
+   data-formats-begin-content
+
+When MNE-Python loads sensor data, the data are stored in a Python object of
+type :class:`mne.io.Raw`. Specialized loading functions are provided for the
+raw data file formats from a variety of equipment manufacturers. All raw data
+input/output functions in MNE-Python are found in :mod:`mne.io` and start
+with :samp:`read_raw_{*}`; see the documentation for each reader function for
+more info on reading specific file types.
+
+As seen in the table below, there are also a few formats defined by other
+neuroimaging analysis software packages that are supported (EEGLAB,
+FieldTrip). Like the equipment-specific loading functions, these will also
+return an object of class :class:`~mne.io.Raw`; additional functions are
+available for reading data that has already been epoched or averaged (see
+table).
+
+.. NOTE: To include only the table, here's a different target for :start-after:
+   data-formats-begin-table
+
+.. cssclass:: table-bordered
+.. rst-class:: midvalign
+
+============  ============================================  =========  ===================================
+Data type     File format                                   Extension  MNE-Python function
+============  ============================================  =========  ===================================
+MEG           :ref:`Artemis123 <import-artemis>`            .bin       :func:`mne.io.read_raw_artemis123`
+
+MEG           :ref:`4-D Neuroimaging / BTi <import-bti>`    <dir>      :func:`mne.io.read_raw_bti`
+
+MEG           :ref:`CTF <import-ctf>`                       <dir>      :func:`mne.io.read_raw_ctf`
+
+MEG and EEG   :ref:`Elekta Neuromag <import-neuromag>`      .fif       :func:`mne.io.read_raw_fif`
+
+MEG           :ref:`FIL OPM MEG <import-fil>`               .bin       :func:`mne.io.read_raw_fil`
+
+MEG           :ref:`KIT <import-kit>`                       .sqd       :func:`mne.io.read_raw_kit`,
+                                                                       :func:`mne.read_epochs_kit`
+
+MEG and EEG   :ref:`FieldTrip <import-fieldtrip>`           .mat       :func:`mne.io.read_raw_fieldtrip`,
+                                                                       :func:`mne.read_epochs_fieldtrip`,
+                                                                       :func:`mne.read_evoked_fieldtrip`
+
+EEG           :ref:`Brainvision <import-bv>`                .vhdr      :func:`mne.io.read_raw_brainvision`
+
+EEG           :ref:`Biosemi data format <import-biosemi>`   .bdf       :func:`mne.io.read_raw_bdf`
+
+EEG           :ref:`Neuroscan CNT <import-cnt>`             .cnt       :func:`mne.io.read_raw_cnt`
+
+EEG           :ref:`European data format <import-edf>`      .edf       :func:`mne.io.read_raw_edf`
+
+EEG           :ref:`EEGLAB <import-set>`                    .set       :func:`mne.io.read_raw_eeglab`,
+                                                                       :func:`mne.read_epochs_eeglab`
+
+EEG           :ref:`EGI simple binary <import-egi>`         .egi       :func:`mne.io.read_raw_egi`
+
+EEG           :ref:`EGI MFF format <import-mff>`            .mff       :func:`mne.io.read_raw_egi`
+
+EEG           :ref:`eXimia <import-nxe>`                    .nxe       :func:`mne.io.read_raw_eximia`
+
+EEG           :ref:`General data format <import-gdf>`       .gdf       :func:`mne.io.read_raw_gdf`
+
+EEG           :ref:`Nicolet <import-nicolet>`               .data      :func:`mne.io.read_raw_nicolet`
+
+EEG           :ref:`Persyst <import-persyst>`               .lay       :func:`mne.io.read_raw_persyst`
+
+NIRS          :ref:`NIRx <import-nirx>`                     directory  :func:`mne.io.read_raw_nirx`
+
+NIRS          :ref:`BOXY <import-boxy>`                     directory  :func:`mne.io.read_raw_boxy`
+
+EYETRACK      SR eyelink ASCII files                        .asc       :func:`mne.io.read_raw_eyelink`
+
+iEEG          MEF3                                          .mefd      :func:`mne.io.read_raw_mef`
+
+============  ============================================  =========  ===================================
+
+More details are provided in the tutorials in the :ref:`tut-data-formats`
+section.

mne-python/source/doc/_includes/dig_formats.rst

@@ -0,0 +1,47 @@
+:orphan:
+
+.. _dig-formats:
+
+Supported formats for digitized 3D locations
+============================================
+
+.. NOTE: If you want to link to this content, link to :ref:`dig-formats`
+   for the implementation page. The next line is
+   a target for :start-after: so we can omit the title above:
+   dig-formats-begin-content
+
+MNE-Python can load 3D point locations obtained by digitization systems.
+Such files allow to obtain a :class:`montage <mne.channels.DigMontage>`
+that can then be added to :class:`~mne.io.Raw` objects with the
+:meth:`~mne.io.Raw.set_montage`. See the documentation for each reader
+function for more info on reading specific file types.
+
+.. NOTE: To include only the table, here's a different target for :start-after:
+   dig-formats-begin-table
+
+.. cssclass:: table-bordered
+.. rst-class:: midvalign
+
+=====================  ================  ==============================================
+Vendor                 Extension(s)      MNE-Python function
+=====================  ================  ==============================================
+Neuromag               .fif              :func:`mne.channels.read_dig_fif`
+
+Polhemus ISOTRAK       .hsp, .elp, .eeg  :func:`mne.channels.read_dig_polhemus_isotrak`
+
+EGI                    .xml              :func:`mne.channels.read_dig_egi`
+
+MNE-C                  .hpts             :func:`mne.channels.read_dig_hpts`
+
+Brain Products         .bvct             :func:`mne.channels.read_dig_captrak`
+
+Compumedics            .dat, .cdt        :func:`mne.channels.read_dig_curry`
+
+Compumedics (legacy)   .dat              :func:`mne.channels.read_dig_dat`
+=====================  ================  ==============================================
+
+To load Polhemus FastSCAN files you can use
+:func:`montage <mne.channels.read_polhemus_fastscan>`.
+
+It is also possible to make a :class:`montage <mne.channels.DigMontage>`
+from arrays with :func:`mne.channels.make_dig_montage`.

mne-python/source/doc/_includes/forward.rst

@@ -0,0 +1,726 @@
+:orphan:
+
+The forward solution
+====================
+
+This page covers the definitions of different coordinate systems employed in
+MNE software and FreeSurfer, the details of the computation of the forward
+solutions, and the associated low-level utilities.
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`ch_forward` to link to that section of the implementation.rst page.
+   The next line is a target for :start-after: so we can omit the title from
+   the include:
+   forward-begin-content
+
+
+.. _coordinate_systems:
+
+MEG/EEG and MRI coordinate systems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. note:: Coordinate systems in MNE-Python
+    :class: sidebar
+
+    In some MNE-Python objects (e.g., :class:`~mne.Forward`,
+    :class:`~mne.SourceSpaces`, etc), information about the coordinate frame is
+    encoded as a constant integer value. The meaning of those integers is
+    determined `in the source code
+    <https://github.com/mne-tools/mne-python/blob/079c868240a898204bf82b2f1bf0e04cdee75da1/mne/_fiff/constants.py#L263-L275>`__.
+
+The coordinate systems used in MNE software (and FreeSurfer) and their
+relationships are depicted in :ref:`coordinate_system_figure`. Except for the
+*sensor coordinates*, all of the coordinate systems are Cartesian and have the
+"RAS" (Right-Anterior-Superior) orientation, *i.e.*, the :math:`x` axis points
+to the right, the :math:`y` axis to the front, and the :math:`z` axis up.
+
+.. _coordinate_system_figure:
+
+.. figure:: ../_static/CoordinateSystems.png
+    :alt: MEG/EEG and MRI coordinate systems
+
+    MEG/EEG and MRI coordinate systems
+
+    The coordinate transforms present in the fif files in MNE and the
+    FreeSurfer files as well as those set to fixed values are indicated with
+    :math:`T_x`, where :math:`x` identifies the transformation.
+
+The coordinate systems related to MEG/EEG data are:
+
+**Head coordinates**
+
+    This is a coordinate system defined with help of the fiducial landmarks
+    (nasion and the two auricular points). In fif files, EEG electrode
+    locations are given in this coordinate system. In addition, the head
+    digitization data acquired in the beginning of an MEG, MEG/EEG, or EEG
+    acquisition are expressed in head coordinates. For details, see
+    :ref:`coordinate_systems`.
+
+**Device coordinates**
+
+    This is a coordinate system tied to the MEG device. The relationship of the
+    Device and Head coordinates is determined during an MEG measurement by
+    feeding current to three to five head-position indicator (HPI) coils and by
+    determining their locations with respect to the MEG sensor array from the
+    magnetic fields they generate.
+
+**Sensor coordinates**
+
+    Each MEG sensor has a local coordinate system defining the orientation and
+    location of the sensor. With help of this coordinate system, the numerical
+    integration data needed for the computation of the magnetic field can be
+    expressed conveniently as discussed in :ref:`coil_geometry_information`.
+    The channel information data in the fif files contain the information to
+    specify the coordinate transformation between the coordinates of each
+    sensor and the MEG device coordinates.
+
+The coordinate systems related to MRI data are:
+
+**Surface RAS coordinates**
+
+    The FreeSurfer surface data are expressed in this coordinate system. The
+    origin of this coordinate system is at the center of the conformed
+    FreeSurfer MRI volumes (usually 256 x 256 x 256 isotropic 1-mm3  voxels)
+    and the axes are oriented along the axes of this volume. The BEM surface
+    and the locations of the sources in the source space are usually expressed
+    in this coordinate system in the fif files. In this manual, the *Surface
+    RAS coordinates* are usually referred to as *MRI coordinates* unless there
+    is need to specifically discuss the different MRI-related coordinate
+    systems.
+
+**RAS coordinates**
+
+    This coordinate system has axes identical to the Surface RAS coordinates
+    but the location of the origin is different and defined by the original MRI
+    data, i.e. , the origin is in a scanner-dependent location. There is hardly
+    any need to refer to this coordinate system explicitly in the analysis with
+    the MNE software. However, since the Talairach coordinates, discussed
+    below, are defined with respect to *RAS coordinates* rather than the
+    *Surface RAS coordinates*, the RAS coordinate system is implicitly involved
+    in the transformation between Surface RAS coordinates and the two
+    *Talairach* coordinate systems.
+
+**MNI Talairach coordinates**
+
+    The definition of this coordinate system is discussed, e.g., in
+    https://imaging.mrc-cbu.cam.ac.uk/imaging/MniTalairach. This transformation
+    is determined during the FreeSurfer reconstruction process. These
+    coordinates are in MNI305 space.
+
+**FreeSurfer Talairach coordinates**
+
+    The problem with the MNI Talairach coordinates is that the linear MNI
+    Talairach transform does not match the brains completely to the Talairach
+    brain. This is probably because the Talairach atlas brain is a rather odd
+    shape, and as a result, it is difficult to match a standard brain to the
+    atlas brain using an affine transform. As a result, the MNI brains are
+    slightly larger (in particular higher, deeper and longer) than the
+    Talairach brain. The differences are larger as you get further from the
+    middle of the brain, towards the outside. The FreeSurfer Talairach
+    coordinates mitigate this problem by additing a an additional
+    transformation, defined separately for negative and positive MNI Talairach
+    :math:`z` coordinates. These two transformations, denoted by :math:`T_-`
+    and :math:`T_+` in :ref:`coordinate_system_figure`, are fixed as discussed in
+    https://imaging.mrc-cbu.cam.ac.uk/imaging/MniTalairach (*Approach 2*).
+
+The different coordinate systems are related by coordinate transformations
+depicted in :ref:`coordinate_system_figure`. The arrows and coordinate
+transformation symbols (:math:`T_x`) indicate the transformations actually
+present in the FreeSurfer files. Generally,
+
+.. math::    \begin{bmatrix}
+        x_2 \\
+        y_2 \\
+        z_2 \\
+        1
+            \end{bmatrix} = T_{12} \begin{bmatrix}
+        x_1 \\
+        y_1 \\
+        z_1 \\
+        1
+            \end{bmatrix} = \begin{bmatrix}
+        R_{11} & R_{12} & R_{13} & x_0 \\
+        R_{21} & R_{22} & R_{23} & y_0 \\
+        R_{31} & R_{32} & R_{33} & z_0 \\
+        0 & 0 & 0 & 1
+            \end{bmatrix} \begin{bmatrix}
+        x_1 \\
+        y_1 \\
+        z_1 \\
+        1
+            \end{bmatrix}\ ,
+
+where :math:`x_k`, :math:`y_k`,and :math:`z_k` are the location coordinates in
+two coordinate systems, :math:`T_{12}` is the coordinate transformation from
+coordinate system "1" to "2", :math:`x_0`, :math:`y_0`, and :math:`z_0` is the
+location of the origin of coordinate system "1" in coordinate system "2", and
+:math:`R_{jk}` are the elements of the rotation matrix relating the two
+coordinate systems. The coordinate transformations are present in different
+files produced by FreeSurfer and MNE.
+The fixed transformations :math:`T_-` and :math:`T_+` are:
+
+.. math::    T_{-} = \begin{bmatrix}
+        0.99 & 0 & 0 & 0 \\
+        0 & 0.9688 & 0.042 & 0 \\
+        0 & -0.0485 & 0.839 & 0 \\
+        0 & 0 & 0 & 1
+            \end{bmatrix}
+
+and
+
+.. math::    T_{+} = \begin{bmatrix}
+        0.99 & 0 & 0 & 0 \\
+        0 & 0.9688 & 0.046 & 0 \\
+        0 & -0.0485 & 0.9189 & 0 \\
+        0 & 0 & 0 & 1
+            \end{bmatrix}
+
+.. note::
+   This section does not discuss the transformation between the MRI voxel
+   indices and the different MRI coordinates. However, it is important to note
+   that in FreeSurfer, MNE, as well as in Neuromag software an integer voxel
+   coordinate corresponds to the location of the center of a voxel. Detailed
+   information on the FreeSurfer MRI systems can be found at
+   https://surfer.nmr.mgh.harvard.edu/fswiki/CoordinateSystems.
+   The symbols :math:`T_x` are defined in :ref:`coordinate_system_figure`.
+
+.. tabularcolumns:: |p{0.2\linewidth}|p{0.3\linewidth}|p{0.5\linewidth}|
+.. table:: Coordinate transformations in FreeSurfer and MNE software packages
+
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | Transformation               | FreeSurfer                    | MNE                                             |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_1`                  | Not present                   | | Measurement data files                        |
+    |                              |                               | | Forward solution files (``*fwd.fif``)         |
+    |                              |                               | | Inverse operator files (``*inv.fif``)         |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_{s_1}\dots T_{s_n}` | Not present                   | Channel information in files                    |
+    |                              |                               | containing :math:`T_1`.                         |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_2`                  | Not present                   | | MRI description filesSeparate                 |
+    |                              |                               | | Separate ``-trans.fif`` files                 |
+    |                              |                               | | from :ref:`mne coreg`                         |
+    |                              |                               | | Forward solution files                        |
+    |                              |                               | | Inverse operator files                        |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_3`                  | ``mri/*mgz`` files            | :class:`nibabel.freesurfer.mghformat.MGHImage`  |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_4`                  | mri/transforms/talairach.xfm  | Internal reading                                |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_-`                  | Hardcoded in software         | Hardcoded in software.                          |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+    | :math:`T_+`                  | Hardcoded in software         | Hardcoded in software.                          |
+    +------------------------------+-------------------------------+-------------------------------------------------+
+
+.. _head_device_coords:
+
+The head and device coordinate systems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. figure:: ../_static/HeadCS.png
+    :alt: Head coordinate system
+
+    The head coordinate system
+
+The MEG/EEG head coordinate system employed in the MNE software is a
+right-handed Cartesian coordinate system. The direction of :math:`x` axis is
+from left to right, that of :math:`y` axis to the front, and the :math:`z` axis
+thus points up.
+
+The :math:`x` axis of the head coordinate system passes through the two
+periauricular or preauricular points digitized before acquiring the data with
+positive direction to the right. The :math:`y` axis passes through the nasion
+and is normal to the :math:`x` axis. The :math:`z` axis points up according to
+the right-hand rule and is normal to the :math:`xy` plane.
+
+The origin of the MEG device coordinate system is device dependent. Its origin
+is located approximately at the center of a sphere which fits the occipital
+section of the MEG helmet best with :math:`x` axis axis going from left to
+right and :math:`y` axis pointing front. The :math:`z` axis is, again, normal
+to the :math:`xy` plane with positive direction up.
+
+.. note::
+   The above definition is identical to that of the Neuromag MEG/EEG (head)
+   coordinate system. However, in 4-D Neuroimaging and CTF MEG systems the head
+   coordinate frame definition is different. The origin of the coordinate
+   system is at the midpoint of the left and right auricular points. The
+   :math:`x` axis passes through the nasion and the origin with positive
+   direction to the front. The :math:`y` axis is perpendicular to the :math:`x`
+   axis on the and lies in the plane defined by the three fiducial landmarks,
+   positive direction from right to left. The :math:`z` axis is normal to the
+   plane of the landmarks, pointing up. Note that in this convention the
+   auricular points are not necessarily located on :math:`y` coordinate axis.
+   The file conversion utilities take care of these idiosyncrasies and convert
+   all coordinate information to the MNE software head coordinate frame.
+
+Creating a surface-based source space
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The fif format source space files containing the dipole locations and
+orientations are created with :func:`mne.setup_source_space`.
+
+Creating a volumetric or discrete source space
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to source spaces confined to a surface, the MNE software provides
+some support for three-dimensional source spaces bounded by a surface as well
+as source spaces comprised of discrete, arbitrarily located source points. The
+:func:`mne.setup_volume_source_space` utility assists in generating such source
+spaces.
+
+Creating the BEM meshes
+~~~~~~~~~~~~~~~~~~~~~~~
+
+See :ref:`bem-model`.
+
+Topology checks
+---------------
+
+The following topology checks are performed during the creation of BEM models:
+
+- The completeness of each surface is confirmed by calculating the total solid
+  angle subtended by all triangles from a point inside the triangulation. The
+  result should be very close to :math:`4 \pi`. If the result is :math:`-4 \pi`
+  instead, it is conceivable that the ordering of the triangle vertices is
+  incorrect and the ``--swap`` option should be specified.
+
+- The correct ordering of the surfaces is verified by checking that the
+  surfaces are inside each other as expected. This is accomplished by checking
+  that the sum solid angles subtended by triangles of a surface :math:`S_k` at
+  all vertices of another surface :math:`S_p` which is supposed to be inside it
+  equals :math:`4 \pi`. Naturally, this check is applied only if the model has
+  more than one surface. Since the surface relations are transitive, it is
+  enough to check that the outer skull surface is inside the skin surface and
+  that the inner skull surface is inside the outer skull one.
+
+- The extent of each of the triangulated volumes is checked. If the extent is
+  smaller than 50mm, an error is reported. This may indicate that the vertex
+  coordinates have been specified in meters instead of millimeters.
+
+
+Computing the BEM geometry data
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The utility :func:`mne.make_bem_solution` computes the geometry information for
+BEM.
+
+.. _coil_geometry_information:
+
+Coil geometry information
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This Section explains the presentation of MEG detection coil geometry
+information the approximations used for different detection coils in MNE
+software. Two pieces of information are needed to characterize the detectors:
+
+- The location and orientation a local coordinate system for each detector.
+
+- A unique identifier, which has an one-to-one correspondence to the
+  geometrical description of the coil.
+
+.. note:: MNE ships with several coil geometry configurations. They can be
+          found in ``mne/data``. See :ref:`ex-plot-meg-sensors` for a
+          comparison between different coil geometries, and
+          :ref:`implemented_coil_geometries` for detailed information regarding
+          the files describing Neuromag coil geometries.
+
+
+The sensor coordinate system
+----------------------------
+
+The sensor coordinate system is completely characterized by the location of its
+origin and the direction cosines of three orthogonal unit vectors pointing to
+the directions of the x, y, and z axis. In fact, the unit vectors contain
+redundant information because the orientation can be uniquely defined with
+three angles. The measurement fif files list these data in MEG device
+coordinates. Transformation to the MEG head coordinate frame can be easily
+accomplished by applying the device-to-head coordinate transformation matrix
+available in the data files provided that the head-position indicator was used.
+Optionally, the MNE software forward calculation applies another coordinate
+transformation to the head-coordinate data to bring the coil locations and
+orientations to the MRI coordinate system.
+
+If :math:`r_0` is a row vector for the origin of the local sensor coordinate
+system and :math:`e_x`, :math:`e_y`, and :math:`e_z` are the row vectors for
+the three orthogonal unit vectors, all given in device coordinates, a location
+of a point :math:`r_C` in sensor coordinates is transformed to device
+coordinates (:math:`r_D`) by
+
+.. math::    [r_D 1] = [r_C 1] T_{CD}\ ,
+
+where
+
+.. math::    T = \begin{bmatrix}
+        e_x & 0 \\
+        e_y & 0 \\
+        e_z & 0 \\
+        r_{0D} & 1
+            \end{bmatrix}\ .
+
+Calculation of the magnetic field
+---------------------------------
+
+The forward calculation in the MNE software computes the signals detected by
+each MEG sensor for three orthogonal dipoles at each source space location.
+This requires specification of the conductor model, the location and
+orientation of the dipoles, and the location and orientation of each MEG sensor
+as well as its coil geometry.
+
+The output of each SQUID sensor is a weighted sum of the magnetic fluxes
+threading the loops comprising the detection coil. Since the flux threading a
+coil loop is an integral of the magnetic field component normal to the coil
+plane, the output of the k :sup:`th` MEG channel, :math:`b_k` can be
+approximated by:
+
+.. math::    b_k = \sum_{p = 1}^{N_k} {w_{kp} B(r_{kp}) \cdot n_{kp}}
+
+where :math:`r_{kp}` are a set of :math:`N_k` integration points covering the
+pickup coil loops of the sensor, :math:`B(r_{kp})` is the magnetic field due to
+the current sources calculated at :math:`r_{kp}`, :math:`n_{kp}` are the coil
+normal directions at these points, and :math:`w_{kp}` are the weights
+associated to the integration points. This formula essentially presents
+numerical integration of the magnetic field over the pickup loops of sensor
+:math:`k`.
+
+There are three accuracy levels for the numerical integration expressed above.
+The *simple* accuracy means the simplest description of the coil. This accuracy
+is not used in the MNE forward calculations. The *normal* or *recommended*
+accuracy typically uses two integration points for planar gradiometers, one in
+each half of the pickup coil and four evenly distributed integration points for
+magnetometers. This is the default accuracy used by MNE. If the ``--accurate``
+option is specified, the forward calculation typically employs a total of eight
+integration points for planar gradiometers and sixteen for magnetometers.
+Detailed information about the integration points is given in the next section.
+
+
+.. _implemented_coil_geometries:
+
+Implemented coil geometries
+---------------------------
+
+This section describes the coil geometries currently implemented
+in MNE. The coil types fall in two general categories:
+
+- Axial gradiometers and planar gradiometers
+  and
+
+- Planar magnetometers.
+
+For axial sensors, the *z* axis of the local coordinate system is parallel to
+the field component detected, *i.e.*, normal to the coil plane.For circular
+coils, the orientation of the *x* and *y* axes on the plane normal to the z
+axis is irrelevant. In the square coils employed in the Vectorview (TM) system
+the *x* axis is chosen to be parallel to one of the sides of the magnetometer
+coil. For planar sensors, the *z* axis is likewise normal to the coil plane and
+the x axis passes through the centerpoints of the two coil loops so that the
+detector gives a positive signal when the normal field component increases
+along the *x* axis.
+
+:ref:`normal_coil_descriptions` lists the parameters of the *normal* coil
+geometry descriptions :ref:`accurate_coil_descriptions` lists the *accurate*
+descriptions. For simple accuracy, please consult the coil definition file, see
+:ref:`coil_definition_file`. The columns of the tables contain the following
+data:
+
+- The number identifying the coil id.
+  This number is used in the coil descriptions found in the FIF files.
+
+- Description of the coil.
+
+- Number of integration points used
+
+- The locations of the integration points in sensor coordinates.
+
+- Weights assigned to the field values at the integration points.
+  Some formulas are listed instead of the numerical values to demonstrate
+  the principle of the calculation. For example, in the normal coil
+  descriptions of the planar gradiometers the weights are inverses
+  of the baseline of the gradiometer to show that the output is in
+  T/m.
+
+.. note:: The coil geometry information is stored in the file
+          :file:`mne/data/coil_def.dat`, which is
+          automatically created by the MNE-C utility ``mne_list_coil_def``.
+
+.. tabularcolumns:: |p{0.1\linewidth}|p{0.3\linewidth}|p{0.1\linewidth}|p{0.25\linewidth}|p{0.2\linewidth}|
+.. table:: Normal coil descriptions
+    :name: normal_coil_descriptions
+
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | Id   | Description             | n  | r/mm                             | w                    |
+    +======+=========================+====+==================================+======================+
+    | 2    | Neuromag-122            | 2  | (+/-8.1, 0, 0) mm                | +/-1 ⁄ 16.2mm        |
+    |      | planar gradiometer      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 2000 | A point magnetometer    | 1  | (0, 0, 0)mm                      | 1                    |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3012 | Vectorview type 1       | 2  | (+/-8.4, 0, 0.3) mm              | +/-1 ⁄ 16.8mm        |
+    |      | planar gradiometer      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3013 | Vectorview type 2       | 2  | (+/-8.4, 0, 0.3) mm              | +/-1 ⁄ 16.8mm        |
+    |      | planar gradiometer      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3022 | Vectorview type 1       | 4  | (+/-6.45, +/-6.45, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3023 | Vectorview type 2       | 4  | (+/-6.45, +/-6.45, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3024 | Vectorview type 3       | 4  | (+/-5.25, +/-5.25, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 2000 | An ideal point          | 1  | (0.0, 0.0, 0.0)mm                | 1                    |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4001 | Magnes WH               | 4  | (+/-5.75, +/-5.75, 0.0)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4002 | Magnes WH 3600          | 8  | (+/-4.5, +/-4.5, 0.0)mm          | 1/4                  |
+    |      | axial gradiometer       |    | (+/-4.5, +/-4.5, 50.0)mm         | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4003 | Magnes reference        | 4  | (+/-7.5, +/-7.5, 0.0)mm          | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4004 | Magnes reference        | 8  | (+/-20, +/-20, 0.0)mm            | 1/4                  |
+    |      | gradiometer measuring   |    | (+/-20, +/-20, 135)mm            | -1/4                 |
+    |      | diagonal gradients      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4005 | Magnes reference        | 8  | (87.5, +/-20, 0.0)mm             | 1/4                  |
+    |      | gradiometer measuring   |    | (47.5, +/-20, 0.0)mm             | -1/4                 |
+    |      | off-diagonal gradients  |    | (-87.5, +/-20, 0.0)mm            | 1/4                  |
+    |      |                         |    | (-47.5, +/-20, 0.0)mm            | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5001 | CTF 275 axial           | 8  | (+/-4.5, +/-4.5, 0.0)mm          | 1/4                  |
+    |      | gradiometer             |    | (+/-4.5, +/-4.5, 50.0)mm         | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5002 | CTF reference           | 4  | (+/-4, +/-4, 0.0)mm              | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5003 | CTF reference           | 8  | (+/-8.6, +/-8.6, 0.0)mm          | 1/4                  |
+    |      | gradiometer measuring   |    | (+/-8.6, +/-8.6, 78.6)mm         | -1/4                 |
+    |      | diagonal gradients      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+
+.. note:: If a plus-minus sign occurs in several coordinates, all possible
+          combinations have to be included.
+
+.. tabularcolumns:: |p{0.1\linewidth}|p{0.3\linewidth}|p{0.05\linewidth}|p{0.25\linewidth}|p{0.15\linewidth}|
+.. table:: Accurate coil descriptions
+    :name: accurate_coil_descriptions
+
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | Id   | Description             | n  | r/mm                             | w                    |
+    +======+=========================+====+==================================+======================+
+    | 2    | Neuromag-122 planar     | 8  | +/-(8.1, 0, 0) mm                | +/-1 ⁄ 16.2mm        |
+    |      | gradiometer             |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 2000 | A point magnetometer    | 1  | (0, 0, 0) mm                     | 1                    |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3012 | Vectorview type 1       | 2  | (+/-8.4, 0, 0.3) mm              | +/-1 ⁄ 16.8mm        |
+    |      | planar gradiometer      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3013 | Vectorview type 2       | 2  | (+/-8.4, 0, 0.3) mm              | +/-1 ⁄ 16.8mm        |
+    |      | planar gradiometer      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3022 | Vectorview type 1       | 4  | (+/-6.45, +/-6.45, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3023 | Vectorview type 2       | 4  | (+/-6.45, +/-6.45, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 3024 | Vectorview type 3       | 4  | (+/-5.25, +/-5.25, 0.3)mm        | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4001 | Magnes WH magnetometer  | 4  | (+/-5.75, +/-5.75, 0.0)mm        | 1/4                  |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4002 | Magnes WH 3600          | 4  | (+/-4.5, +/-4.5, 0.0)mm          | 1/4                  |
+    |      | axial gradiometer       |    | (+/-4.5, +/-4.5, 0.0)mm          | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4004 | Magnes reference        | 8  | (+/-20, +/-20, 0.0)mm            | 1/4                  |
+    |      | gradiometer measuring   |    | (+/-20, +/-20, 135)mm            | -1/4                 |
+    |      | diagonal gradients      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 4005 | Magnes reference        | 8  | (87.5, +/-20, 0.0)mm             | 1/4                  |
+    |      | gradiometer measuring   |    | (47.5, +/-20, 0.0)mm             | -1/4                 |
+    |      | off-diagonal gradients  |    | (-87.5, +/-20, 0.0)mm            | 1/4                  |
+    |      |                         |    | (-47.5, +/-20, 0.0)mm            | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5001 | CTF 275 axial           | 8  | (+/-4.5, +/-4.5, 0.0)mm          | 1/4                  |
+    |      | gradiometer             |    | (+/-4.5, +/-4.5, 50.0)mm         | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5002 | CTF reference           | 4  | (+/-4, +/-4, 0.0)mm              | 1/4                  |
+    |      | magnetometer            |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5003 | CTF 275 reference       | 8  | (+/-8.6, +/-8.6, 0.0)mm          | 1/4                  |
+    |      | gradiometer measuring   |    | (+/-8.6, +/-8.6, 78.6)mm         | -1/4                 |
+    |      | diagonal gradients      |    |                                  |                      |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 5004 | CTF 275 reference       | 8  | (47.8, +/-8.5, 0.0)mm            | 1/4                  |
+    |      | gradiometer measuring   |    | (30.8, +/-8.5, 0.0)mm            | -1/4                 |
+    |      | off-diagonal gradients  |    | (-47.8, +/-8.5, 0.0)mm           | 1/4                  |
+    |      |                         |    | (-30.8, +/-8.5, 0.0)mm           | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+    | 6001 | MIT KIT system axial    | 8  | (+/-3.875, +/-3.875, 0.0)mm      | 1/4                  |
+    |      | gradiometer             |    | (+/-3.875, +/-3.875, 0.0)mm      | -1/4                 |
+    +------+-------------------------+----+----------------------------------+----------------------+
+
+
+.. _coil_definition_file:
+
+The coil definition file
+------------------------
+
+The coil geometry information is stored in the text file
+:file:`{$MNE_ROOT}/share/mne/coil_def.dat`. In this file, any lines starting
+with the pound sign (#) are comments. A coil definition starts with a
+description line containing the following fields:
+
+- :samp:`{<class>}`: A number indicating class of this coil.
+
+- :samp:`{<id>}`: Coil ID value. This value is listed in the first column of
+  Tables :ref:`normal_coil_descriptions` and :ref:`accurate_coil_descriptions`.
+
+- :samp:`{<accuracy>}`: The coil representation accuracy. Possible values and
+  their meanings are listed in :ref:`coil_accuracies`.
+
+- :samp:`{<np>}`: Number of integration points in this representation.
+
+- :samp:`{<size/m>}`: The size of the coil. For circular coils this is the
+  diameter of the coil and for square ones the side length of the square. This
+  information is mainly included to facilitate drawing of the coil geometry. It
+  should not be employed to infer a coil approximation for the forward
+  calculations.
+
+- :samp:`{<baseline/m>}`: The baseline of a this kind of a coil. This will be
+  zero for magnetometer coils. This information is mainly included to
+  facilitate drawing of the coil geometry. It should not be employed to infer
+  a coil approximation for the forward calculations.
+
+- :samp:`{<description>}`: Short description of this kind of a coil. If the
+  description contains several words, it is enclosed in quotes.
+
+
+.. tabularcolumns:: |p{0.1\linewidth}|p{0.5\linewidth}|
+.. table:: Coil representation accuracies
+    :name: coil_accuracies
+
+    =======  ====================================================================================
+    Value    Meaning
+    =======  ====================================================================================
+    1        The simplest representation available
+    2        The standard or *normal* representation (see :ref:`normal_coil_descriptions`)
+    3        The most *accurate* representation available (see :ref:`accurate_coil_descriptions`)
+    =======  ====================================================================================
+
+Each coil description line is followed by one or more integration point lines,
+consisting of seven numbers:
+
+- :samp:`{<weight>}`: Gives the weight for this integration point (last column
+  in Tables :ref:`normal_coil_descriptions` and
+  :ref:`accurate_coil_descriptions`).
+
+- :samp:`{<x/m>} {<y/m>} {<z/m>}`: Indicates the location of the integration
+  point (fourth column in Tables :ref:`normal_coil_descriptions` and
+  :ref:`accurate_coil_descriptions`).
+
+- :samp:`{<nx>} {<ny>} {<nz>}`: Components of a unit vector indicating the
+  field component to be selected. Note that listing a separate unit vector for
+  each integration points allows the implementation of curved coils and coils
+  with the gradiometer loops tilted with respect to each other.
+
+
+Computing the forward solution
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Purpose
+-------
+
+Examples on how to compute the forward solution in MNE-Python using
+:func:`mne.make_forward_solution` can be found
+:ref:`plot_forward_compute_forward_solution` and
+:ref:`computing_the_forward_solution`.
+
+Implementation of software gradient compensation
+------------------------------------------------
+
+Accounting for noise cancellation in MNE-Python is accomplished in
+:meth:`mne.io.Raw.apply_gradient_compensation`. See
+:ref:`plot_brainstorm_phantom_ctf` for an example.
+
+CTF and 4D Neuroimaging data may have been subjected to noise cancellation
+employing the data from the reference sensor array. Even though these sensor
+are rather far away from the brain sources, :func:`mne.make_forward_solution`
+takes them into account in the computations. If the data file has software
+gradient compensation activated, it computes the field of at the reference
+sensors in addition to the main MEG sensor array and computes a compensated
+forward solution.
+
+The EEG sphere model definition file
+------------------------------------
+
+In MNE-Python, different sphere models can be specified through
+:func:`mne.make_sphere_model`. The default model has the following structure:
+
+.. tabularcolumns:: |p{0.1\linewidth}|p{0.25\linewidth}|p{0.2\linewidth}|
+.. table:: Structure of the default EEG model
+
+    ========  =======================  =======================
+    Layer     Relative outer radius    :math:`\sigma` (S/m)
+    ========  =======================  =======================
+    Head      1.0                      0.33
+    Skull     0.97                     0.04
+    CSF       0.92                     1.0
+    Brain     0.90                     0.33
+    ========  =======================  =======================
+
+Although it is not BEM model per se the ``sphere`` structure describes the head
+geometry so it can be passed as ``bem`` parameter in MNE-Python functions such
+as :func:`mne.fit_dipole`, :func:`mne.viz.plot_alignment` or
+:func:`mne.make_forward_solution`.
+
+.. _eeg_sphere_model:
+
+EEG forward solution in the sphere model
+----------------------------------------
+
+.. note:: Sphere-model examples in MNE-Python
+    :class: sidebar
+
+    For examples of using the sphere model when computing the forward model
+    (using :func:`mne.make_forward_solution`), see :ref:`Brainstorm CTF phantom
+    dataset tutorial <plt_brainstorm_phantom_ctf_eeg_sphere_geometry>`,
+    :ref:`Brainstorm Elekta phantom dataset tutorial
+    <plt_brainstorm_phantom_elekta_eeg_sphere_geometry>`, and
+    :ref:`tut-source-alignment-without-mri`.
+
+When the sphere model is employed, the computation of the EEG solution can be
+substantially accelerated by using approximation methods described by Mosher
+:footcite:`MosherEtAl1999`, Zhang :footcite:`Zhang1995`, and Berg
+:footcite:`BergScherg1994`.
+:func:`mne.make_forward_solution` approximates the solution with three dipoles
+in a homogeneous sphere whose locations and amplitudes are determined by
+minimizing the cost function:
+
+.. math::
+   S(r_1,\dotsc,r_m\ ,\ \mu_1,\dotsc,\mu_m) = \int_{scalp} {(V_{true} - V_{approx})}\,dS
+
+where :math:`r_1,\dotsc,r_m` and :math:`\mu_1,\dotsc,\mu_m` are the locations
+and amplitudes of the approximating dipoles and :math:`V_{true}` and
+:math:`V_{approx}` are the potential distributions given by the true and
+approximative formulas, respectively. It can be shown that this integral can be
+expressed in closed form using an expansion of the potentials in spherical
+harmonics. The formula is evaluated for the most superficial dipoles, *i.e.*,
+those lying just inside the inner skull surface.
+
+Averaging forward solutions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+One possibility to make a grand average over several runs of a experiment is to
+average the data across runs and average the forward solutions accordingly. For
+this purpose, :func:`mne.average_forward_solutions` computes a weighted average
+of several forward solutions. The function averages both MEG and EEG forward
+solutions. Usually the EEG forward solution is identical across runs because
+the electrode locations do not change.
+
+.. target for :end-before: forward-end-content

mne-python/source/doc/_includes/ged.rst

@@ -0,0 +1,107 @@
+:orphan:
+
+Generalized eigendecomposition in decoding
+==========================================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`ged` to link to that section of the implementation.rst page.
+   The next line is a target for :start-after: so we can omit the title from
+   the include:
+   ged-begin-content
+
+This section describes the mathematical formulation and application of
+Generalized Eigendecomposition (GED), often used in spatial filtering
+and source separation algorithms, such as :class:`mne.decoding.CSP`, 
+:class:`mne.decoding.SPoC`, :class:`mne.decoding.SSD` and 
+:class:`mne.decoding.XdawnTransformer`.
+
+The core principle of GED is to find a set of channel weights (spatial filter) 
+that maximizes the ratio of signal power between two data features. 
+These features are defined by the researcher and are represented by two covariance matrices: 
+a "signal" matrix :math:`S` and a "reference" matrix :math:`R`. 
+For example, :math:`S` could be the covariance of data from a task time interval, 
+and :math:`S` could be the covariance from a baseline time interval. For more details see :footcite:`Cohen2022`.
+
+Algebraic formulation of GED
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A few definitions first: 
+Let :math:`n \in \mathbb{N}^+` be a number of channels.
+Let :math:`\text{Symm}_n(\mathbb{R}) \subset M_n(\mathbb{R})` be a vector space of real symmetric matrices.
+Let :math:`S^n_+, S^n_{++} \subset \text{Symm}_n(\mathbb{R})` be sets of real positive semidefinite and positive definite matrices, respectively.
+Let :math:`S, R \in S^n_+` be covariance matrices estimated from electrophysiological data :math:`X_S \in M_{n \times t_S}(\mathbb{R})` and :math:`X_R \in M_{n \times t_R}(\mathbb{R})`.
+
+GED (or simultaneous diagonalization by congruence) of :math:`S` and :math:`R` 
+is possible when :math:`R` is full rank (and thus :math:`R \in S^n_{++}`):
+
+.. math::
+
+   SW = RWD,
+
+where :math:`W \in M_n(\mathbb{R})` is an invertible matrix of eigenvectors 
+of :math:`(S, R)` and :math:`D` is a diagonal matrix of eigenvalues :math:`\lambda_i`.
+
+Each eigenvector :math:`\mathbf{w} \in W` is a spatial filter that solves 
+an optimization problem of the form:
+
+.. math::
+
+   \operatorname{argmax}_{\mathbf{w}} \frac{\mathbf{w}^t S \mathbf{w}}{\mathbf{w}^t R \mathbf{w}}
+
+That is, using spatial filters :math:`W` on time-series :math:`X \in M_{n \times t}(\mathbb{R})`:
+
+.. math::
+
+   \mathbf{A} = W^t X,
+
+results in "activation" time-series :math:`A` of the estimated "sources", 
+such that the ratio of their variances, 
+:math:`\frac{\text{Var}(\mathbf{w}^T X_S)}{\text{Var}(\mathbf{w}^T X_R)} = \frac{\mathbf{w}^T S \mathbf{w}}{\mathbf{w}^T R \mathbf{w}}`, 
+is sequentially maximized spatial filters :math:`\mathbf{w}_i`, sorted according to :math:`\lambda_i`.
+
+GED in the principal subspace
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Unfortunately, :math:`R` might not be full rank depending on the data :math:`X_R` (for example due to average reference, removed PCA/ICA components, etc.). 
+In such cases, GED can be performed on :math:`S` and :math:`R` in the principal subspace :math:`Q = \operatorname{Im}(C_{ref}) \subset \mathbb{R}^n` of some reference 
+covariance :math:`C_{ref}` (in Common Spatial Pattern (CSP) algorithm, for example, :math:`C_{ref}=\frac{1}{2}(S+R)` and GED is performed on S and R'=S+R). 
+
+More formally: 
+Let :math:`r \leq n` be a rank of :math:`C \in S^n_+`. 
+Let :math:`Q=\operatorname{Im}(C_{ref})` be a principal subspace of :math:`C_{ref}`. 
+Let :math:`P \in M_{n \times r}(\mathbb{R})` be an isometry formed by orthonormal basis of :math:`Q`.
+Let :math:`f:S^n_+ \to S^r_+`, :math:`A \mapsto P^t A P` be a "restricting" map, that restricts quadratic form 
+:math:`q_A:\mathbb{R}^n \to \mathbb{R}` to :math:`q_{A|_Q}:\mathbb{R}^n \to \mathbb{R}` (in practical terms, :math:`q_A` maps 
+spatial filters to variance of the spatially filtered data :math:`X_A`).
+
+Then, the GED of :math:`S` and :math:`R` in the principal subspace :math:`Q` of :math:`C_{ref}` is performed as follows:
+
+1. :math:`S` and :math:`R` are transformed to :math:`S_Q = f(S) = P^t S P` and :math:`R_Q = f(R) = P^t R P`, 
+   such that :math:`S_Q` and :math:`R_Q` are matrix representations of restricted :math:`q_{S|_Q}` and :math:`q_{R|_Q}`.
+2. GED is performed on :math:`S_Q` and :math:`R_Q`: :math:`S_Q W_Q = R_Q W_Q D`.
+3. Eigenvectors :math:`W_Q` of :math:`(S_Q, R_Q)` are transformed back to :math:`\mathbb{R}^n` 
+   by :math:`W = P W_Q \in \mathbb{R}^{n \times r}` to obtain :math:`r` spatial filters.
+
+Note that the solution to the original optimization problem is preserved:
+
+.. math::
+
+   \frac{\mathbf{w_Q}^t S_Q \mathbf{w_Q}}{\mathbf{w_Q}^t R_Q \mathbf{w_Q}}= \frac{\mathbf{w_Q}^t (P^t S P) \mathbf{w_Q}}{\mathbf{w_Q}^t (P^t R P) 
+   \mathbf{w_Q}} = \frac{\mathbf{w}^t S \mathbf{w}}{\mathbf{w}^t R \mathbf{w}} = \lambda
+
+
+In addition to restriction, :math:`q_S` and :math:`q_R` can be rescaled based on the whitened :math:`C_{ref}`. 
+In this case the whitening map :math:`f_{wh}:S^n_+ \to S^r_+`, 
+:math:`A \mapsto P_{wh}^t A P_{wh}` transforms :math:`A` into matrix representation of :math:`q_{A|Q}` rescaled according to :math:`\Lambda^{-1/2}`, 
+where :math:`\Lambda` is a diagonal matrix of eigenvalues of :math:`C_{ref}` and so :math:`P_{wh} = P \Lambda^{-1/2}`.
+
+In MNE-Python, the matrix :math:`P` of the restricting map can be obtained using
+::
+
+    _, ref_evecs, mask = mne.cov._smart_eigh(C_ref, ..., proj_subspace=True, ...)
+    restr_mat = ref_evecs[mask]
+
+while :math:`P_{wh}` using:
+::
+
+    restr_mat = compute_whitener(C_ref, ..., pca=True, ...)

mne-python/source/doc/_includes/institutional-partners.rst

@@ -0,0 +1,44 @@
+:orphan:
+
+Institutional partners
+----------------------
+
+.. NOTE: this file is included in doc/funding.rst and doc/overview/people.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`supporting-institutions` to link to that section of the funding.rst
+   page. The next line is a target for :start-after: so we can omit the title
+   from the include:
+   institutional-partners-begin-content
+
+Current partners
+~~~~~~~~~~~~~~~~
+
+- `Aalto-yliopiston perustieteiden korkeakoulu <https://sci.aalto.fi/>`_
+- `Donders Institute for Brain, Cognition and Behaviour at Radboud University <https://www.ru.nl/donders/>`_
+- `Karl-Franzens-Universität Graz <https://www.uni-graz.at/>`_
+- `University of Washington <https://www.washington.edu/>`_
+
+Former partners
+~~~~~~~~~~~~~~~
+
+- `Aarhus Universitet <https://www.au.dk/>`_
+- `AE Studio <https://ae.studio/>`_
+- `Athinoula A. Martinos Center for Biomedical Imaging <https://martinos.org/>`_
+- `Berkeley Institute for Data Science <https://bids.berkeley.edu/>`_
+- `Boston University <https://www.bu.edu/>`_
+- `Children’s Hospital of Philadelphia Research Institute <https://www.research.chop.edu/imaging/>`_
+- `Commissariat à l’énergie atomique et aux énergies alternatives <https://www.cea.fr/>`_
+- `Fondation Campus Biotech Geneva <https://fcbg.ch/>`_
+- `Forschungszentrum Jülich <https://www.fz-juelich.de/>`_
+- `Harvard Medical School <https://hms.harvard.edu/>`_
+- `Institut du Cerveau et de la Moelle épinière <https://icm-institute.org/>`_
+- `Institut national de la santé et de la recherche médicale <https://www.inserm.fr/>`_
+- `Institut national de recherche en informatique et en automatique <https://www.inria.fr/>`_
+- `Massachusetts General Hospital <https://www.massgeneral.org/>`_
+- `Massachusetts Institute of Technology <https://web.mit.edu/>`_
+- `Max-Planck-Institut für Bildungsforschung <https://www.mpib-berlin.mpg.de/>`_
+- `Macquarie University <https://www.mq.edu.au/>`_
+- `New York University <https://www.nyu.edu/>`_
+- `SWPS Uniwersytet Humanistycznospołeczny <https://www.swps.pl/>`_
+- `Technische Universität Ilmenau <https://www.tu-ilmenau.de/>`_
+- `Télécom ParisTech <https://www.telecom-paris.fr/>`_

mne-python/source/doc/_includes/inverse.rst

@@ -0,0 +1,607 @@
+.. _ch_mne:
+
+The minimum-norm current estimates
+==================================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`ch_mne` to link to that section of the implementation.rst page.
+   The next line is a target for :start-after: so we can omit the title from
+   the include:
+   inverse-begin-content
+
+
+This section describes the mathematical details of the calculation of
+minimum-norm estimates. In Bayesian sense, the ensuing current distribution is
+the maximum a posteriori (MAP) estimate under the following assumptions:
+
+- The viable locations of the currents are constrained to the cortex.
+  Optionally, the current orientations can be fixed to be normal to the
+  cortical mantle.
+
+- The amplitudes of the currents have a Gaussian prior distribution with a
+  known source covariance matrix.
+
+- The measured data contain additive noise with a Gaussian distribution with a
+  known covariance matrix. The noise is not correlated over time.
+
+Computing the inverse operator is accomplished using
+:func:`mne.minimum_norm.make_inverse_operator` and
+:func:`mne.minimum_norm.apply_inverse`. The use of these functions is presented
+in the tutorial :ref:`tut-inverse-methods`.
+
+The linear inverse operator
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The measured data in the source estimation procedure consists of MEG and EEG
+data, recorded on a total of N channels. The task is to estimate a total of
+:math:`Q`
+strengths of sources located on the cortical mantle. If the number of source
+locations is :math:`P`, :math:`Q = P` for fixed-orientation sources and
+:math:`Q = 3P` if the source
+orientations are unconstrained. The regularized linear inverse operator
+following from regularized maximal likelihood of the above probabilistic model
+is given by the :math:`Q \times N` matrix
+
+.. math::    M = R' G^\top (G R' G^\top + C)^{-1}\ ,
+
+where :math:`G` is the gain matrix relating the source strengths to the measured
+MEG/EEG data, :math:`C` is the data noise-covariance matrix and :math:`R'` is
+the source covariance matrix. The dimensions of these matrices are :math:`N
+\times Q`, :math:`N \times N`, and :math:`Q \times Q`, respectively. The
+:math:`Q \times 1` source-strength vector is obtained by multiplying the
+:math:`Q \times 1` data vector by :math:`Q`.
+
+The expected value of the current amplitudes at time *t* is then given by
+:math:`\hat{j}(t) = Mx(t)`, where :math:`x(t)` is a vector containing the
+measured MEG and EEG data values at time *t*.
+
+For computational convenience, the linear inverse operator is
+not computed explicitly. See :ref:`mne_solution` for mathematical
+details, and :ref:`CIHCFJEI` for a detailed example.
+
+.. _mne_regularization:
+
+Regularization
+~~~~~~~~~~~~~~
+
+The a priori variance of the currents is, in practice, unknown. We can express
+this by writing :math:`R' = R/ \lambda^2 = R \lambda^{-2}`, which yields the
+inverse operator
+
+.. math::
+   :name: inv_m
+
+    M &= R' G^\top (G R' G^\top + C)^{-1} \\
+      &= R \lambda^{-2} G^\top (G R \lambda^{-2} G^\top + C)^{-1} \\
+      &= R \lambda^{-2} G^\top \lambda^2 (G R G^\top + \lambda^2 C)^{-1} \\
+      &= R G^\top (G R G^\top + \lambda^2 C)^{-1}\ ,
+
+where the unknown current amplitude is now interpreted in terms of the
+regularization parameter :math:`\lambda^2`. Larger :math:`\lambda^2` values
+correspond to spatially smoother and weaker current amplitudes, whereas smaller
+:math:`\lambda^2` values lead to the opposite.
+
+We can arrive at the regularized linear inverse operator also by minimizing a
+cost function :math:`S` with respect to the estimated current :math:`\hat{j}`
+(given the measurement vector :math:`x` at any given time :math:`t`) as
+
+.. math::
+
+    \min_\hat{j} \Bigl\{ S \Bigr\} &= \min_\hat{j} \Bigl\{ \tilde{e}^\top \tilde{e} + \lambda^2 \hat{j}^\top R^{-1} \hat{j} \Bigr\} \\
+                                   &= \min_\hat{j} \Bigl\{ (x - G\hat{j})^\top C^{-1} (x - G\hat{j}) + \lambda^2 \hat{j}^\top R^{-1} \hat{j} \Bigr\} \,
+
+where the first term consists of the difference between the whitened measured
+data (see :ref:`whitening_and_scaling`) and those predicted by the model while the
+second term is a weighted-norm of the current estimate. It is seen that, with
+increasing :math:`\lambda^2`, the source term receive more weight and larger
+discrepancy between the measured and predicted data is tolerable.
+
+.. _whitening_and_scaling:
+
+Whitening and scaling
+~~~~~~~~~~~~~~~~~~~~~
+
+The MNE software employs data whitening so that a 'whitened' inverse operator
+assumes the form
+
+.. math::    \tilde{M} = M C^{^1/_2} = R \tilde{G}^\top (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1}\ ,
+   :name: inv_m_tilde
+
+where
+
+.. math:: \tilde{G} = C^{-^1/_2}G
+   :name: inv_g_tilde
+
+is the spatially whitened gain matrix. We arrive at the whitened inverse
+operator equation :eq:`inv_m_tilde` by making the substitution for
+:math:`G` from :eq:`inv_g_tilde` in :eq:`inv_m` as
+
+.. math::
+
+    \tilde{M} = M C^{^1/_2} &= R G^\top (G R G^\top + \lambda^2 C)^{-1} C^{^1/_2} \\
+                             &= R \tilde{G}^\top C^{^1/_2} (C^{^1/_2} \tilde{G} R \tilde{G}^\top C^{^1/_2} + \lambda^2 C)^{-1} C^{^1/_2} \\
+                             &= R \tilde{G}^\top C^{^1/_2} (C^{^1/_2} (\tilde{G} R \tilde{G}^\top + \lambda^2 I) C^{^1/_2})^{-1} C^{^1/_2} \\
+                             &= R \tilde{G}^\top C^{^1/_2} C^{-^1/_2} (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1} C^{-^1/_2} C^{^1/_2} \\
+                             &= R \tilde{G}^\top (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1}\ .
+
+The expected current values are
+
+.. math::
+   :name: inv_j_hat_t
+
+    \hat{j}(t) &= Mx(t) \\
+               &= M C^{^1/_2} C^{-^1/_2} x(t) \\
+               &= \tilde{M} \tilde{x}(t)
+
+knowing :eq:`inv_m_tilde` and taking
+
+.. math::
+   :name: inv_tilde_x_t
+
+    \tilde{x}(t) = C^{-^1/_2}x(t)
+
+as the whitened measurement vector at time *t*. The spatial
+whitening operator :math:`C^{-^1/_2}` is obtained with the help of the
+eigenvalue decomposition
+:math:`C = U_C \Lambda_C^2 U_C^\top` as :math:`C^{-^1/_2} = \Lambda_C^{-1} U_C^\top`.
+In the MNE software the noise-covariance matrix is stored as the one applying
+to raw data. To reflect the decrease of noise due to averaging, this matrix,
+:math:`C_0`, is scaled by the number of averages, :math:`L`, *i.e.*, :math:`C =
+C_0 / L`.
+
+.. note::
+   When EEG data are included, the gain matrix :math:`G` needs to be average referenced when computing the linear inverse operator :math:`M`. This is incorporated during creating the spatial whitening operator :math:`C^{-^1/_2}`, which includes any projectors on the data. EEG data average reference (using a projector) is mandatory for source modeling and is checked when calculating the inverse operator.
+
+As shown above, regularization of the inverse solution is equivalent to a
+change in the variance of the current amplitudes in the Bayesian *a priori*
+distribution.
+
+A convenient choice for the source-covariance matrix :math:`R` is such that
+:math:`\text{trace}(\tilde{G} R \tilde{G}^\top) / \text{trace}(I) = 1`. With this
+choice we can approximate :math:`\lambda^2 \sim 1/\rm{SNR}^2`, where SNR is the
+(amplitude) signal-to-noise ratio of the whitened data.
+
+.. note::
+   The definition of the signal to noise-ratio/ :math:`\lambda^2` relationship
+   given above works nicely for the whitened forward solution. In the
+   un-whitened case scaling with the trace ratio :math:`\text{trace}(GRG^\top) /
+   \text{trace}(C)` does not make sense, since the diagonal elements summed
+   have, in general, different units of measure. For example, the MEG data are
+   expressed in T or T/m whereas the unit of EEG is Volts.
+
+See :ref:`tut-compute-covariance` for example of noise covariance computation
+and whitening.
+
+.. _cov_regularization_math:
+
+Regularization of the noise-covariance matrix
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since finite amount of data is usually available to compute an estimate of the
+noise-covariance matrix :math:`C`, the smallest eigenvalues of its estimate are
+usually inaccurate and smaller than the true eigenvalues. Depending on the
+seriousness of this problem, the following quantities can be affected:
+
+- The model data predicted by the current estimate,
+
+- Estimates of signal-to-noise ratios, which lead to estimates of the required
+  regularization, see :ref:`mne_regularization`,
+
+- The estimated current values, and
+
+- The noise-normalized estimates, see :ref:`noise_normalization`.
+
+Fortunately, the latter two are least likely to be affected due to
+regularization of the estimates. However, in some cases especially the EEG part
+of the noise-covariance matrix estimate can be deficient, *i.e.*, it may
+possess very small eigenvalues and thus regularization of the noise-covariance
+matrix is advisable.
+
+Historically, the MNE software accomplishes the regularization by replacing a
+noise-covariance matrix estimate :math:`C` with
+
+.. math::    C' = C + \sum_k {\varepsilon_k \bar{\sigma_k}^2 I^{(k)}}\ ,
+
+where the index :math:`k` goes across the different channel groups (MEG planar
+gradiometers, MEG axial gradiometers and magnetometers, and EEG),
+:math:`\varepsilon_k` are the corresponding regularization factors,
+:math:`\bar{\sigma_k}` are the average variances across the channel groups, and
+:math:`I^{(k)}` are diagonal matrices containing ones at the positions
+corresponding to the channels contained in each channel group.
+
+See :ref:`plot_compute_covariance_howto` for details on computing and
+regularizing the channel covariance matrix.
+
+.. _mne_solution:
+
+Computation of the solution
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The most straightforward approach to calculate the MNE is to employ the
+expression of the original or whitened inverse operator directly. However, for
+computational convenience we prefer to take another route, which employs the
+singular-value decomposition (SVD) of the matrix
+
+.. math::
+   :name: inv_a
+
+    A &= \tilde{G} R^{^1/_2} \\
+      &= U \Lambda V^\top
+
+where the superscript :math:`^1/_2` indicates a square root of :math:`R`. For a
+diagonal matrix, one simply takes the square root of :math:`R` while in the
+more general case one can use the Cholesky factorization :math:`R = R_C R_C^\top`
+and thus :math:`R^{^1/_2} = R_C`.
+
+Combining the SVD from :eq:`inv_a` with the inverse equation :eq:`inv_m` it is
+easy to show that
+
+.. math::
+   :name: inv_m_tilde_svd
+
+    \tilde{M} &= R \tilde{G}^\top (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1} \\
+              &= R^{^1/_2} A^\top (A A^\top + \lambda^2 I)^{-1} \\
+              &= R^{^1/_2} V \Lambda U^\top (U \Lambda V^\top V \Lambda U^\top + \lambda^2 I)^{-1} \\
+              &= R^{^1/_2} V \Lambda U^\top (U (\Lambda^2 + \lambda^2 I) U^\top)^{-1} \\
+              &= R^{^1/_2} V \Lambda U^\top U (\Lambda^2 + \lambda^2 I)^{-1} U^\top \\
+              &= R^{^1/_2} V \Lambda (\Lambda^2 + \lambda^2 I)^{-1} U^\top \\
+              &= R^{^1/_2} V \Gamma U^\top
+
+where the elements of the diagonal matrix :math:`\Gamma` are simply
+
+.. `reginv` in our code:
+
+.. math::
+   :name: inv_gamma_k
+
+    \gamma_k = \frac{\lambda_k}{\lambda_k^2 + \lambda^2}\ .
+
+From our expected current equation :eq:`inv_j_hat_t` and our whitened
+measurement equation :eq:`inv_tilde_x_t`, if we take
+
+.. math::
+   :name: inv_w_t
+
+    w(t) &= U^\top \tilde{x}(t) \\
+         &= U^\top C^{-^1/_2} x(t)\ ,
+
+we can see that the expression for the expected current is just
+
+.. math::
+   :name: inv_j_hat_t_svd
+
+    \hat{j}(t) &= R^{^1/_2} V \Gamma w(t) \\
+               &= \sum_k {\bar{v_k} \gamma_k w_k(t)}\ ,
+
+where :math:`\bar{v_k} = R^{^1/_2} v_k`, with :math:`v_k` being the
+:math:`k` th column of :math:`V`. It is thus seen that the current estimate is
+a weighted sum of the "weighted" eigenleads :math:`v_k`.
+
+It is easy to see that :math:`w(t) \propto \sqrt{L}`. To maintain the relation
+:math:`(\tilde{G} R \tilde{G}^\top) / \text{trace}(I) = 1` when :math:`L` changes
+we must have :math:`R \propto 1/L`. With this approach, :math:`\lambda_k` is
+independent of  :math:`L` and, for fixed :math:`\lambda`, we see directly that
+:math:`j(t)` is independent of :math:`L`.
+
+The minimum-norm estimate is computed using this procedure in
+:func:`mne.minimum_norm.make_inverse_operator`, and its usage is illustrated
+in :ref:`CIHCFJEI`.
+
+
+.. _noise_normalization:
+
+Noise normalization
+~~~~~~~~~~~~~~~~~~~
+
+Noise normalization serves three purposes:
+
+- It converts the expected current value into a dimensionless statistical test
+  variable. Thus the resulting time and location dependent values are often
+  referred to as dynamic statistical parameter maps (dSPM).
+
+- It reduces the location bias of the estimates. In particular, the tendency of
+  the MNE to prefer superficial currents is eliminated.
+
+- The width of the point-spread function becomes less dependent on the source
+  location on the cortical mantle. The point-spread is defined as the MNE
+  resulting from the signals coming from a point current source (a current
+  dipole) located at a certain point on the cortex.
+
+In practice, noise normalization is implemented as a division by the square
+root of the estimated variance of each voxel. In computing these noise
+normalization factors, it's convenient to reuse our "weighted eigenleads"
+definition from equation :eq:`inv_j_hat_t` in matrix form as
+
+.. math::
+   :name: inv_eigenleads_weighted
+
+    \bar{V} = R^{^1/_2} V\ .
+
+dSPM
+----
+
+Noise-normalized linear estimates introduced by Dale et al.
+:footcite:`DaleEtAl1999` require division of the expected current amplitude by
+its variance. In practice, this requires the computation of the diagonal
+elements of the following matrix, using SVD equation :eq:`inv_m_tilde` and
+:eq:`inv_eigenleads_weighted`:
+
+.. math::
+
+    M C M^\top &= M C^{^1/_2} C^{^1/_2} M^\top \\
+            &= \tilde{M} \tilde{M}^\top \\
+            &= R^{^1/_2} V \Gamma U^\top U \Gamma V^\top R^{^1/_2} \\
+            &= \bar{V} \Gamma^2 \bar{V}^\top\ .
+
+Because we only care about the diagonal entries here, we can find the
+variances for each source as
+
+.. math::
+
+    \sigma_k^2 = \gamma_k^2
+
+Under the conditions expressed at the end of :ref:`mne_solution`, it
+follows that the *t*-statistic values associated with fixed-orientation
+sources) are thus proportional to :math:`\sqrt{L}` while the *F*-statistic
+employed with free-orientation sources is proportional to :math:`L`,
+correspondingly.
+
+.. note::
+   The MNE software usually computes the *square roots* of the F-statistic to
+   be displayed on the inflated cortical surfaces. These are also proportional
+   to :math:`\sqrt{L}`.
+
+sLORETA
+-------
+sLORETA :footcite:`Pascual-Marqui2002` estimates the current variances as the
+diagonal entries of the
+resolution matrix, which is the product of the inverse and forward operators.
+In other words, the diagonal entries of (using :eq:`inv_m_tilde_svd`,
+:eq:`inv_g_tilde`, and :eq:`inv_a`)
+
+.. math::
+
+    M G &= M C^{^1/_2} C^{-^1/_2} G \\
+        &= \tilde{M} \tilde{G} \\
+        &= R^{^1/_2} V \Gamma U^\top \tilde{G} R^{^1/_2} R^{-^1/_2} \\
+        &= R^{^1/_2} V \Gamma U^\top U \Lambda V^\top R^{-^1/_2} \\
+        &= R^{^1/_2} V \Gamma U^\top U \Lambda V^\top R^{^1/_2} R^{-1} \\
+        &= \bar{V} \Gamma U^\top U \Lambda \bar{V}^\top R^{-1} \\
+        &= \bar{V} \Gamma \Lambda \bar{V}^\top R^{-1}\ .
+
+Because :math:`R` is diagonal and we only care about the diagonal entries,
+we can find our variance estimates as
+
+.. math::
+
+    \sigma_k^2 &= \gamma_k \lambda_k R_{k,k}^{-1} \\
+               &= \left(\frac{\lambda_k}{(\lambda_k^2 + \lambda^2)}\right) \left(\frac{\lambda_k}{1}\right) \left(\frac{1}{\lambda^2}\right) \\
+               &= \frac{\lambda_k^2}{(\lambda_k^2 + \lambda^2) \lambda^2} \\
+               &= \left(\frac{\lambda_k^2}{(\lambda_k^2 + \lambda^2)^2}\right) \left(\frac{\lambda^2 + \lambda_k^2}{\lambda^2}\right) \\
+               &= \left(\frac{\lambda_k}{\lambda_k^2 + \lambda^2}\right)^2 \left(1 + \frac{\lambda_k^2}{\lambda^2}\right) \\
+               &= \gamma_k^2 \left(1 + \frac{\lambda_k^2}{\lambda^2}\right)\ .
+
+eLORETA
+~~~~~~~
+While dSPM and sLORETA solve for noise normalization weights
+:math:`\sigma^2_k` that are applied to standard minimum-norm estimates
+:math:`\hat{j}(t)`, eLORETA :footcite:`Pascual-Marqui2011` instead solves for
+a source covariance
+matrix :math:`R` that achieves zero localization bias. For fixed-orientation
+solutions the resulting matrix :math:`R` will be a diagonal matrix, and for
+free-orientation solutions it will be a block-diagonal matrix with
+:math:`3 \times 3` blocks.
+
+.. In https://royalsocietypublishing.org/doi/full/10.1098/rsta.2011.0081
+.. eq. 2.10 (classical min norm), their values map onto our values as:
+..
+.. - α=λ²
+.. - W=R⁻¹ (pos semidef weight matrix)
+.. - K=G
+.. - ϕ=x
+.. - C=H
+..
+
+In :footcite:`Pascual-Marqui2011` eq. 2.13 states that the following system
+of equations can be used to find the weights, :math:`\forall i \in {1, ..., P}`
+(note that here we represent the equations from that paper using our notation):
+
+.. math:: r_i = \left[ G_i^\top \left( GRG^\top + \lambda^2C \right)^{-1} G_i \right] ^{-^1/_2}
+
+And an iterative algorithm can be used to find the values for the weights
+:math:`r_i` that satisfy these equations as:
+
+1. Initialize identity weights.
+2. Compute :math:`N= \left( GRG^\top + \lambda^2C \right)^{-1}`.
+3. Holding :math:`N` fixed, compute new weights :math:`r_i = \left[ G_i^\top N G_i \right]^{-^1/_2}`.
+4. Using new weights, go to step (2) until convergence.
+
+In particular, for step (2) we can use our substitution from :eq:`inv_g_tilde`
+as:
+
+.. math::
+
+    N &= (G R G^\top + \lambda^2 C)^{-1} \\
+      &= (C^{^1/_2} \tilde{G} R \tilde{G}^\top C^{^1/_2} + \lambda^2 C)^{-1} \\
+      &= (C^{^1/_2} (\tilde{G} R \tilde{G}^\top + \lambda^2 I) C^{^1/_2})^{-1} \\
+      &= C^{-^1/_2} (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1} C^{-^1/_2} \\
+      &= C^{-^1/_2} (\tilde{G} R \tilde{G}^\top + \lambda^2 I)^{-1} C^{-^1/_2}\ .
+
+Then defining :math:`\tilde{N}` as the whitened version of :math:`N`, i.e.,
+the regularized pseudoinverse of :math:`\tilde{G}R\tilde{G}^\top`, we can
+compute :math:`N` as:
+
+.. math::
+
+    N &= C^{-^1/_2} (U_{\tilde{G}R\tilde{G}^\top} \Lambda_{\tilde{G}R\tilde{G}^\top} V_{\tilde{G}R\tilde{G}^\top}^\top + \lambda^2 I)^{-1} C^{-^1/_2} \\
+      &= C^{-^1/_2} (U_{\tilde{G}R\tilde{G}^\top} (\Lambda_{\tilde{G}R\tilde{G}^\top} + \lambda^2 I) V_{\tilde{G}R\tilde{G}^\top}^\top)^{-1} C^{-^1/_2} \\
+      &= C^{-^1/_2} V_{\tilde{G}R\tilde{G}^\top} (\Lambda_{\tilde{G}R\tilde{G}^\top} + \lambda^2 I)^{-1} U_{\tilde{G}R\tilde{G}^\top}^\top C^{-^1/_2} \\
+      &= C^{-^1/_2} \tilde{N} C^{-^1/_2}\ .
+
+In step (3) we left and right multiply with subsets of :math:`G`, but making
+the substitution :eq:`inv_g_tilde` we see that we equivalently compute:
+
+.. math::
+
+    r_i &= \left[ G_i^\top N G_i \right]^{-^1/_2} \\
+        &= \left[ (C^{^1/_2} \tilde{G}_i)^\top N C^{^1/_2} \tilde{G}_i \right]^{-^1/_2} \\
+        &= \left[ \tilde{G}_i^\top C^{^1/_2} N C^{^1/_2} \tilde{G}_i \right]^{-^1/_2} \\
+        &= \left[ \tilde{G}_i^\top C^{^1/_2} C^{-^1/_2} \tilde{N} C^{-^1/_2} C^{^1/_2} \tilde{G}_i \right]^{-^1/_2} \\
+        &= \left[ \tilde{G}_i^\top \tilde{N} \tilde{G}_i \right]^{-^1/_2}\ .
+
+For convenience, we thus never need to compute :math:`N` itself but can instead
+compute the whitened version :math:`\tilde{N}`.
+
+Predicted data
+~~~~~~~~~~~~~~
+
+Under noiseless conditions the SNR is infinite and thus leads to
+:math:`\lambda^2 = 0` and the minimum-norm estimate explains the measured data
+perfectly. Under realistic conditions, however, :math:`\lambda^2 > 0` and there
+is a misfit between measured data and those predicted by the MNE. Comparison of
+the predicted data, here denoted by :math:`x(t)`, and measured one can give
+valuable insight on the correctness of the regularization applied.
+
+In the SVD approach we easily find
+
+.. math::    \hat{x}(t) = G \hat{j}(t) = C^{^1/_2} U \Pi w(t)\ ,
+
+where the diagonal matrix :math:`\Pi` has elements :math:`\pi_k = \lambda_k
+\gamma_k` The predicted data is thus expressed as the weighted sum of the
+'recolored eigenfields' in :math:`C^{^1/_2} U`.
+
+Cortical patch statistics
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the ``add_dists=True`` option was used in source space creation,
+the source space file will contain
+Cortical Patch Statistics (CPS) for each vertex of the cortical surface. The
+CPS provide information about the source space point closest to it as well as
+the distance from the vertex to this source space point. The vertices for which
+a given source space point is the nearest one define the cortical patch
+associated with with the source space point. Once these data are available, it
+is straightforward to compute the following cortical patch statistics for each
+source location :math:`d`:
+
+- The average over the normals of at the vertices in a patch,
+  :math:`\bar{n_d}`,
+
+- The areas of the patches, :math:`A_d`, and
+
+- The average deviation of the vertex normals in a patch from their average,
+  :math:`\sigma_d`, given in degrees.
+
+``use_cps`` parameter in :func:`mne.convert_forward_solution`, and
+:func:`mne.minimum_norm.make_inverse_operator` controls whether to use
+cortical patch statistics (CPS) to define normal orientations or not (see
+:ref:`CHDBBCEJ`).
+
+.. _inverse_orientation_constraints:
+
+Orientation constraints
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The principal sources of MEG and EEG signals are generally believed to be
+postsynaptic currents in the cortical pyramidal neurons. Since the net primary
+current associated with these microscopic events is oriented normal to the
+cortical mantle, it is reasonable to use the cortical normal orientation as a
+constraint in source estimation. In addition to allowing completely free source
+orientations, the MNE software implements three orientation constraints based
+of the surface normal data:
+
+- Source orientation can be rigidly fixed to the surface normal direction by
+  specifying ``fixed=True`` in :func:`mne.minimum_norm.make_inverse_operator`.
+  If cortical patch statistics are available the average
+  normal over each patch, :math:`\bar{n_d}`, are used to define the source
+  orientation. Otherwise, the vertex normal at the source space location is
+  employed.
+
+- A *location independent or fixed loose orientation constraint* (fLOC) can be
+  employed by specifying ``fixed=False`` and ``loose=1.0`` when
+  calling :func:`mne.minimum_norm.make_inverse_operator` (see
+  :ref:`plot_dipole_orientations_fLOC_orientations`).
+  In this approach, a source coordinate
+  system based on the local surface orientation at the source location is
+  employed. By default, the three columns of the gain matrix G, associated with
+  a given source location, are the fields of unit dipoles pointing to the
+  directions of the :math:`x`, :math:`y`, and :math:`z` axis of the coordinate
+  system employed in the forward calculation (usually the :ref:`MEG head
+  coordinate frame <head_device_coords>`). For LOC the orientation is changed so
+  that the first two source components lie in the plane normal to the surface
+  normal at the source location and the third component is aligned with it.
+  Thereafter, the variance of the source components tangential to the cortical
+  surface are reduced by a factor defined by the ``--loose`` option.
+
+- A *variable loose orientation constraint* (vLOC) can be employed by
+  specifying ``fixed=False`` and ``loose`` parameters when calling
+  :func:`mne.minimum_norm.make_inverse_operator` (see
+  :ref:`plot_dipole_orientations_vLOC_orientations`). This
+  is similar to *fLOC* except that the value given with the ``loose``
+  parameter will be multiplied by :math:`\sigma_d`, defined above.
+
+Depth weighting
+~~~~~~~~~~~~~~~
+
+The minimum-norm estimates have a bias towards superficial currents. This
+tendency can be alleviated by adjusting the source covariance matrix :math:`R`
+to favor deeper source locations. In the depth weighting scheme employed in MNE
+analyze, the elements of :math:`R` corresponding to the :math:`p` th source
+location are be scaled by a factor
+
+.. math::    f_p = (g_{1p}^\top g_{1p} + g_{2p}^\top g_{2p} + g_{3p}^\top g_{3p})^{-\gamma}\ ,
+
+where :math:`g_{1p}`, :math:`g_{2p}`, and :math:`g_{3p}` are the three columns
+of :math:`G` corresponding to source location :math:`p` and :math:`\gamma` is
+the order of the depth weighting, which is specified via the ``depth`` option
+in :func:`mne.minimum_norm.make_inverse_operator`.
+
+Effective number of averages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is often the case that the epoch to be analyzed is a linear combination over
+conditions rather than one of the original averages computed. As stated above,
+the noise-covariance matrix computed is originally one corresponding to raw
+data. Therefore, it has to be scaled correctly to correspond to the actual or
+effective number of epochs in the condition to be analyzed. In general, we have
+
+.. math::    C = C_0 / L_{eff}
+
+where :math:`L_{eff}` is the effective number of averages. To calculate
+:math:`L_{eff}` for an arbitrary linear combination of conditions
+
+.. math::    y(t) = \sum_{i = 1}^n {w_i x_i(t)}
+
+we make use of the the fact that the noise-covariance matrix
+
+.. math::    C_y = \sum_{i = 1}^n {w_i^2 C_{x_i}} = C_0 \sum_{i = 1}^n {w_i^2 / L_i}
+
+which leads to
+
+.. math::    1 / L_{eff} = \sum_{i = 1}^n {w_i^2 / L_i}
+
+An important special case  of the above is a weighted average, where
+
+.. math::    w_i = L_i / \sum_{i = 1}^n {L_i}
+
+and, therefore
+
+.. math::    L_{eff} = \sum_{i = 1}^n {L_i}
+
+Instead of a weighted average, one often computes a weighted sum, a simplest
+case being a difference or sum of two categories. For a difference :math:`w_1 =
+1` and :math:`w_2 = -1` and thus
+
+.. math::    1 / L_{eff} = 1 / L_1 + 1 / L_2
+
+or
+
+.. math::    L_{eff} = \frac{L_1 L_2}{L_1 + L_2}
+
+Interestingly, the same holds for a sum, where :math:`w_1 = w_2 = 1`.
+Generalizing, for any combination of sums and differences, where :math:`w_i =
+1` or :math:`w_i = -1`, :math:`i = 1 \dotso n`, we have
+
+.. math::    1 / L_{eff} = \sum_{i = 1}^n {1/{L_i}}
+
+.. target for :end-before: inverse-end-content

mne-python/source/doc/_includes/memory.rst

@@ -0,0 +1,68 @@
+:orphan:
+
+Memory-efficient I/O
+====================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`memory` to link to that section of the implementation.rst
+   page. The next line is a target for :start-after: so we can omit the title
+   from the include:
+   memory-begin-content
+
+
+Preloading continuous (raw) data
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+MNE-Python can read data on-demand using the ``preload`` option provided in
+raw reading functions. For example::
+
+    from mne import io
+    from mne.datasets import sample
+    data_path = sample.data_path()
+    raw_fname = data_path / 'MEG' / 'sample' / 'sample_audvis_filt-0-40_raw.fif'
+    raw = io.read_raw_fif(raw_fname, preload=False)
+
+.. note:: Filtering, resampling and dropping or selecting channels does not
+          work with ``preload=False``.
+
+
+Preloading epoched data
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Similarly, epochs can also be be read from disk on-demand. For example::
+
+    import mne
+    events = mne.find_events(raw)
+    event_id, tmin, tmax = 1, -0.2, 0.5
+    picks = mne.pick_types(raw.info, meg=True, eeg=True, stim=False, eog=True)
+    epochs = mne.Epochs(raw, events, event_id, tmin, tmax, picks=picks,
+                        baseline=(None, 0), reject=dict(eeg=80e-6, eog=150e-6),
+                        preload=False)
+
+When ``preload=False``, the epochs data is loaded from the disk on-demand. Note
+that ``preload=False`` for epochs will work even if the ``raw`` object has been
+loaded with ``preload=True``. Preloading is also supported for
+:func:`mne.read_epochs`.
+
+.. warning:: This comes with a caveat. When ``preload=False``, data rejection
+             based on peak-to-peak thresholds is executed when the data is
+             loaded from disk, *not* when the ``Epochs`` object is created.
+
+To explicitly reject artifacts with ``preload=False``, use the function :func:`mne.Epochs.drop_bad`.
+
+
+Loading data explicitly
+~~~~~~~~~~~~~~~~~~~~~~~
+
+To load the data if ``preload=False`` was initially selected, use the functions :func:`mne.io.Raw.load_data` and :func:`mne.Epochs.load_data`.
+
+
+Accessing data as NumPy arrays
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you just want your raw data as a :class:`Numpy array <numpy.ndarray>` to
+work with it in a different framework you can use slicing syntax::
+
+    first_channel_data, times = raw[0, :]
+    channels_3_and_4, times = raw[3:5, :]

mne-python/source/doc/_includes/morph.rst

@@ -0,0 +1,123 @@
+:orphan:
+
+Morphing and averaging source estimates
+=======================================
+
+The spherical morphing of BEM surfaces accomplished by FreeSurfer can be
+employed to bring data from different subjects into a common anatomical frame.
+This page describes utilities which make use of the spherical :term:`morphing`
+procedure. :func:`mne.morph_labels` morphs label files between subjects
+allowing the definition of labels in a one brain and transforming them to
+anatomically analogous labels in another. :meth:`mne.SourceMorph.apply` offers
+the capability to transform all subject data to the same space and,
+e.g., compute averages of data across subjects.
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`ch_morph` to link to that section of the implementation.rst page.
+   The next line is a target for :start-after: so we can omit the title from
+   the include:
+   morph-begin-content
+
+
+Why morphing?
+~~~~~~~~~~~~~
+
+.. note:: Morphing examples in MNE-Python
+    :class: sidebar
+
+    Examples of morphing in MNE-Python include :ref:`this tutorial
+    <tut-mne-fixed-free>` on surface source estimation or these examples on
+    :ref:`surface <ex-morph-surface>` and :ref:`volumetric <ex-morph-volume>`
+    source estimation.
+
+Modern neuroimaging techniques, such as source reconstruction or fMRI analyses,
+make use of advanced mathematical models and hardware to map brain activity
+patterns into a subject-specific anatomical brain space. This enables the study
+of spatio-temporal brain activity. The representation of spatio-temporal brain
+data is often mapped onto the anatomical brain structure to relate functional
+and anatomical maps. Thereby activity patterns are overlaid with anatomical
+locations that supposedly produced the activity. Anatomical MR images are often
+used as such or are transformed into an inflated surface representations to
+serve as  "canvas" for the visualization.
+
+In order to compute group-level statistics, data representations across
+subjects must be morphed to a common frame, such that anatomically and
+functional similar structures are represented at the same spatial location for
+*all subjects equally*. Since brains vary, :term:`morphing` comes into play to
+tell us how the data produced by subject A would be represented on the brain of
+subject B (and vice-versa).
+
+
+The morphing maps
+~~~~~~~~~~~~~~~~~
+
+The MNE software accomplishes morphing with help of morphing maps.
+The morphing is performed with help of the registered
+spherical surfaces (``lh.sphere.reg`` and ``rh.sphere.reg`` ) which must be
+produced in FreeSurfer. A morphing map is a linear mapping from cortical
+surface values in subject A (:math:`x^{(A)}`) to those in another subject B
+(:math:`x^{(B)}`)
+
+.. math::    x^{(B)} = M^{(AB)} x^{(A)}\ ,
+
+where :math:`M^{(AB)}` is a sparse matrix with at most three nonzero elements
+on each row. These elements are determined as follows. First, using the aligned
+spherical surfaces, for each vertex :math:`x_j^{(B)}`, find the triangle
+:math:`T_j^{(A)}` on the spherical surface of subject A which contains the
+location :math:`x_j^{(B)}`. Next, find the numbers of the vertices of this
+triangle and set the corresponding elements on the *j* th row of
+:math:`M^{(AB)}` so that :math:`x_j^{(B)}` will be a linear interpolation
+between the triangle vertex values reflecting the location :math:`x_j^{(B)}`
+within the triangle :math:`T_j^{(A)}`.
+
+It follows from the above definition that in general
+
+.. math::    M^{(AB)} \neq (M^{(BA)})^{-1}\ ,
+
+*i.e.*,
+
+.. math::    x_{(A)} \neq M^{(BA)} M^{(AB)} x^{(A)}\ ,
+
+even if
+
+.. math::    x^{(A)} \approx M^{(BA)} M^{(AB)} x^{(A)}\ ,
+
+*i.e.*, the mapping is *almost* a bijection.
+
+
+About smoothing
+~~~~~~~~~~~~~~~
+
+The current estimates are normally defined only in a decimated grid which is a
+sparse subset of the vertices in the triangular tessellation of the cortical
+surface. Therefore, any sparse set of values is distributed to neighboring
+vertices to make the visualized results easily understandable. This procedure
+has been traditionally called smoothing but a more appropriate name might be
+smudging or blurring in accordance with similar operations in image processing
+programs.
+
+In MNE software terms, smoothing of the vertex data is an iterative procedure,
+which produces a blurred image :math:`x^{(N)}` from the original sparse image
+:math:`x^{(0)}` by applying in each iteration step a sparse blurring matrix:
+
+.. math::    x^{(p)} = S^{(p)} x^{(p - 1)}\ .
+
+On each row :math:`j` of the matrix :math:`S^{(p)}` there are :math:`N_j^{(p -
+1)}` nonzero entries whose values equal :math:`1/N_j^{(p - 1)}`. Here
+:math:`N_j^{(p - 1)}` is the number of immediate neighbors of vertex :math:`j`
+which had non-zero values at iteration step :math:`p - 1`. Matrix
+:math:`S^{(p)}` thus assigns the average of the non-zero neighbors as the new
+value for vertex :math:`j`. One important feature of this procedure is that it
+tends to preserve the amplitudes while blurring the surface image.
+
+Once the indices non-zero vertices in :math:`x^{(0)}` and the topology of the
+triangulation are fixed the matrices :math:`S^{(p)}` are fixed and independent
+of the data. Therefore, it would be in principle possible to construct a
+composite blurring matrix
+
+.. math::    S^{(N)} = \prod_{p = 1}^N {S^{(p)}}\ .
+
+However, it turns out to be computationally more effective to do blurring with
+an iteration. The above formula for :math:`S^{(N)}` also shows that the
+smudging (smoothing) operation is linear.

mne-python/source/doc/_includes/precision.rst

@@ -0,0 +1,28 @@
+:orphan:
+
+Floating-point precision
+========================
+
+.. NOTE: part of this file is included in doc/manual/io.rst and
+   doc/overview/implementation.rst. Changes here are reflected there. If you
+   want to link to this content, link to :ref:`manual-precision` for the manual
+   or :ref:`precision` for the implementation page. The next line is a target
+   for :start-after: so we can omit the title above:
+   precision-begin-content
+
+MNE-Python performs all computation in memory using the double-precision 64-bit
+floating point format. This means that the data is typecast into float64 format
+as soon as it is read into memory. The reason for this is that operations such
+as filtering and preprocessing are more accurate when using the 64-bit format.
+However, for backward compatibility, MNE-Python writes :file:`.fif` files in a
+32-bit format by default. This reduces file size when saving data to disk, but
+beware that *saving intermediate results to disk and re-loading them from disk
+later may lead to loss in precision*. If you would like to ensure 64-bit
+precision, there are two possibilities:
+
+- Chain the operations in memory and avoid saving intermediate results.
+
+- Save intermediate results but change the :class:`~numpy.dtype` used for
+  saving, by using the ``fmt`` parameter of :meth:`mne.io.Raw.save` (or
+  :meth:`mne.Epochs.save`, etc). However, note that this may render the
+  :file:`.fif` files unreadable in software packages other than MNE-Python.

mne-python/source/doc/_includes/ssp.rst

@@ -0,0 +1,119 @@
+:orphan:
+
+The Signal-Space Projection (SSP) method
+========================================
+
+.. NOTE: part of this file is included in doc/overview/implementation.rst.
+   Changes here are reflected there. If you want to link to this content, link
+   to :ref:`ssp-method` to link to that section of the implementation.rst
+   page. The next line is a target for :start-after: so we can omit the title
+   from the include:
+   ssp-begin-content
+
+The Signal-Space Projection (SSP) is one approach to rejection of external
+disturbances in software. The section presents some relevant details of this
+method. For practical examples of how to use SSP for artifact rejection, see
+:ref:`tut-artifact-ssp`.
+
+General concepts
+~~~~~~~~~~~~~~~~
+
+Unlike many other noise-cancellation approaches, SSP does not require
+additional reference sensors to record the disturbance fields. Instead, SSP
+relies on the fact that the magnetic field distributions generated by the
+sources in the brain have spatial distributions sufficiently different from
+those generated by external noise sources. Furthermore, it is implicitly
+assumed that the linear space spanned by the significant external noise patterns
+has a low dimension.
+
+Without loss of generality we can always decompose any :math:`n`-channel
+measurement :math:`b(t)` into its signal and noise components as
+
+.. math::    b(t) = b_s(t) + b_n(t)
+   :name: additive_model
+
+Further, if we know that :math:`b_n(t)` is well characterized by a few field
+patterns :math:`b_1 \dotso b_m`, we can express the disturbance as
+
+.. math::    b_n(t) = Uc_n(t) + e(t)\ ,
+   :name: pca
+
+where the columns of :math:`U` constitute an orthonormal basis for :math:`b_1
+\dotso b_m`, :math:`c_n(t)` is an :math:`m`-component column vector, and the
+error term :math:`e(t)` is small and does not exhibit any consistent spatial
+distributions over time, *i.e.*, :math:`C_e = E \{e e^\top\} = I`. Subsequently,
+we will call the column space of :math:`U` the noise subspace. The basic idea
+of SSP is that we can actually find a small basis set :math:`b_1 \dotso b_m`
+such that the conditions described above are satisfied. We can now construct
+the orthogonal complement operator
+
+.. math::    P_{\perp} = I - UU^\top
+   :name: projector
+
+and apply it to :math:`b(t)` in Equation :eq:`additive_model` yielding
+
+.. math::    b_{s}(t) \approx P_{\perp}b(t)\ ,
+   :name: result
+
+since :math:`P_{\perp}b_n(t) = P_{\perp}(Uc_n(t) + e(t)) \approx 0` and
+:math:`P_{\perp}b_{s}(t) \approx b_{s}(t)`. The projection operator
+:math:`P_{\perp}` is called the **signal-space projection operator** and
+generally provides considerable rejection of noise, suppressing external
+disturbances by a factor of 10 or more. The effectiveness of SSP depends on two
+factors:
+
+- The basis set :math:`b_1 \dotso b_m` should be able to characterize the
+  disturbance field patterns completely and
+
+- The angles between the noise subspace space spanned by :math:`b_1 \dotso b_m`
+  and the signal vectors :math:`b_s(t)` should be as close to :math:`\pi / 2`
+  as possible.
+
+If the first requirement is not satisfied, some noise will leak through because
+:math:`P_{\perp}b_n(t) \neq 0`. If the any of the brain signal vectors
+:math:`b_s(t)` is close to the noise subspace not only the noise but also the
+signal will be attenuated by the application of :math:`P_{\perp}` and,
+consequently, there might by little gain in signal-to-noise ratio.
+
+Since the signal-space projection modifies the signal vectors originating in
+the brain, it is necessary to apply the projection to the forward solution in
+the course of inverse computations.
+
+For more information on SSP, please consult the references listed in
+:footcite:t:`TescheEtAl1995,UusitaloIlmoniemi1997`.
+
+Estimation of the noise subspace
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As described above, application of SSP requires the estimation of the signal
+vectors :math:`b_1 \dotso b_m` constituting the noise subspace. The most common
+approach, also implemented in :func:`mne.compute_proj_raw`
+is to compute a covariance matrix
+of empty room data, compute its eigenvalue decomposition, and employ the
+eigenvectors corresponding to the highest eigenvalues as basis for the noise
+subspace. It is also customary to use a separate set of vectors for
+magnetometers and gradiometers in the Vectorview system.
+
+EEG average electrode reference
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The EEG average reference is the mean signal over all the sensors. It is
+typical in EEG analysis to subtract the average reference from all the sensor
+signals :math:`b^{1}(t), ..., b^{n}(t)`. That is:
+
+.. math:: {b}^{j}_{s}(t) = b^{j}(t) - \frac{1}{n}\sum_{k}{b^k(t)}
+   :name: eeg_proj
+
+where the noise term :math:`b_{n}^{j}(t)` is given by
+
+.. math:: b_{n}^{j}(t) = \frac{1}{n}\sum_{k}{b^k(t)}
+   :name: noise_term
+
+Thus, the projector vector :math:`P_{\perp}` will be given by
+:math:`P_{\perp}=\frac{1}{n}[1, 1, ..., 1]`
+
+.. warning::
+   When applying SSP, the signal of interest can also be sometimes removed.
+   Therefore, it's always a good idea to check how much the effect of interest
+   is reduced by applying SSP. SSP might remove *both* the artifact and signal
+   of interest.

mne-python/source/doc/_includes/units.rst

@@ -0,0 +1,36 @@
+:orphan:
+
+Internal representation (units)
+===============================
+
+.. NOTE: part of this file is included in doc/manual/io.rst and
+   doc/overview/implementation.rst. Changes here are reflected there. If you
+   want to link to this content, link to :ref:`manual-units` for the manual or
+   :ref:`units` for the implementation page. The next line is a target for
+   :start-after: so we can omit what's above:
+   units-begin-content
+
+Irrespective of the units used in your manufacturer's format, when importing
+data, MNE-Python will always convert measurements to the same standard units.
+Thus the in-memory representation of data are always in:
+
+- Volts (eeg, eog, seeg, emg, ecg, bio, ecog, dbs)
+- Teslas (magnetometers)
+- Teslas/meter (gradiometers)
+- Amperes*meter (dipole fits, minimum-norm estimates, etc.)
+- Moles/liter ("molar"; fNIRS data: oxyhemoglobin (hbo), deoxyhemoglobin (hbr))
+- Arbitrary units (various derived unitless quantities)
+
+.. NOTE: this is a target for :end-before: units-end-of-list
+
+Note, however, that most MNE-Python plotting functions will scale the data when
+plotted to yield nice-looking axis annotations in a sensible range; for
+example, :meth:`mne.io.Raw.plot_psd` will convert teslas to femtoteslas (fT)
+and volts to microvolts (µV) when plotting MEG and EEG data.
+
+The units used in internal data representation are particularly important to
+remember when extracting data from MNE-Python objects and manipulating it
+outside MNE-Python (e.g., when using methods like :meth:`~mne.io.Raw.get_data`
+or :meth:`~mne.Epochs.to_data_frame` to convert data to :class:`NumPy arrays
+<numpy.ndarray>` or :class:`Pandas DataFrames <pandas.DataFrame>` for analysis
+or plotting with other Python modules).