mne-tools · larsoner · Jun 23, 2026 · Jun 22, 2026 · Jun 22, 2026 · Jun 23, 2026
@@ -21,14 +21,17 @@ _check_skip: &check_skip
       circleci-agent step halt;
     fi
 
+_machine_image: &machine_image
+  image: ubuntu-2604:2026.05.1
+
 jobs:
   build_docs:
     parameters:
       scheduled:
         type: string
         default: "false"
     machine:
-      image: ubuntu-2404:current
+      <<: *machine_image
     # large 4 vCPUs 15GB mem
     # https://discuss.circleci.com/t/changes-to-remote-docker-reporting-pricing/47759
     resource_class: large
@@ -110,7 +113,7 @@ jobs:
       # Load pip cache
       - restore_cache:
           keys:
-            - pip-cache-0
+            - pip-cache-1
       - restore_cache:
           keys:
             - user-install-bin-cache-310
@@ -122,7 +125,7 @@ jobs:
             ./tools/circleci_dependencies.sh
 
       - save_cache:
-          key: pip-cache-0
+          key: pip-cache-1
           paths:
             - ~/.cache/pip
       - save_cache:
@@ -419,7 +422,7 @@ jobs:
         type: string
         default: "false"
     machine:
-      image: ubuntu-2404:current
+      <<: *machine_image
     resource_class: large
     steps:
       - restore_cache:
@@ -439,7 +442,7 @@ jobs:
           command: ./tools/circleci_bash_env.sh
       - restore_cache:
           keys:
-            - pip-cache-0
+            - pip-cache-1
       - run:
           name: Get Python running
           command: |
@@ -460,7 +463,7 @@ jobs:
 
   deploy:
     machine:
-      image: ubuntu-2404:current
+      <<: *machine_image
     steps:
       - attach_workspace:
           at: /tmp/build

@@ -16,8 +16,6 @@ jobs:
         with:
           persist-credentials: false
       - uses: actions/setup-python@v6
-        with:
-          python-version: '3.12'
       - run: pip install --upgrade towncrier pygithub gitpython numpy
       - run: python ./.github/actions/rename_towncrier/rename_towncrier.py
       - run: python ./tools/dev/ensure_headers.py

@@ -21,8 +21,6 @@ jobs:
         with:
           persist-credentials: true
       - uses: actions/setup-python@v6
-        with:
-          python-version: '3.12'
       - run: pip install pygithub -e .
       - run: python tools/dev/update_credit_json.py
       - run: git add -f doc/sphinxext/prs/*.json

@@ -19,13 +19,11 @@ jobs:
       - uses: actions/checkout@v6.0.3
         with:
           persist-credentials: false
+          fetch-depth: 0
       - uses: actions/setup-python@v6
-        with:
-          python-version: '3.10'
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install build twine
+          python -m pip install --upgrade pip packaging build twine
       - run: python -m build --sdist --wheel
       - run: twine check --strict dist/*
       - uses: actions/upload-artifact@v7

@@ -45,7 +45,7 @@ jobs:
         with:
           version: ">=0.9"
           activate-environment: true
-          python-version: 3.12
+          python-version: "3.12"
       - name: Install dependencies
         run: uv pip install -e . packaging requests tomlkit
       - name: Update tracked dependencies

@@ -401,27 +401,27 @@ p.centered a img.instlogo {
 }
 
 /* ************************************************************ funders page */
