Merge branch 'main' into lite-docs-wiring

Author: natinew77-creator

.gitignore

@@ -110,4 +110,5 @@ doc/jupyterlite_contents/*
 !doc/jupyterlite_contents/.gitkeep
 doc/lite_extra/
 
-/.claude/
+/.claude/
+uv.lock

doc/api/datasets.rst

@@ -48,5 +48,6 @@ Datasets
    refmeg_noise.data_path
    ssvep.data_path
    erp_core.data_path
+   erp_core.fetch_file
    epilepsy_ecog.data_path
    eyelink.data_path

doc/changes/dev/13795.other.rst

@@ -0,0 +1 @@
+Made :meth:`evoked.plot() <mne.Evoked.plot>` instantiate ``MNELineFigure`` when it creates its own figure, aligning this path with the ongoing 2D plotting figure-class refactor discussed in :gh:`7751`, by `Pragnya Khandelwal`_.

doc/changes/dev/14211.newfeature.rst

@@ -0,0 +1,3 @@
+Added :ref:`tut-gal-decoding`, a tutorial on Generalization Across Location
+(GAL) and Time-GAL decoding of EEG data, by `Bruno Aristimunha`_ and
+:newcontrib:`Alejandro Santos Mayo`.

doc/changes/dev/14213.bugfix.rst

@@ -0,0 +1 @@
+Preserve caller-owned memory-mapped preload files after Raw objects are destroyed, by `Bruno Aristimunha`_.

doc/changes/names.inc

@@ -8,6 +8,7 @@
 .. _Akhilesh S. Yadav: https://github.com/YadavAkhileshh
 .. _Akshay: https://github.com/Akshay0724
 .. _Alan Leggitt: https://github.com/leggitta
+.. _Alejandro Santos Mayo: https://github.com/ASantosMayo
 .. _Alejandro Weinstein: http://ocam.cl
 .. _Alessandro Tonin: https://www.linkedin.com/in/alessandro-tonin-7892b046
 .. _Alex Ciok: https://github.com/alexCiok

mne/datasets/erp_core/__init__.py

@@ -4,4 +4,4 @@
 
 """ERP-CORE EEG dataset."""
 
-from .erp_core import data_path, get_version
+from .erp_core import data_path, fetch_file, get_version

mne/datasets/erp_core/erp_core.py

@@ -2,8 +2,30 @@
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
 
-from ...utils import verbose
-from ..utils import _data_path_doc, _download_mne_dataset, _get_version, _version_doc
+from pathlib import Path
+
+from ...utils import _check_option, logger, verbose
+from ..utils import (
+    _data_path_doc,
+    _download_mne_dataset,
+    _downloader_params,
+    _get_path,
+    _get_version,
+    _version_doc,
+)
+
+_N170_BASE_URL = "https://data.nemar.org/nm000132/v1.1.1/"
+_N170_REGISTRY = {
+    "sub-001/eeg/sub-001_task-N170_eeg.fdt": (
+        "sha256:08406f3c6b4a869dc8f67c9acc233a91993bae1b04b7dee5bc0521677ed8949b"
+    ),
+    "sub-001/eeg/sub-001_task-N170_eeg.set": (
+        "sha256:9c53dbdc3b469934a5eb6e9f01e59090dd47aeb495b8f21ceca03670991e5b11"
+    ),
+    "sub-001/eeg/sub-001_task-N170_events.tsv": (
+        "sha256:07c87e728d097b0deb05b17d77bbdbd22ef58105111b0b56e659a767b9421e34"
+    ),
+}
 
 
 @verbose
@@ -25,6 +47,37 @@ def data_path(
 )
 
 
+def fetch_file(fname, path=None):
+    """Fetch a raw ERP CORE file used by MNE-Python examples.
+
+    Parameters
+    ----------
+    fname : str
+        Relative path of the file within the ERP CORE dataset.
+    path : path-like | None
+        Parent directory for the ``ERP-CORE-N170`` folder. If ``None``, the
+        ``MNE_DATASETS_ERP_CORE_PATH`` configuration value is used.
+
+    Returns
+    -------
+    path : instance of Path
+        Local path to the requested file.
+    """
+    import pooch
+
+    _check_option("fname", fname, _N170_REGISTRY)
+    path = _get_path(path, "MNE_DATASETS_ERP_CORE_PATH", "ERP CORE")
+    fetcher = pooch.create(
+        path=path / "ERP-CORE-N170",
+        base_url=_N170_BASE_URL,
+        registry=_N170_REGISTRY,
+        retry_if_failed=2,
+    )
+    pooch.get_logger().setLevel(logger.getEffectiveLevel())
+    downloader = pooch.HTTPDownloader(**_downloader_params())
+    return Path(fetcher.fetch(fname, downloader=downloader, progressbar=True))
+
+
 def get_version():  # noqa: D103
     return _get_version("erp_core")
 

mne/datasets/tests/test_datasets.py

@@ -90,6 +90,29 @@ def noop(*args, **kwargs):
     assert sd / "fsaverage" == sd_2
 
 
+def test_erp_core_fetch_file(tmp_path, monkeypatch):
+    """Test fetching individual ERP CORE files."""
+    fnames = (
+        "sub-001/eeg/sub-001_task-N170_eeg.fdt",
+        "sub-001/eeg/sub-001_task-N170_eeg.set",
+        "sub-001/eeg/sub-001_task-N170_events.tsv",
+    )
+
+    def fetch(pooch_instance, fname, **kwargs):
+        assert fname in pooch_instance.registry
+        destination = pooch_instance.abspath / fname
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        destination.touch()
+        return str(destination)
+
+    monkeypatch.setattr(pooch.Pooch, "fetch", fetch)
+    for fname in fnames:
+        destination = datasets.erp_core.fetch_file(fname, path=tmp_path)
+        assert destination == tmp_path / "ERP-CORE-N170" / fname
+    with pytest.raises(ValueError, match="Invalid value for.*fname"):
+        datasets.erp_core.fetch_file("unknown", path=tmp_path)
+
+
 @requires_good_network
 def test_downloads(tmp_path, monkeypatch, capsys):
     """Test dataset URL and version handling."""

mne/datasets/utils.py

@@ -366,11 +366,17 @@ def _download_all_example_data(verbose=True):
         limo,
         sleep_physionet,
     )
+    from .erp_core import fetch_file as fetch_erp_core_file
 
     eegbci.load_data(subjects=1, runs=[6, 10, 14], update_path=True)
     eegbci.load_data(subjects=range(1, 5), runs=[3], update_path=True)
     logger.info("[done eegbci]")
 
+    fetch_erp_core_file("sub-001/eeg/sub-001_task-N170_eeg.fdt")
+    fetch_erp_core_file("sub-001/eeg/sub-001_task-N170_eeg.set")
+    fetch_erp_core_file("sub-001/eeg/sub-001_task-N170_events.tsv")
+    logger.info("[done erp_core N170]")
+
     sleep_physionet.age.fetch_data(subjects=[0, 1], recording=[1])
     logger.info("[done sleep_physionet]")