-ul.current li {
+ul.currentsponsor li {
     margin-left: calc(var(--mne-sponsor-logo-lg) + 0.5rem);
     text-indent: calc(-1 * var(--mne-sponsor-logo-lg) - 0.5rem);
     padding-bottom: 0.75rem;
 }
-ul.former li {
+ul.formersponsor li {
     margin-left: calc(var(--mne-sponsor-logo-sm) + 1rem);
     text-indent: calc(-1 * var(--mne-sponsor-logo-sm) - 1rem);
     padding-bottom: 0.5rem;
 }
-ul.current li img,
-ul.former li img {
+ul.currentsponsor li img,
+ul.formersponsor li img {
     background-color: unset !important;
     box-sizing: content-box;
     object-fit: contain;
 }
-ul.current li img {
+ul.currentsponsor li img {
     max-height: calc(0.4 * var(--mne-sponsor-logo-lg));
     width: var(--mne-sponsor-logo-lg);
 }
-ul.former li img {
+ul.formersponsor li img {
     max-height: calc(0.5 * var(--mne-sponsor-logo-sm));
     width: var(--mne-sponsor-logo-sm);
 }

@@ -23,15 +23,15 @@
     <!-- current funders -->
     {% for item in current_sponsors -%}
       <div class="card my-1 mx-2 {{ item.klass }}">
-        <a href="{{ pathto('credit/funding.html', 1) }}">
+        <a href="{{ pathto('credits/sponsors.html', 1) }}">
             <img class="card-img" src="{{ pathto('_static/funding/' + item.img, 1) }}" title="{{ item.title }}" alt="{{ item.title }}">
         </a>
       </div>
     {% endfor %}
     <!-- current partner institutions -->
     {% for inst in current_institutions -%}
       <div class="card my-1 mx-2 {{ inst.klass }}">
-        <a href="{{ pathto('credit/funding.html#supporting-institutions', 1) }}">
+        <a href="{{ pathto('credits/sponsors.html#supporting-institutions', 1) }}">
           <img class="card-img" src="{{ pathto('_static/institution_logos/' + inst.img, 1) }}" title="{{ inst.name }}" alt="{{ inst.name }}"/>
         </a>
       </div>

@@ -50,7 +50,7 @@
 .. _btkcodedev: https://github.com/btkcodedev
 .. _buildqa: https://github.com/buildqa
 .. _Carina Forster: https://github.com/CarinaFo
-.. _Carlos de la Torre-Ortiz: https://ctorre.me
+.. _Carlos de la Torre-Ortiz: https://github.com/c-torre
 .. _Cathy Nangini: https://github.com/KatiRG
 .. _Chetan Gohil: https://github.com/cgohil8
 .. _Chris Bailey: https://github.com/cjayb
@@ -239,7 +239,7 @@
 .. _Mohammad Daneshzand: https://github.com/mdaneshzand
 .. _Mojackhak: https://github.com/Mojackhak
 .. _Moritz Gerster: https://github.com/moritz-gerster
-.. _Motofumi Fushimi: https://github.com/motofumi-fushimi/motofumi-fushimi.github.io
+.. _Motofumi Fushimi: https://github.com/motofumi-fushimi
 .. _Nabil Alibou: https://github.com/nabilalibou
 .. _Natalie Klein: https://github.com/natalieklein
 .. _Nathalie Gayraud: https://github.com/ngayraud

@@ -657,6 +657,7 @@ def fix_sklearn_inherited_docstrings(app, what, name, obj, options, lines):
     "https://doi.org/10.1126/",  # www.science.org
     "https://doi.org/10.1137/",  # epubs.siam.org
     "https://doi.org/10.1145/",  # dl.acm.org
+    "https://doi.org/10.5281/",  # zenodo.org
     "https://doi.org/10.1155/",  # www.hindawi.com/journals/cin
     "https://doi.org/10.1161/",  # www.ahajournals.org
     "https://doi.org/10.1162/",  # direct.mit.edu/neco/article/
@@ -667,6 +668,8 @@ def fix_sklearn_inherited_docstrings(app, what, name, obj, options, lines):
     "https://doi.org/10.3390/",  # mdpi.com
     "https://hms.harvard.edu/",  # doc/funding.rst
     "https://stackoverflow.com/questions/21752259/python-why-pickle",  # doc/help/faq
+    "https://mitpress.mit.edu/9780262525855",  # works but linkcheck fails to resolve
+    "https://zenodo.org",  # doc/help/faq
     "https://blender.org",
     "https://home.alexk101.dev",
     "https://www.mq.edu.au/",
@@ -711,8 +714,12 @@ def fix_sklearn_inherited_docstrings(app, what, name, obj, options, lines):
     "https://psychophysiology.cpmc.columbia.edu",
     "https://erc.easme-web.eu",
     "https://www.crnl.fr",
+    # Spurious failure
+    "https://megcore.nih.gov/index.php/Staff",
     # Not rendered by linkcheck builder
     r"ides\.html",
+    # Sponsors not rendered properly by linkcheck builder
+    "{{inst.url}}",
 ]
 linkcheck_anchors = False  # saves a bit of time
 linkcheck_timeout = 15  # some can be quite slow

@@ -7,7 +7,7 @@ Sponsors
 
 Maintenance and development of MNE-Python is currently supported by the following funding agencies and partners:
 
-.. rst-class:: list-unstyled current
+.. rst-class:: list-unstyled currentsponsor
 
 - |nih| **National Institutes of Health:**
   `R01-NS104585 <https://reporter.nih.gov/project-details/10175064>`_
@@ -18,7 +18,7 @@ Maintenance and development of MNE-Python is currently supported by the followin
 Past sponsors
 -------------
 
-.. rst-class:: list-unstyled former
+.. rst-class:: list-unstyled formersponsor
 
 - |nih| National Institutes of Health:
   `R01-EB009048 <https://reporter.nih.gov/project-details/9053482>`_,
@@ -56,7 +56,7 @@ Supporting institutions
 
 Some institutions support their employees’ contributions to MNE-Python as part of normal work duties. Current supporting institutions include:
 
-.. rst-class:: list-unstyled current
+.. rst-class:: list-unstyled currentsponsor
 
 {% for inst in current_institutions %}
 {% if not inst.name.endswith("_dk") %}

@@ -273,7 +273,7 @@ Time-frequency visualization
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 We implemented a viewer for interactive visualization of volumetric
 source-time-frequency (5-D) maps on MRI slices (orthogonal 2D viewer).
-`NutmegTrip <https://github.com/fieldtrip/fieldtrip/tree/master/contrib/nutmegtrip>`__
+`NutmegTrip <https://github.com/fieldtrip/fieldtrip/tree/20260408/contrib/nutmegtrip>`__
 (written by Sarang Dalal) provides similar functionality in MATLAB in
 conjunction with FieldTrip. Example of NutmegTrip's source-time-frequency mode
 in action (click for link to YouTube):

@@ -20,7 +20,7 @@
 .. _`MNE-HCP`: http://mne.tools/mne-hcp
 .. _`MNE-Realtime`: https://mne.tools/mne-realtime
 .. _`MNE-LSL`: https://mne.tools/mne-lsl
-.. _`MNE-RT`: https://payamsash.github.io/mne-rt/
+.. _`MNE-RT`: https://mne-rt-org.github.io/mne-rt/
 .. _`MNE-gui-addons`: https://mne.tools/mne-gui-addons
 .. _`MNE-MATLAB`: https://github.com/mne-tools/mne-matlab
 .. _`MNE-Docker`: https://github.com/mne-tools/mne-docker

@@ -2375,7 +2375,7 @@ @book{Luck2014
   edition = {2nd},
   publisher = {The MIT Press},
   address = {Cambridge, MA},
-  url = {https://mitpress.mit.edu/books/introduction-event-related-potential-technique-second-edition},
+  url = {https://mitpress.mit.edu/9780262525855/an-introduction-to-the-event-related-potential-technique},
   isbn = {978-0-262-52585-5}
 }
 

@@ -4,6 +4,7 @@
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
 
+import functools
 import gc
 import os
 import time
@@ -17,9 +18,7 @@
 
 import mne
 from mne.utils import (
-    _assert_no_instances as _assert_no_instances_mne,
-)
-from mne.utils import (
+    _assert_no_instances,
     _get_extra_data_path,
     sizeof_fmt,
 )
@@ -123,14 +122,20 @@ def reset_warnings(gallery_conf, fname):
 t0 = time.time()
 
 
-def _assert_no_instances(cls, when):
+def _reraise_extension_error(func):
     """Wrap our internal one but make the traceback nicer when it fails."""
-    try:
-        _assert_no_instances_mne(cls, when)
-    except Exception as exc:
-        raise ExtensionError(str(exc)) from None
+
+    @functools.wraps(func)
+    def _wrapper(gallery_conf, fname, when):
+        try:
+            return func(gallery_conf, fname, when)
+        except Exception:
+            raise ExtensionError(f"{func.__name__} failed: {when=}, {fname=}")
+
+    return _wrapper
 
 
+@_reraise_extension_error
 def reset_modules(gallery_conf, fname, when):
     """Do the reset."""
     import matplotlib.pyplot as plt

@@ -82,8 +82,10 @@
 # start at a value greater than the darkest value in our previous heatmap, which will
 # make the darkest colors of the heatmap transparent.
 
-cmap.set_under("k", alpha=0)  # make the lowest values transparent
-ax = plt.subplot()
+cmap = cmap.with_extremes(
+    under=(0.0, 0.0, 0.0, 0.0)
+)  # make the lowest values transparent
+_, ax = plt.subplots(figsize=(6, 3.5), layout="constrained")
 ax.imshow(plt.imread(stim_fpath))
 plot_gaze(
     epochs["natural"],

@@ -18,6 +18,7 @@
 import re
 import weakref
 from dataclasses import dataclass
+from functools import partial
 
 from matplotlib.colors import Colormap
 
@@ -230,6 +231,22 @@ class ChannelsSelect(UIEvent):
     ch_names: list[str]
 
 
+def _delete_event_channel(event=None, *, weakfig):
+    """Delete the event channel (callback function)."""
+    fig = weakfig()
+    if fig is None:
+        return
+    publish(fig, event=FigureClosing())  # Notify subscribers of imminent close
+    logger.debug(f"unlink(({fig})")
+    unlink(fig)  # Remove channel from the _event_channel_links dict
+    if fig in _event_channels:
+        logger.debug(f"  del _event_channels[{fig}]")
+        del _event_channels[fig]
+    if fig in _disabled_event_channels:
+        logger.debug(f"  _disabled_event_channels.remove({fig})")
+        _disabled_event_channels.remove(fig)
+
+
 def _get_event_channel(fig):
     """Get the event channel associated with a figure.
 
@@ -263,30 +280,17 @@ def _get_event_channel(fig):
 
         # When the figure is closed, its associated event channel should be
         # deleted. This is a good time to set this up.
-        def delete_event_channel(event=None, *, weakfig=weakfig):
-            """Delete the event channel (callback function)."""
-            fig = weakfig()
-            if fig is None:
-                return
-            publish(fig, event=FigureClosing())  # Notify subscribers of imminent close
-            logger.debug(f"unlink(({fig})")
-            unlink(fig)  # Remove channel from the _event_channel_links dict
-            if fig in _event_channels:
-                logger.debug(f"  del _event_channels[{fig}]")
-                del _event_channels[fig]
-            if fig in _disabled_event_channels:
-                logger.debug(f"  _disabled_event_channels.remove({fig})")
-                _disabled_event_channels.remove(fig)
 
         # Hook up the above callback function to the close event of the figure
         # window. How this is done exactly depends on the various figure types
         # MNE-Python has.
         _validate_type(fig, (matplotlib.figure.Figure, Brain, EvokedField), "fig")
+        this_delete_event_channel = partial(_delete_event_channel, weakfig=weakfig)
         if isinstance(fig, matplotlib.figure.Figure):
-            fig.canvas.mpl_connect("close_event", delete_event_channel)
+            fig.canvas.mpl_connect("close_event", this_delete_event_channel)
         else:
             assert hasattr(fig, "_renderer")  # figures like Brain, EvokedField, etc.
-            fig._renderer._window_close_connect(delete_event_channel, after=False)
+            fig._renderer._window_close_connect(this_delete_event_channel, after=False)
 
     # Now the event channel exists for sure.
     return _event_channels[fig]
@@ -491,6 +495,5 @@ def _cleanup_agg():
         if isinstance(key, matplotlib.figure.Figure):
             for cb in key.canvas.callbacks.callbacks["close_event"].values():
                 cb = cb()  # get the true ref
-                # Our __name__ is "_get_event_channel.<locals>.delete_event_channel"
-                if cb is not None and cb.__name__.endswith("delete_event_channel"):
+                if isinstance(cb, partial) and cb.func is _delete_event_channel:
                     cb()